Skills procs
Skills, Procs et Templates
Tableau comparatif Skill vs Template vs Proc. Ce que c'est, comment ils s'articulent, et quand utiliser lequel.
Skills, Procs et Templates
Le systeme repose sur trois types de composants reutilisables. Chacun a un role distinct. Les confondre cree du chaos.
Definitions
| Composant | Ce que c'est | Exemple |
|---|---|---|
| Skill | Un prompt expert reutilisable. Encapsule un savoir-faire. | deep-research, trading-agent, content-dna |
| Procedure | Une sequence d'etapes a suivre. Un "how-to". | proc-deploy-site, proc-onboard-client |
| Template | Un modele de document pre-structure. | Template daily note, template rapport hebdo |
Tableau comparatif
| Critere | Skill | Procedure | Template |
|---|---|---|---|
| Nature | Prompt/expertise | Etapes sequentielles | Structure de document |
| Declencheur | Commande /skill ou detection auto | Demande agent ou cron | Creation de note |
| Qui l'execute | L'agent (via Claude Code) | L'agent ou l'humain | Templater (Obsidian) |
| Stockage KB | skills/ | procedures/ | templates/ |
| Stabilite | Haute (evolue lentement) | Moyenne (mise a jour reguliere) | Haute |
| Granularite | Large (peut couvrir un domaine entier) | Fine (une tache precise) | Document unique |
| Intelligence | Oui (raisonnement, decision) | Non (etapes fixes) | Non (structure fixe) |
| Versionnee | Oui (changelog dans la note) | Oui | Oui |
Comment ils s'articulent
Utilisateur : "Deploie le site de Acme Corp"
CEO :
1. Cherche un skill → skill "site-deploy" trouve
2. Le skill dit COMMENT reflechir au deploiement
3. Le skill reference la procedure → proc-deploy-cloudflare
4. La procedure dit les ETAPES exactes
5. Certaines etapes utilisent un template → template rapport de deploiementFlux typique :
Skill (reflechir)
|
→ Procedure (executer)
|
→ Template (documenter)Le skill guide la reflexion. La procedure guide l'execution. Le template structure le livrable.
Quand creer quoi
| Situation | Creer un... |
|---|---|
| "Comment faire X ?" (etapes repetables) | Procedure |
| "Sois expert en X" (expertise reutilisable) | Skill |
| "Genere un document de type X" | Template |
| "Analyse X puis decide Y" | Skill (implique du raisonnement) |
| "Fais X, Y, Z dans cet ordre" | Procedure (etapes lineaires) |
| "Chaque lundi, genere un rapport" | Procedure + Template |
Regles de creation
Skills
- Toujours creer via
skillforgeouskill-creator. Jamais a la main. - Un skill a un fichier
SKILL.mdavec frontmatter, description, triggers, et prompt. - Le skill est teste avant mise en production.
- Les skills sont organises par domaine :
ai/,business/,dev/,marketing/,security/,design/.
Procedures
- Nommage :
proc-{verbe}-{objet}.md(ex:proc-deploy-site.md) - Chaque etape est numerotee et actionnable.
- Les pre-requis sont listes en debut de procedure.
- Le resultat attendu est decrit en fin de procedure.
Templates
- Stockes dans
templates/dans la KB. - Utilises via Templater (plugin Obsidian).
- Variables entre
<% %>pour l'interpolation. - Un template ne contient pas de logique complexe.
Volumes actuels
| Composant | Nombre | Localisation |
|---|---|---|
| Skills | 430+ | KB skills/ + skills Claude Code |
| Procedures | 84 (KB) + 35 (clawd) | KB procedures/ + clawd/docs/procs/ |
| Templates | ~20 | KB templates/ |
Hierarchie de stabilite
Skills (tres stables — evoluent rarement)
|
Procedures (stables — mises a jour regulierement)
|
Templates (tres stables — changent rarement)
|
Knowledge (volatile — enrichi en continu)Un skill ne change que quand l'expertise evolue. Une procedure change quand le process evolue. Un template change quand le format evolue.
Anti-patterns
| Anti-pattern | Correction |
|---|---|
| Skill qui est juste une liste d'etapes | C'est une procedure, pas un skill |
| Procedure qui prend des decisions | Ajouter un skill en amont |
| Template avec de la logique metier | Deplacer la logique dans une procedure |
| Skill non-versionne | Ajouter un changelog dans la note |
| Procedure sans pre-requis | Ajouter les pre-requis en tete |