Agent-Skills.md

Agent Skills: writing-skills

Use when creating or updating SKILL.md documentation - Explains how and why to create a skill.

UncategorizedID: dave1010/tools/writing-skills

Repository

dave1010/tools
dave1010License: MIT
7

Install this agent skill to your local

pnpm dlx add-skill https://github.com/dave1010/tools/tree/HEAD/.agents/skills/writing-skills

Skill Files

Browse the full folder contents for writing-skills.

Download Skill

Loading file tree…

.agents/skills/writing-skills/SKILL.md

Skill Metadata

Name
writing-skills
Description
"Use when creating or updating SKILL.md documentation - Explains how and why to create a skill."

Skills are used for context that may be useful to a coding agent, without bloating LLM context when they are not relevant.

Skills are only worthwhile if the coding agent fails a task without the skill.

Skills live in /.agents/skills, with each skill having its own directory.

SKILL.md

Front matter

  • Match the name to the directory name exactly.
  • Write the description as "Use when <scenario> - <what it does>" in under 30 words and third person.
  • Quote the description if it includes punctuation that could break YAML.

Markdown body

  • Write concise instructions for the skill topic.
  • Keep headings and bullet lists structured so readers can scan quickly.

Additional files

Other files, like scripts or data, may live in the directory and be referenced by the skill.

AGENTS.md

A GitHub Action automatically regenerates the skills list in AGENTS.md.