WG
Writing Great Skills
🟢 Production-Ready🕐 updated 2026-07-14
🔷 SkillSpec L3
pm-engineering
Author a high-quality Agent Skill (SKILL.md) that an AI reliably triggers and executes well — strong frontmatter, a sharp description with trigger phrases, a clear output contract, quality checks, and anti-patterns. Use when asked to write a skill, create a SKILL.md, improve a skill, review a skill for quality, or contribute to a skills library. Produces a complete, SkillCheck-passing SKILL.md plus a short rationale for the key choices.
📚 Based on Anthropic Agent Skills authoring guidance + progressive disclosure
What to give it
▸What the skill should do — and the concrete artifact it produces
▸When it should trigger — the phrasings a user would actually type
▸The inputs — it needs from the user
▸framework or standard — Any it encodes (for attribution)
✅ The bar it holds itself to
Every skill in this library self-verifies — these are this skill's own quality checks, straight from its definition.
✓`name` is kebab-case and matches the intended folder
✓Description states what it does, has a "Use when …" trigger clause, and names what it **Produces**
✓Body has: value line, working-from-a-brief, inputs, a concrete Output Format template, Quality Checks, Anti-Patterns
✓No `TODO`/placeholder text left in
✓Triggers are distinct from neighbouring skills (won't mis-fire or get skipped)
✓Would pass `npm run skillcheck` with no errors
⚠️ What it refuses to do
A vague description with no trigger phrases — the skill never gets picked
An Output Format that *describes* the artifact instead of *templating* it
Quality Checks that aren't observable ("output should be good")
Leaving `<!-- TODO -->` or `[bracketed]` placeholders in the final file
Overlapping so heavily with an existing skill that the model can't choose between them
Install
npx pm-claude-skills add --agent claude # or codex · cursor · gemini · hermes
# or one-line MCP (every skill, any client):
claude mcp add pm-skills -- npx -y pm-claude-skills-mcpStart with
Related skills
🔌 Embed this skill
Drop this on your blog, docs, or site — it renders a "Run this skill" card:
<div data-pm-skill="writing-great-skills"></div>
<script src="https://mohitagw15856.github.io/pm-claude-skills/embed.js" async></script>💬 Discussion
Writing Great Skills is one of 750 open-source professional AI agent skills — all SkillSpec L3.
Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog