Agent OS
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

ComposantCe que c'estExemple
SkillUn prompt expert reutilisable. Encapsule un savoir-faire.deep-research, trading-agent, content-dna
ProcedureUne sequence d'etapes a suivre. Un "how-to".proc-deploy-site, proc-onboard-client
TemplateUn modele de document pre-structure.Template daily note, template rapport hebdo

Tableau comparatif

CritereSkillProcedureTemplate
NaturePrompt/expertiseEtapes sequentiellesStructure de document
DeclencheurCommande /skill ou detection autoDemande agent ou cronCreation de note
Qui l'executeL'agent (via Claude Code)L'agent ou l'humainTemplater (Obsidian)
Stockage KBskills/procedures/templates/
StabiliteHaute (evolue lentement)Moyenne (mise a jour reguliere)Haute
GranulariteLarge (peut couvrir un domaine entier)Fine (une tache precise)Document unique
IntelligenceOui (raisonnement, decision)Non (etapes fixes)Non (structure fixe)
VersionneeOui (changelog dans la note)OuiOui

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 deploiement

Flux 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

SituationCreer 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 skillforge ou skill-creator. Jamais a la main.
  • Un skill a un fichier SKILL.md avec 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

ComposantNombreLocalisation
Skills430+KB skills/ + skills Claude Code
Procedures84 (KB) + 35 (clawd)KB procedures/ + clawd/docs/procs/
Templates~20KB 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-patternCorrection
Skill qui est juste une liste d'etapesC'est une procedure, pas un skill
Procedure qui prend des decisionsAjouter un skill en amont
Template avec de la logique metierDeplacer la logique dans une procedure
Skill non-versionneAjouter un changelog dans la note
Procedure sans pre-requisAjouter les pre-requis en tete

On this page