Notre avis
Cette méta-skill génère un guide de compétence (SKILL.md) pour une tâche récurrente en analysant le codebase et en posant des questions de cadrage.
Points forts
- Analyse le codebase pour extraire des exemples de code réels plutôt que des exemples génériques
- Structure la sortie en sections imposées (quand l'utiliser, étapes, anti-patterns, exemples, liens)
- Pose 2 à 3 questions de clarification via AskUserQuestion pour ancrer la skill dans les conventions du projet
- Prévoit une règle d'arrêt explicite après 3 tentatives infructueuses pour éviter les boucles infinies
Limites
- N'écrit que dans .claude/skills, donc la portée reste limitée à Claude Code
- Dépend fortement de la qualité de l'analyse du codebase et des réponses de l'utilisateur pour produire un contenu pertinent
- Aucune validation ni test du SKILL.md généré n'est décrit après sa création
À utiliser lorsqu'une tâche ou un pattern se répète dans le projet et mérite d'être documenté comme skill réutilisable.
À éviter pour documenter un one-shot ponctuel ou un sujet qui n'a aucun précédent dans le codebase à analyser.
Analyse de sécurité
SûrThe 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.
Aucun point d'attention détecté
Exemples
/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.
Generateur de Documentation API
Documentation
Genere automatiquement de la documentation API OpenAPI/Swagger.
Rédacteur Technique
Documentation
Rédige de la documentation technique claire selon les meilleurs style guides.
Synchronisation de la documentation avec les changements de code
Documentation
Synchroniser la documentation projet avec les derniers changements de code, refactorisations et fonctionnalités de la branche courante.