kbrdn1/dotfiles/command-template

Template: Skill Claude Code

Les skills etendent les capacites de Claude. Chaque skill est un repertoire avec un fichier SKILL.md et des fichiers support optionnels.

Structure

Minimale

{nom}/
└── SKILL.md

Avec fichiers support

{nom}/
├── SKILL.md              # Instructions principales (requis)
├── reference.md          # Documentation detaillee (charge on-demand)
├── examples/
│   └── sample.md         # Exemples de sortie attendue
└── scripts/
    └── helper.py         # Script utilitaire executable

Template SKILL.md

---
name: {{SKILL_NAME}}
description: {{DESCRIPTION}}
argument-hint: {{ARGUMENT_HINT}}
disable-model-invocation: {{true|false}}
user-invocable: {{true|false}}
allowed-tools: {{TOOLS}}
model: {{MODEL}}
context: {{fork}}
agent: {{AGENT}}
---
 
# {{TITLE}}
 
## Instructions
{{INSTRUCTIONS}}
 
## Procedure
{{PROCEDURE}}
 
## Format de Sortie
{{OUTPUT_FORMAT}}
 
## Exemples
 
### Exemple 1
Input: `/{{SKILL_NAME}} arg1`
Output: ...
 
## Limites
### Ce que cette skill fait:
- {{WILL_DO}}
 
### Ce que cette skill NE fait PAS:
- {{WILL_NOT}}

Reference des Champs Frontmatter

Controle d'Invocation

Substitutions

Contexte Dynamique

Syntaxe !commande`` pour injecter du shell en preprocessing:

## Contexte
-Branch: !`git branch --show-current`
-Status: !`git status --short`
-PR: !`gh pr view $0 --json title,body 2>/dev/null`

Bonnes Pratiques

1. Description riche: Inclure keywords et cas d'usage pour decouverte automatique
2. SKILL.md < 500 lignes: Deplacer contenu detaille dans fichiers support
3. Fichiers support: Referencer depuis SKILL.md pour que Claude sache quand les charger
4. Effets de bord: Toujours disable-model-invocation: true pour deploy, commit, push, etc.
5. Connaissances de fond: user-invocable: false pour conventions, patterns, style guides
6. Sous-agent: context: fork uniquement avec instructions explicites (pas des guidelines)

Variables du Template:

• {{SKILL_NAME}}: Nom de la skill (kebab-case, minuscules, chiffres, tirets)
• {{DESCRIPTION}}: Description pour decouverte. Inclure keywords et cas d'usage.
• {{ARGUMENT_HINT}}: Format des arguments attendus. Ex: [target] [--focus area]
• {{TOOLS}}: Liste outils autorises. Ex: Read, Grep, Glob ou Bash(git *)
• {{MODEL}}: Modele optionnel (opus, sonnet, haiku)
• {{AGENT}}: Sous-agent optionnel (Explore, Plan, general-purpose, ou custom)
• {{INSTRUCTIONS}}: Instructions detaillees pour Claude
• {{PROCEDURE}}: Etapes a suivre
• {{OUTPUT_FORMAT}}: Format de sortie attendu