write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
npx skills add stevesolun/ctx --skill write-a-skill --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Writing Skills ## Process 1. **Gather requirements** - ask user about: - What task/domain does the skill cover? - What specific use cases should it handle? - Does it need executable scripts or just instructions? - Any reference materials to include? 2. **Draft the skill** - create: - SKILL.md with concise instructions - Additional reference files if content exceeds 500 lines - Utility scripts if deterministic operations needed 3. **Review with user** - present draft and ask: - Does this cover your use cases? - Anything missing or unclear? - Should any section be more/less detailed? ## Skill Structure ``` skill-name/ ├── SKILL.md # Main instructions (required) ├── REFERENCE.md # Detailed docs (if needed) ├── EXAMPLES.md # Usage examples (if needed) └── scripts/ # Utility scripts (if needed) └── helper.js ``` ## SKILL.md Template ```md --- name: skill-name description: Brief description of capability. Use when [specific triggers]. --- # Skill Name ## Quick start [Minimal working example] ## Workflows [Step-by-step processes with checklists for complex tasks] ## Advanced features [Link to separate files: See [REFERENCE.md](REFERENCE.md)] ``` ## Description Requirements The descripti
- Process
- Skill Structure
- SKILL.md Template
- Description Requirements
- When to Add Scripts
- When to Split Files
- Review Checklist
What does the write-a-skill skill do?
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
How do I install it?
Run `npx skills add stevesolun/ctx --skill write-a-skill --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From stevesolun/ctx, a repository with 569 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.