Skills

Sur cette page

• Deux mécanismes distincts
• Skills skill/ (prompt système)
• Skills agent/skills (matching)
• Quand créer un skill

Deux mécanismes distincts

Deux systèmes coexistent — non fusionnés, documentés tels quels :

	skill/*.md	agent/skills/<nom>/SKILL.md
Emplacement	Racine du workspace	Dossier local (lu depuis process.cwd())
Chargement	Paresseux, au premier prompt	Paresseux, au premier matching
Rafraîchissement	Cache de 5 min	Figé jusqu'au redémarrage
Injection	Prompt système, section ## Loaded Skills	Dernier message utilisateur, [Skill Context (for AI)]
Commande dédiée	Aucune (/skill n'existe pas)	Aucune

Skills skill/ (prompt système)

• Fichiers .md à plat dans <workspace>/skill/, chacun tronqué à 2 000 caractères
• Le dossier n'existe pas par défaut : tant qu'il n'est pas créé, rien n'est chargé, rien ne coûte
• Un fichier ajouté devient visible au premier tour après expiration des caches (5 min max), sans commande à taper

Attention au coût : chaque fichier de skill/ est réinjecté à chaque tour. Ne créez pas de skills « au cas où » — chacun est une taxe permanente en tokens.

Skills agent/skills (matching)

• Le système documenté (format SKILL.md ou .txt), avec matching par intention, domaine et mots-clés
• Seuls le nom et la description (≤ 500 caractères) participent au matching — jamais le corps du fichier
• Ajouter ou modifier un skill exige de relancer marex (cache permanent)

Quand créer un skill

Quand un besoin récurrent et réel apparaît : procédure de déploiement du projet, conventions de code de l'équipe, checklist de revue… Pas avant.