Playbooks
Authoring or modifying a skill
Authoring or modifying a skill
You own the skill's voice.
- Use the create-skill skill (Cursor's built-in for authoring SKILL.md files).
- Validate the skill: frontmatter has
nameanddescription, referenced files exist, cross-skill links resolve. - Test cases if structural. Skip if subjective.
- Run Opening a PR.
When in doubt, delete. Keep only prose that changes a decision. Tell it to do the thing and skip the reason. Explain only when the rule is confusing without one. Match tone to scope. Point at structural sources (types, READMEs, config) per the encode-lessons-in-structure principle skill. Delegate to other skills by path. Don't restate. A workflow you keep hitting but isn't captured → propose a new skill.
Reply: summary of the skill, key design decisions, validation notes.