Créer ou mettre à jour des compétences Claude Code

VérifiéSûr

Guide la création et la mise à jour des fichiers SKILL.md pour Claude Code, couvrant la configuration frontmatter et les règles de contenu.

Spar Skills Guide Bot
DeveloppementIntermédiaire
1009/08/2026
Claude Code
#skill-authoring#claude-code#workflow#meta-skill

Recommandé pour

Notre avis

Ce skill crée ou met à jour des fichiers SKILL.md en fonction de la conversation courante, avec détection du mode création/mise à jour, génération de frontmatter et rédaction du contenu.

Points forts

  • Automatise la création de nouveaux skills avec un frontmatter correct.
  • Préserve les règles existantes lors des mises à jour, sans réécrire tout le fichier.
  • Respecte les contraintes de budget (moins de 500 lignes, coût token minimal).
  • Adapte le type de contenu (référence ou tâche) avec des exemples stricts.

Limites

  • Cible uniquement la structure `.claude/skills` de Claude Code.
  • Nécessite que la conversation fournisse suffisamment de détails pour générer un contenu précis.
  • Ne valide pas le fichier SKILL.md après son écriture.
Quand l'utiliser

Lorsque vous voulez créer un nouveau skill réutilisable ou mettre à jour progressivement un skill existant à partir du contexte courant.

Quand l'éviter

Lorsque vous devez rédiger manuellement un skill complexe avec beaucoup de prose, ou que le skill doit viser d'autres plateformes que Claude Code.

Analyse de sécurité

Sûr
Score qualité90/100

The skill contains instructions for creating and updating local markdown files using standard shell commands (mkdir, file writes). There is no exfiltration, destruction, disabling of safety, or remote execution. The file operations are confined to the .claude/skills directory.

Aucun point d'attention détecté

Exemples

Create a new skill
create-skill conventional-commits reference guide
Update an existing skill
update-skill api-testing add rule for mocking timeouts
Create skill with path scope
create-skill design-system token audit paths @soroush.tech/design-system/**

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.

  • Existsupdate mode: read the current file, then go to Step 3.
  • Does not existcreate 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.

Skills similaires