[Skills Series #2] Atomic vs Méta-Skills : L'Art du Namespace et de la Composition

📚 Série Architecture & Skills IA (2/5) ⬅️ Épisode 1 : Du Prompt Drift à l'Architecture ➡️ Épisode 2 : Atomic vs Méta-Skills — L'Art du Namespace et de la Composition (Vous êtes ici) ➡️ Épisode 3 : Déploiement Multi-Agents — Globaux vs Locaux et Auto-Provisionnement ➡️ Épisode 4 : Dans les Entrailles du Code — Anatomie, Scripts Réels & Sécurité Git ➡️ Épisode 5 : La Galaxie de Sites Web & Le Ciment du Showcase Nexus

Dans l'épisode précédent, nous avons vu pourquoi il est indispensable d'extraire ses standards d'ingénierie dans des compétences réutilisables.

Mais dès qu'on commence à créer des dizaines de compétences pour ses agents IA, on se heurte immédiatement à deux pièges majeurs :

  1. L'encombrement du namespace : Comment éviter les collisions entre outils et permettre à l'agent de retrouver la bonne commande slash ?
  2. Le piège du méga-prompt monolithique : Vouloir créer un "super skill" de 2000 lignes qui essaie d'auditer le code, faire le SEO, lancer la CI, committer et rédiger la release d'un coup.

Voici comment nous avons résolu ces défis grâce à une architecture en sous-magasins thématiques, namespace hiérarchique et composition de méta-skills.

🏷️ Le Namespace Hiérarchique Abstrait (<scope>:<domaine>:<skill>)

Sans convention stricte, les compétences enregistrées globalement se mélangent avec les outils natifs de l'agent IA.

Voici un modèle d'architecture universel à 3 segments que vous pouvez adapter à votre propre écosystème :

                                [ Architecture de Namespace ]
                                <votre-scope> : <domaine> : <action-cible>
                                      │             │              │
                        ┌─────────────┘             │              └─────────────┐
                        ▼                           ▼                            ▼
                 [ Préfixe / Scope ]       [ Rayon / Domaine ]           [ Action Unitaire ]
                 • ex: mon-pseudo / team   • ex: meta, web, git, data    • ex: branch-guard, deploy
                 • Isole vos outils        • Donne le contexte à l'IA    • Responsabilité unique
  1. <scope>: (Le Préfixe / Namespace) : Isole l'ensemble de votre boîte à outils personnelle ou d'équipe contre toute collision avec les outils internes de l'agent.
  2. <domaine>: (Le Rayon Thématique) : Indique immédiatement à l'IA la catégorie d'intervention (ex: meta pour les orchestrateurs, web pour le front/perf, git pour le versionnage).
  3. <skill> (L'Action Spécifique) : Désigne la responsabilité exacte (ex: branch-guard, performance, lighthouse-ci).

🧱 Le Pattern de Composition : Des Briques Simples Pilotées par des Chefs d'Orchestre

La règle d'or du génie logiciel s'applique parfaitement aux agents IA : le principe de responsabilité unique (Single Responsibility Principle).

flowchart TD
    Meta[🪄 <scope>:meta:web-release-verifier] -->|1. Exécute| S1[📄 <scope>:web:static-pages 404 / Légal]
    Meta -->|2. Exécute| S2[🔍 <scope>:web:seo-meta OpenGraph / Robots]
    Meta -->|3. Exécute| S3[⚡ <scope>:web:performance WebP / Fonts Async]
    Meta -->|4. Exécute| S4[📱 <scope>:web:mobile-ux Sticky / Responsive]
    Meta -->|5. Exécute| S5[📊 <scope>:web:privacy-analytics GA4 sans cookies]
    Meta -->|6. Exécute| S6[🦶 <scope>:story:portfolio-cross-footer Footer Unifié]

    classDef meta fill:#4a154b,stroke:#e01e5a,stroke-width:2px,color:#fff;
    classDef atomic fill:#0d3b66,stroke:#00a8e8,stroke-width:2px,color:#fff;
    class Meta meta;
    class S1,S2,S3,S4,S5,S6 atomic;

A. Les Skills Atomiques (Les Briques Élémentaires)

Chaque skill atomique ne fait qu'une seule tâche et la fait parfaitement :

  • Optimisation de performance : Auto-héberger les dépendances, précharger les polices asynchrones, convertir les images en WebP et éliminer le Cumulative Layout Shift (CLS).
  • Protection de branches : Configurer la sécurité multi-niveaux (CODEOWNERS, workflows CI de sécurité, hooks locaux pre-push).
  • Audit de qualité : Lancer un audit Lighthouse automatisé et commenter la Pull Request avec un rapport clair.

B. Les Méta-Skills (Les Chefs d'Orchestre par Composition)

Les méta-skills ne réinventent aucune logique technique. Ils se contentent de :

  1. Scanner l'environnement et diagnostiquer les manques.
  2. Poser un questionnaire interactif si besoin.
  3. Appeler séquentiellement les skills atomiques dans l'ordre logique optimal.
  4. Auto-provisionner les compétences directement dans le projet cible pour le rendre autonome !

🗂️ Exemple de Structuration en 4 Rayons

Rayon RecommandéPréfixe SuggéréExemples d'Applications Pratiques
🪄 Méta-Orchestrateurs<scope>:meta:*repo-onboarding, web-release-verifier, release-lifecycle, project-showcase.
⚡ Ingénierie & Prod Web<scope>:web:*lighthouse-ci, performance, seo-meta, mobile-ux, privacy-analytics, static-pages.
🔀 Git & Gouvernance<scope>:git:*conventional-commits, pull-request-architect, open-source-readiness, branch-guard.
✍️ Storytelling & Vitrine<scope>:story:*blog-post-architect, lab-project-creator, cross-site-footer.

➡️ La Suite dans l'Épisode 3

Comment installer ce Hub sur Antigravity, Claude Code et Cursor en une seule commande ? Quelle est la différence entre un Skill Global (partagé sur toute la machine) et un Skill Local (embarqué dans le repo .agents/skills/) ?

🔗 Lire l'Épisode 3 : Déploiement Multi-Agents — Globaux vs Locaux et Auto-Provisionnement ➔

🔗 Liens & Ressources de la Série