Our review
This meta-skill produces a skill guide (SKILL.md) for a recurring task by analyzing the codebase and asking scoping questions.
Strengths
- Searches the codebase to pull real code examples instead of generic snippets
- Enforces a fixed output structure (when to use, steps, anti-patterns, examples, related links)
- Asks 2-3 clarifying questions via AskUserQuestion to anchor the skill in project conventions
- Includes an explicit stop rule after 3 failed attempts to prevent endless loops
Limitations
- Writes only to .claude/skills, so its output is confined to Claude Code
- Quality depends heavily on the codebase analysis and the user's answers to produce relevant content
- No validation or testing of the generated SKILL.md is described after creation
Use it when a task or pattern keeps recurring in the project and deserves to be captured as a reusable skill.
Avoid it for documenting a one-off task or a topic with no existing precedent in the codebase to analyze.
Security analysis
SafeThe skill only creates a directory and writes a documentation template; the only shell command is a benign 'mkdir -p'. There are no destructive actions, network calls, or data exfiltration.
No concerns found
Examples
/add-skill error handlingAdd a skill that documents how we write database migrations in this repo, using real examples from the codebase./add-skillAdd Skill
Create and populate a new skill guide for recurring tasks.
Usage: /add-skill [name or topic]
Process
1. Get Skill Topic
If $ARGUMENTS is empty, use AskUserQuestion tool to ask:
- "What task or pattern should this skill document?"
2. Analyze Codebase
Search the codebase to find:
- Existing patterns related to this skill
- Code examples that demonstrate the pattern
- Common files/modules involved
3. Gather Context
Use AskUserQuestion tool to ask 2-3 clarifying questions:
- When should developers use this pattern?
- Are there any anti-patterns or common mistakes to avoid?
- Any project-specific conventions for this task?
4. Create Skill Structure
mkdir -p .claude/skills/[skill-slug]
5. Populate SKILL.md
Create .claude/skills/[skill-slug]/SKILL.md:
# Skill: [Name]
## When to Use
- [Situation 1 - based on analysis]
- [Situation 2]
- [Situation 3]
## Step by Step
### 1. [First Step]
[Explanation]
```[language]
# Code example from this codebase
[actual code found in the project]
2. [Second Step]
[Explanation]
[code example]
3. [Third Step]
[Explanation]
[code example]
Anti-Patterns
Don't:
- [Bad practice 1 - why it's bad]
- [Bad practice 2 - why it's bad]
Do:
- [Good practice 1]
- [Good practice 2]
Examples from This Codebase
[Example 1 Name]
Located at: [file path]
[relevant code snippet]
[Example 2 Name]
Located at: [file path]
[relevant code snippet]
Related
- [Link to related ADR if applicable]
- [Link to related skill if applicable]
## Output
Created: .claude/skills/[slug]/SKILL.md
Skill: [Name]
Steps documented: X Examples included: X from codebase Anti-patterns: X identified
## If You Get Stuck
If you cannot make progress after 3 attempts at the same step:
1. Stop immediately
2. Explain what you're trying to do and what's blocking you
3. **Use AskUserQuestion tool** to ask the user how to proceed
Never loop indefinitely. If you find yourself repeating the same actions without progress, stop and ask for help.
API Documentation Generator
Documentation
Automatically generates OpenAPI/Swagger API documentation.
Technical Writer
Documentation
Writes clear technical documentation following top style guides.
Branch Documentation Sync
Documentation
Synchronize project documentation with recent code changes, refactors, and feature implementations in the current branch.