tradermonty/skill-designer

Skill Designer

Aperçu

Générer une invite complète pour Claude CLI à partir d'une spécification structurée d'idée de compétence. L'invite demande à Claude de créer un répertoire de compétences complet conformément aux conventions du dépôt : SKILL.md avec en-tête YAML, documents de référence, scripts d'assistance et structure de tests.

Quand l'utiliser

• Le pipeline de génération automatique de compétences sélectionne une idée dans le backlog et a besoin d'une invite de conception pour claude -p
• Un développeur souhaite amorcer une nouvelle compétence à partir d'une spécification d'idée au format JSON
• La révision de la qualité des compétences générées nécessite une connaissance de la grille d'évaluation

Prérequis

• Python 3.9+
• Aucune clé API externe requise
• Les fichiers de référence doivent exister sous references/

Flux de travail

Étape 1 : Préparer la spécification de l'idée

Accepter un fichier JSON (--idea-json) contenant :

• title : Nom lisible de l'idée
• description : Ce que fait la compétence
• category : Catégorie de la compétence (ex. : trading-analysis, developer-tooling)

Accepter un nom de compétence normalisé (--skill-name) qui sera utilisé comme nom de répertoire et champ name: dans l'en-tête YAML.

Étape 2 : Construire l'invite de conception

Exécuter le constructeur d'invite :

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "ma-nouvelle-competence" \
  --project-root .

Le script :

1. Charge le JSON de l'idée
2. Lit les trois fichiers de référence (guide de structure, checklist de qualité, modèle)
3. Liste les compétences existantes (jusqu'à 20) pour éviter les doublons
4. Génère une invite complète sur stdout

Étape 3 : Transmettre l'invite à Claude CLI

Le pipeline appelant canalise l'invite vers claude -p :

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "ma-nouvelle-competence" \
  --project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep

Étape 4 : Valider la sortie

Après que Claude a créé la compétence, vérifier :

• skills/<nom-competence>/SKILL.md existe avec le bon en-tête
• La structure du répertoire respecte les conventions
• Le score attribué par le réviseur double-axe (dual-axis-skill-reviewer) atteint le seuil requis

Format de sortie

Le script génère une invite textuelle simple sur stdout. Code de sortie 0 en cas de succès, 1 si les fichiers de référence requis sont manquants.

Ressources

• references/skill-structure-guide.md -- Structure du répertoire, format SKILL.md, conventions de nommage
• references/quality-checklist.md -- Checklist à 5 catégories du réviseur double-axe (100 points)
• references/skill-template.md -- Modèle SKILL.md avec en-tête YAML et sections standard
• scripts/build_design_prompt.py -- Script constructeur d'invite (interface CLI)