Notre avis
Génère un guide de compétence (SKILL.md) pour une tâche récurrente en analysant le code existant et en posant des questions de clarification à l'utilisateur.
Points forts
- Pose des questions de clarification via AskUserQuestion avant de rédiger, au lieu d'inventer le contenu
- Ancre la documentation dans le code réel du projet en citant des extraits et leurs chemins de fichiers
- Produit une structure cohérente : quand l'utiliser, étapes numérotées, anti-patterns, exemples, liens associés
- Prévoit un garde-fou explicite : s'arrêter et demander de l'aide après 3 tentatives infructueuses
Limites
- Écrit uniquement dans .claude/skills/ et s'appuie sur l'outil AskUserQuestion, donc spécifique à Claude Code
- Ne décrit aucune étape de validation ou de test de la compétence générée
- Ne précise pas comment gérer une compétence existante (écrasement, mise à jour, versionnage)
À utiliser lorsqu'un motif ou une convention revient souvent dans le projet et mérite d'être documenté comme compétence réutilisable.
À éviter pour documenter une tâche ponctuelle ou pour un projet dont la base de code n'est pas accessible à l'analyse.
Analyse de sécurité
SûrThe skill instructs creating a directory and writing a SKILL.md file using codebase analysis and user input. It contains no destructive commands, no network activity, no exfiltration, and no obfuscated payloads. The only command is a benign mkdir -p for a project-local .claude/skills directory.
Aucun point d'attention détecté
Exemples
/add-skill error handling/add-skill how we write integration tests for API endpointsAdd 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.