charlieviettq Writing skills
When to use
- Adding a skill under
.cursor/skills/<domain>/<name>/ - Fixing discovery issues (agent never invokes the skill)
- Splitting an oversized skill into SKILL.md + reference.md
When not to use
- One-off project instructions (use README or rules)
- Copying entire third-party skill trees without audit
Workflow
- Read
docs/skill-writing-guide.mdanddocs/review-rubric.md - Run
skill-supply-chain-auditif source is external - Draft frontmatter:
namematches folder; description includes Triggers: - Keep SKILL.md thin; move long examples to
reference.md - Pressure-test: list 3 user phrases that should trigger and 2 that should not
- Run
python3 scripts/validate-skills.py - Regenerate Claude skills if editing Cursor source
Description quality
- Good: concrete workflow + quoted trigger phrases
- Bad: broad "use for everything" or "MUST run before any action"
Checklist before PR
- Public-safe (no secrets, no auto-push scripts in skill body)
- No duplicate of existing skill in
SKILL_INVENTORY.md - Entry in
EXTERNAL_SKILLS.mdif adapted from upstream -
CHANGELOG.mdupdated under Unreleased
Related
skill-supply-chain-audit, reflect-yourself, core-workflow/planning-and-task-breakdown
Authoring practices inspired by obra/superpowers (MIT).