Skills

Les skills sont des commandes /slash réutilisables qui encapsulent des workflows complets. Tapez /shingan:nom-du-skill pour l'invoquer.

Workflows

Skills multi-steps avec gates de validation. Le pipeline principal (kensho) est spec-driven : aucun code n'est écrit tant que la spécification n'est pas approuvée.

Skill	Steps	Description
/kensho	10	Pipeline principal — spec-driven (Analyze→Spec→Plan→Execute→Validate)
/bugfix	5	Diagnostic + correction
/review-code	4	Review structurée (qualité, sécurité, tests)
/clean-code	5	Refactoring guidé
/debug	5	Debugging systématique
/brainstorm	4	Exploration multi-perspective
/security-audit	6	Audit sécurité 4 couches (deps, Trivy, Snyk, IA)
/parallel	6	Multi-features en worktrees isolés (kensho ou team mode)
/update-docs	4	Synchronisation documentation vs code (audit + update parallèle)

Actions

Skills directs sans steps séparés.

Skill	Usage
/oneshot	Changement rapide (❤️ fichiers)
/commit	Commit conventionnel
/ci-fixer	Boucle de fix CI
/md-to-slides	Conversion Markdown → LaTeX Beamer
/beamer-design	Refonte visuelle Beamer
/init	Bootstrap framework
/claude-memory	Gestion mémoire
/profile	Gestion profiles techniques

Créateurs

Skills utilitaires pour créer de nouveaux composants du framework.

Skill	Crée
/create-skill	Un nouveau skill
/create-prompt	Un prompt LLM
/create-slash-commands	Une commande slash
/create-skills-workflow	Un skill workflow multi-steps
/subagent-creator	Un agent spécialisé
/hook-creator	Un hook événementiel
/prompt-creator	Un pipeline multi-stages

Format d'un SKILL.md

Chaque skill est défini par un fichier SKILL.md avec un frontmatter YAML et un corps en sections XML.

Frontmatter

Champ	Requis	Description
name	oui	Identifiant kebab-case, sert de commande /slash
description	oui	Description en langage naturel pour le matching automatique
argument-hint	non	Documentation des arguments CLI
disable-model-invocation	non	true pour empêcher le chargement automatique par Claude
user-invocable	non	false pour cacher du menu / (skills deprecated)
effort	non	Niveau de raisonnement : low, medium, high, max
paths	non	Glob patterns limitant l'auto-activation (ex: "**/*.tex")
allowed-tools	non	Outils autorisés automatiquement (format YAML array)

Sections du corps

Section	Usage
<objective>	Liste numérotée de ce que fait le skill
<quick_start>	Exemples d'utilisation
<flags>	Définitions des flags (-a, -x, -s, etc.)
<defaults>	Bloc YAML des valeurs par défaut
<steps>	Table step → fichier → description (skills multi-steps)
<agents>	Table des agents dispatchés par step
<process>	Instructions inline (skills sans step files)
<rules>	Contraintes globales
<escalation>	Quand basculer vers un skill plus complet

Deux patterns

• Skills multi-steps (kensho, bugfix, clean-code, debug, brainstorm, review-code) : le SKILL.md déclare une table <steps> pointant vers steps/step-NN-name.md. Les fichiers step sont chargés à la demande uniquement.
• Skills actions (commit, oneshot, ci-fixer, init, etc.) : le SKILL.md contient les instructions <process> inline. Pas de dossier steps/.
• Frontmatter spec-aligned (v1.7.0+) : les skills utilisent les champs officiels Claude Code (effort, disable-model-invocation, paths, allowed-tools en YAML array). Les champs category et color ont été retirés.

Système de flags

Les skills acceptent des flags pour adapter leur comportement :

Flag	Nom	Description
-a	auto	Sauter les confirmations (sauf la spec, toujours validée)
-x	examine	Review adversariale
-s	save	Sauvegarder les outputs dans docs/
-t	test	Inclure les étapes de test
-e	economy	Pas de subagents, économiser les tokens
-r	resume	Reprendre un travail précédent
-i	interactive	Configuration interactive

Flags majuscules

Les flags en majuscule désactivent l'option : -A désactive auto, -X désactive examine, etc.

Navigation dans les steps

Commande	Action
start	Démarrer le skill
next	Passer au step suivant
status	Voir la progression
approve	Valider la spec (step 01b)
revise	Demander des modifications à la spec
skip-analysis	Sauter l'analyse (si specs claires)
known-cause	Sauter le diagnostic (si cause connue)