Skill Architect

Architecte de bibliothèques de skills pour agents IA.

Avant d'écrire le moindre skill, il faut trancher le découpage : un seul skill ? plusieurs ? un socle commun avec des déclinaisons ? Ce skill mène une interview de découverte, applique des règles de décision explicites, et produit un document d'architecture à valider — puis passe la main au skill-creator pour la rédaction.

Ce que le skill évite

• Le monolithe : un skill fourre-tout qui couvre tout un métier et charge du contexte inutile.
• La fragmentation : dix micro-skills là où un seul avec des fichiers references/ suffisait.
• L'architecture impossible : des "sous-skills" qui s'appellent entre eux (ce mécanisme n'existe pas chez Claude).
• Le sous-déclenchement : des descriptions YAML vagues qui font que le skill ne se déclenche jamais.

Quand il se déclenche

• Tu veux créer un ou plusieurs skills à partir d'une expertise métier ou de prompts existants.
• Tu veux structurer un "socle commun" avec des déclinaisons (ex. marketing global + cold call + cold email).
• Tu ne sais pas s'il faut un seul skill ou plusieurs.
• Tu décris un domaine large (vente, support, contenu, juridique…) à convertir en skills.
• Tu fais évoluer une bibliothèque existante : ajouter un skill à un plugin/namespace (ex. /company:sales à côté de /company:brands et /company:marketing), modifier ou redécouper un skill en place, diagnostiquer un skill qui ne se déclenche jamais, ou poser les conventions d'extension d'une bibliothèque appelée à grossir (juridique, RH… à venir).

Structure

skills/skill-architect/
├── SKILL.md                        # Déroulé en 4 phases (extraction, interview, architecture, validation)
└── references/
    ├── interview.md                # Banque de questions en 6 vagues
    ├── decision-rules.md           # Règles de découpage un-skill vs plusieurs
    └── output-template.md          # Template du document d'architecture

---

Installation

Option 1 — Claude Code via marketplace (recommandé)

Dans une session Claude Code :

/plugin marketplace add Alexisgt01/skill-architect
/plugin install skill-architect@skill-architect

Le skill est ensuite disponible dans toutes tes sessions. Pour mettre à jour : /plugin marketplace update skill-architect.

Option 2 — Claude Code en copie manuelle

git clone https://github.com/Alexisgt01/skill-architect.git
mkdir -p ~/.claude/skills
cp -r skill-architect/skills/skill-architect ~/.claude/skills/

Pour limiter le skill à un seul projet, copie-le dans .claude/skills/ à la racine du projet au lieu de ~/.claude/skills/.

Option 3 — claude.ai (interface web / desktop)

1. Télécharge skill-architect.skill depuis la dernière release.
2. Sur claude.ai : Paramètres → Capacités → Skills → Importer un skill (upload du fichier).
3. Active le skill dans la conversation si nécessaire.

Le fichier .skill est une archive zip standard contenant le dossier du skill — tu peux aussi la régénérer toi-même : cd skills && zip -r skill-architect.skill skill-architect.

Option 4 — API Anthropic

Le format est compatible avec l'upload de skills via l'API (/v1/skills), pour l'utiliser dans tes propres agents.

---

Utilisation

Une fois installé, le skill se déclenche automatiquement dès que tu demandes de créer ou structurer des skills. Tu peux aussi le forcer :

Utilise skill-architect : je veux transformer mes process de prospection en skills.

Il fonctionne en tandem avec skill-creator : skill-architect décide du découpage, skill-creator rédige.

Licence

MIT