All skills
davila7 avatar

/crafting-effective-readmes

@1c194fd

Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.

Use this Skill: https://skilld.dev/gh/davila7/claude-code-templates/crafting-effective-readmes

This session only. Nothing lands on disk.

templatespersonal.md

≈270 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Personal Project README Template

Use this template for side projects, portfolio pieces, and experiments. Balance between documenting for future-you and showcasing for others.


[Project Name]

[One-line description]

[Screenshot or demo GIF if visual]

What This Does

[2-3 sentences explaining what it does and why you built it. Be specific about the problem it solves for you.]

Demo

[Link to live demo, video, or screenshots]

Tech Stack

  • [Category]: [Technology] - [brief why you chose it]
  • [Category]: [Technology]

Getting Started

[Clone and run commands]

How It Works

[Brief explanation of the interesting parts - architecture, algorithms, or techniques worth noting. This is useful for portfolio viewers and future-you.]

What I Learned

[Key takeaways from building this. Good for portfolios and personal reference.]

  • [Learning 1]
  • [Learning 2]

Future Ideas

  • [Thing you might add]
  • [Improvement you're considering]

License

[License if you want one, or just "Personal project" if not sharing]

Source: SKILL.md on GitHub

1 warning12d4 checks · Risk SAFE
  • Gen Agent Trust Hub12d

    The skill provides comprehensive templates and guidance for writing, updating, and reviewing project README files tailored to different project types (Open Source, Personal, Internal, Config). It is purely instructional and does not contain any malicious code, dangerous commands, or data exfiltration patterns.

  • Socket12d

    No alerts

  • Snyk12d

    Risk: LOW · No issues

  • Runlayer7mo

    14/14 files flagged

Signed by skilld at 1c194fd. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 14 hours ago.

Activeupdated 8 months ago

README badge

README badge for davila7/claude-code-templates/crafting-effective-readmes