Comment documenter un framework de pensee. Format, redaction, validation, cycle de vie.

Creer un skill

Un skill = un framework de pensee. Il dit COMMENT REFLECHIR.

Les agents lisent les skills avant d'agir. Un bon skill transforme un agent generique en expert du domaine.

Skill vs Proc vs Template

Confusion frequente. Voici la distinction.

+----------+----------------------------+---------------------------+
| Type     | Contenu                    | Exemple                   |
+----------+----------------------------+---------------------------+
| Skill    | Comment reflechir          | "Principes du copywriting"|
| Proc     | Comment faire (etapes)     | "Etapes pour publier"     |
| Template | Structure reutilisable     | "Modele de devis"         |
+----------+----------------------------+---------------------------+

Test simple : si ca se decompose en etapes numerotees, c'est une proc. Si c'est un cadre de reflexion, c'est un skill.

Format d'un skill

Chaque skill suit cette structure.

---
type: skill
domain: [domaine]
version: 1.0
---

# Skill : [Nom]

## Objectif
[1 phrase. Quel probleme de reflexion ca resout.]

## Quand l'utiliser
[Situations ou ce skill s'applique.]

## Principes
[Les regles de pensee. Max 7 principes.]

## Anti-patterns
[Ce qu'il ne faut PAS faire.]

## Exemples
[2-3 exemples concrets d'application.]

## Sources
[D'ou viennent ces principes.]

Rediger les principes

Les principes sont le coeur du skill. Chaque principe doit etre :

Actionnable. L'agent sait quoi faire en le lisant.
Testable. On peut verifier si c'est applique.
Court. 1 phrase par principe. 2 max.

BON PRINCIPE :
  "Chaque paragraphe traite un seul concept."

MAUVAIS PRINCIPE :
  "Il faut ecrire de maniere claire et concise en pensant
   au lecteur et en structurant bien ses idees."

Maximum 7 principes par skill. Au-dela, decouper en 2 skills.

Ecrire les anti-patterns

Les anti-patterns sont aussi importants que les principes. Ils disent a l'agent ce qu'il doit EVITER.

## Anti-patterns

- NE PAS utiliser de jargon sans le definir.
- NE PAS ecrire de paragraphes > 3 phrases.
- NE PAS melanger 2 concepts dans 1 section.

Un skill sans anti-patterns est incomplet.

Exemples concrets

Chaque skill a au moins 2 exemples.

Exemple : skill-copywriting

# Skill : Copywriting conversion

## Objectif
Ecrire du texte qui pousse a l'action.

## Principes
1. Le benefice avant la fonctionnalite.
2. Une seule idee par phrase.
3. Le CTA est visible sans scroller.
4. La preuve sociale precede la demande.
5. Le texte parle au lecteur ("vous"), pas de soi ("nous").

## Anti-patterns
- NE PAS lister les fonctionnalites sans benefices.
- NE PAS utiliser de superlatifs vides ("le meilleur").
- NE PAS cacher le prix.

## Exemples
AVANT : "Notre solution innovante utilise l'IA."
APRES : "Gagnez 2h par jour. L'IA trie vos emails."

Exemple : skill-analyse-donnees

# Skill : Analyse de donnees

## Objectif
Extraire des insights actionnables d'un dataset.

## Principes
1. Toujours commencer par la question business.
2. Verifier les donnees avant d'analyser (nulls, doublons).
3. Un graphique = une conclusion.
4. Correler n'est pas causer.
5. Presenter le "so what" avant les details.

## Anti-patterns
- NE PAS commencer par les graphiques.
- NE PAS presenter 20 metriques sans hierarchie.
- NE PAS conclure sans intervalle de confiance.

Validation

Avant d'integrer un skill au systeme, le tester.

Test en 3 etapes

1. SANS SKILL : Donner une tache a un agent sans le skill.
   Noter la qualite du resultat.

2. AVEC SKILL : Donner la meme tache avec le skill.
   Noter la qualite du resultat.

3. COMPARER : Le skill a-t-il ameliore le resultat ?
   Si non → revoir les principes.
   Si oui → valider et cataloguer.

Un skill qui n'ameliore pas le resultat est inutile. Le supprimer.

Cycle de vie

  [Brouillon] --test--> [Valide] --usage--> [Mature]
                                                |
                                          feedback
                                                |
                                          [Mis a jour]
                                                |
                                    plus utile ?
                                   /            \
                                 Non            Oui
                                /                \
                         [Archive]          [Mature v2]

Versionning

Chaque modification significative incremente la version.

v1.0 → Creation initiale
v1.1 → Ajout d'un principe ou anti-pattern
v2.0 → Refonte des principes

Revue trimestrielle

Tous les 3 mois, chaque skill est revu :

Toujours utilise ? Si non, archiver.
Les principes sont encore valides ? Si non, mettre a jour.
Des agents l'utilisent mal ? Si oui, clarifier.

Erreurs courantes

Skill trop vague. "Bien communiquer." Ca ne veut rien dire. Chaque principe doit etre testable.

Skill = procedure deguisee. Si c'est des etapes, c'est une proc.

Trop de principes. 15 principes = l'agent n'en retient aucun. Max 7. Decouper sinon.

Pas d'exemples. Les principes sans exemples sont interpretes librement. Toujours montrer le AVANT/APRES.

Creer un skill

On this page