A first SKILL.md
Skeleton of a project skill. Claude reads the description to decide on its own when to use the skill, so say clearly what it does and which requests should trigger it. You can also run it yourself with /skill-name.
Tested with Claude Code 2.1.329
Spots to fill
{{skill_name}}Skill name in lowercase with hyphens; also the folder namee.g.write-release-notes{{what_it_does}}One sentence on what the skill doese.g.Drafts release notes from the commits since the last tag{{when_to_use}}Requests that should trigger the skille.g.the user asks for release notes, a changelog entry or what changed since the last version
.claude/skills/{{skill_name}}/SKILL.md
---
name: {{skill_name}}
description: {{what_it_does}}. Use when {{when_to_use}}.
---
# {{skill_name}}
## Steps
1. Find the last release tag: `git describe --tags --abbrev=0`.
2. List the commits since then: `git log <tag>..HEAD --oneline`.
3. Group them under Added, Changed and Fixed. Skip merge commits and chores.
4. Write one line per change, in plain words a user would understand.
## Output
A Markdown list under a `## <next version>` heading. Ask for the version number if it is
not obvious from the tags.
## Rules
- Never invent a change that is not in the commit list.
- Mention breaking changes first, marked **Breaking**.
.claude/skills/write-release-notes/SKILL.md
---
name: write-release-notes
description: Drafts release notes from the commits since the last tag. Use when the user asks for release notes, a changelog entry or what changed since the last version.
---
# write-release-notes
## Steps
1. Find the last release tag: `git describe --tags --abbrev=0`.
2. List the commits since then: `git log <tag>..HEAD --oneline`.
3. Group them under Added, Changed and Fixed. Skip merge commits and chores.
4. Write one line per change, in plain words a user would understand.
## Output
A Markdown list under a `## <next version>` heading. Ask for the version number if it is
not obvious from the tags.
## Rules
- Never invent a change that is not in the commit list.
- Mention breaking changes first, marked **Breaking**.