Notre avis
Crée ou met à jour une compétence Claude Code en transformant la conversation en cours en fichier SKILL.md avec les métadonnées et les règles appropriées.
Points forts
- Encourage des fichiers de compétence concis et orientés comportement
- Fournit des directives claires pour les métadonnées frontmatter
- Distingue explicitement les modes création et mise à jour
- Met l'accent sur l'efficacité en termes de coût de tokens
Limites
- Spécifique à Claude Code, non portable vers d'autres outils
- Nécessite un jugement manuel pour le mode et les métadonnées
- Aucune validation automatisée du fichier SKILL.md généré
Lorsque vous devez persister un nouveau comportement réutilisable ou mettre à jour une compétence existante pendant une session Claude Code.
Lorsque la compétence est déjà entièrement rédigée ou que vous discutez uniquement de code sans modifier les définitions de compétences.
Analyse de sécurité
PrudenceThe skill instructs the AI to create directories and write files, which are powerful operations but legitimate for the purpose of managing skill files. It does not contain destructive or exfiltrating commands.
- •Uses file system operations (mkdir, write) which could be misused if arguments are untrusted.
Exemples
Create a skill named code-review-checklist with guidelines for reviewing pull requests.Update the skill typescript-error-fixes with the new rule about null checks.Add a new rule to existing skill commit-message about conventional commits.Create or update a skill based on the current conversation.
The first word of $ARGUMENTS is the skill name (kebab-case). The rest is an optional note about what to add or change.
Step 1 — Detect mode
Check whether .claude/skills/$0/SKILL.md already exists.
- Exists → update mode: read the current file, then go to Step 3.
- Does not exist → create mode: go to Step 2.
Step 2 — Determine frontmatter (create only)
Decide the correct frontmatter based on what the skill does:
description — one sentence: what the skill does + when Claude should auto-load it. Put the key trigger phrase first (budget is 1,536 chars).
paths — set only if the skill is scoped to specific files. Use glob patterns:
- Design system / theme work →
@soroush.tech/design-system/** - All TypeScript →
**/*.ts,**/*.tsx - Omit for project-wide knowledge
argument-hint — short label shown in autocomplete, e.g. [filename] or [component-name].
disable-model-invocation: true — add only if this is a manual workflow with side effects (deploy, commit, send). Reference knowledge should NOT have this.
user-invocable: false — add only if users should never call it directly (pure background context).
Step 3 — Write content
Rules for skill content:
- Reference skills (conventions, patterns, style guides): state the rule + one ✗/✓ code pair. No prose explaining why — the example shows it.
- Task skills (step-by-step actions): numbered steps, imperative verbs, no explanation.
- Keep SKILL.md under 500 lines.
- Every line is a recurring token cost — cut anything that doesn't change Claude's behavior.
- End with:
If $ARGUMENTS names a file, read it and apply the rules. Otherwise apply to the code being discussed.(for reference skills only).
Update mode: add the new rule or change to the appropriate section. Do not touch unrelated rules. Remove any rule made obsolete by the change.
Step 4 — Write the file
For create: run mkdir -p .claude/skills/$0 then write .claude/skills/$0/SKILL.md.
For update: write the updated .claude/skills/$0/SKILL.md.
Confirm what was created or changed. If a new paths scope was set, mention which files will trigger it.
Expert Next.js App Router
Developpement
Un skill qui transforme Claude en expert Next.js App Router.
Générateur de README
Developpement
Crée des README.md professionnels et complets pour vos projets.
Rédacteur de Documentation API
Developpement
Génère de la documentation API complète au format OpenAPI/Swagger.