Step 3 of 5
Write Your First Skill
Author a minimal skill from scratch.
Let us build a tiny but real skill: one that turns a rough changelog note into a clean, user-facing release line. Create the folder and file inside your project's skills directory.
.claude/skills/release-line/SKILL.mdPut this inside it:
---
name: release-line
description: Use when turning a rough internal changelog note into a polished, user-facing release-notes line.
---
# Release line
Given a rough note, produce ONE sentence a non-technical user understands:
- Lead with the benefit, not the mechanism.
- No internal ticket IDs, no file names, no jargon.
- Present tense, active voice, under 120 characters.
Example:
rough: "patched race in submitLead() that dropped every 3rd form post"
line: "Contact-form submissions are now reliably delivered."