Skill Authoring

If you're building skills for Claude Code or MCP tools, this gives you the actual engineering practices that make them work reliably. It's 46 rules across metadata design, description engineering, and trigger optimization, the stuff that determines whether your skill activates when users need it or just sits there. The core insight is solid: descriptions drive activation, so you need specific capabilities and keywords upfront, not buried in implementation details. Progressive disclosure is broken down into a three-level system (overview, references, execution) that keeps token usage reasonable. Most valuable for the trigger optimization and testing sections, they're specific about covering synonyms and negative cases. Think of it as the missing manual for why some skills work and others don't.

Install to Claude Code

npx -y skills add pproenca/dot-skills --skill skill-authoring --agent claude-code