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.md

Put 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."