[Skills Series #3] Déploiement Multi-Agents : Globaux vs Locaux et Auto-Provisionnement

📚 Série Architecture & Skills IA (3/5) ⬅️ Épisode 1 : Du Prompt Drift à l'Architecture ⬅️ Épisode 2 : Atomic vs Méta-Skills — L'Art du Namespace et de la Composition ➡️ Épisode 3 : Déploiement Multi-Agents — Globaux vs Locaux et Auto-Provisionnement (Vous êtes ici) ➡️ É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

Après avoir conçu nos 17 skills modulaires et mis en place notre hiérarchie de namespace, la question cruciale se pose : comment rendre ces compétences disponibles sur tous nos agents IA, sur n'importe quelle machine et dans n'importe quel dépôt ?

C'est ici qu'intervient la distinction fondamentale entre Skills Centraux (Globaux) et Skills Locaux (Projets).

🌐 1. Skills Globaux vs Skills Locaux : Quelle Différence ?

flowchart TD
    Hub[🌌 Antigravity Skills Hub] --> Installer[⚙️ install.sh]
    
    Installer -->|--all-globals| GlobalStore[💻 Stores Globaux Machine]
    GlobalStore --> G1["~/.gemini/antigravity-cli/skills/ (AGY)"]
    GlobalStore --> G2["~/.claude/skills/ (Claude Code)"]
    GlobalStore --> G3["~/.cursor/skills-cursor/ (Cursor)"]
    GlobalStore --> G4["~/.agents/skills/ (Standard)"]

    Installer -->|--project <dir>| LocalStore[📁 Store Local Projet]
    LocalStore --> L1["<mon-projet>/.agents/skills/"]

    MetaOnboard[🪄 repo-onboarding-orchestrator] -.->|Auto-Provisionne| LocalStore

A. Les Skills Centraux / Globaux (Machine-Wide)

  • Où ils vivent : Dans les dossiers racines de vos outils (~/.claude/skills, ~/.gemini/antigravity-cli/skills, ~/.cursor/skills-cursor).
  • Pour quoi faire : Disponibles dans n'importe quel terminal ou conversation sur votre machine. C'est votre trousse à outils personnelle d'ingénieur (vos règles Git, vos checklists de release, vos générateurs de PR).
  • Comment les installer en 1 seconde :
  ./install.sh --all-globals

B. Les Skills Locaux / Embarqués (Project-Specific)

  • Où ils vivent : Directement dans le dépôt Git du projet cible (<mon-projet>/.agents/skills/).
  • Pour quoi faire : Le skill voyage avec le code source. Quand un autre développeur ou un agent IA clone le repo, il hérite immédiatement de toutes les commandes spécialisées du projet sans avoir à installer quoi que ce soit sur sa machine.
  • Comment les provisionner manuellement :
  ./install.sh --project /chemin/vers/mon-projet

C. Le Graal : L'Auto-Provisionnement par l'IA

Au lieu de copier les skills manuellement, nous avons conçu le méta-skill boblebol:meta:repo-onboarding-orchestrator :

  1. Dès que vous clonez un nouveau projet, vous lancez /boblebol:meta:repo-onboarding-orchestrator.
  2. L'agent analyse le projet, compare ses manques avec les 17 skills du Hub.
  3. Il copie automatiquement les skills atomiques requis directement dans le .agents/skills/ du projet et vous propose de les exécuter !

🛠️ 2. Mini-Tuto : Créer votre propre Bibliothèque de Skills

Voici l'anatomie exacte pour bâtir votre propre Hub de compétences :

Étape 1 : Le format standard SKILL.md

Chaque skill est un dossier contenant un fichier SKILL.md avec un frontmatter YAML :

---
name: "mon-pseudo:domaine:mon-skill"
description: >-
  Description concise de ce que fait le skill et quand l'agent doit l'utiliser.
---

# 🚀 Titre du Skill

Instructions pas à pas :
1. Analyse tel fichier de configuration.
2. Exécute telle commande CLI.
3. Formate le résultat selon ce template Markdown.

Étape 2 : Le script d'installation universel (install.sh)

#!/usr/bin/env bash
set -euo pipefail

TARGET_DIR="${1:-$HOME/.agents/skills}"
mkdir -p "${TARGET_DIR}"

for skill_file in $(find ./skills -type f -name "SKILL.md" | sort); do
  skill_dir="$(dirname "${skill_file}")"
  skill_name="$(basename "${skill_dir}")"
  echo "📦 Déploiement : ${skill_name}"
  mkdir -p "${TARGET_DIR}/${skill_name}"
  cp -r "${skill_dir}"/* "${TARGET_DIR}/${skill_name}/"
done

💬 3. Boîte à Prompts : Les prompts exacts utilisés pour ce Hub

Voici les vrais prompts de vibe coding que j'ai utilisés avec Claude et Antigravity pour concevoir ce Hub :

1. Le Prompt de Minage d'Historique

"Regarde ce qu'on vient de réussir sur ce projet (l'optimisation des polices asynchrones, la suppression des CDN tiers et le score Lighthouse à 100). Extrais toute cette méthodologie et transforme-la en un skill modulaire SKILL.md avec un frontmatter YAML, des instructions pas à pas et un exemple d'invocation."

2. Le Prompt de Restructuration & Namespace

"On a trop de skills éparpillés. Range-les en 4 rayons logiques (meta, web, git, story), ajoute un namespace à 2 niveaux <votre-scope>:<domaine>:<skill>, et écris un script bash d'installation qui scanne récursivement tous les sous-dossiers pour déployer dans ~/.agents, ~/.claude et ~/.cursor."

3. Le Prompt du Méta-Orchestrateur Provisionneur

"Je veux un méta-skill <votre-scope>:meta:repo-onboarding : quand je clone un nouveau projet, il doit scanner l'arborescence, détecter les manques face à notre bibliothèque de skills, copier automatiquement les compétences requises dans .agents/skills/ du projet, et m'afficher un questionnaire interactif pour exécuter les montées de niveau."

4. Le Prompt de Release Automatisée de Bout en Bout

"Crée un skill <votre-scope>:meta:release-lifecycle qui automatise 100% de ma release : analyse les commits pour calculer le SemVer, met à jour CHANGELOG.md en format Keep a Changelog, crée la branche release/vX.Y.Z, ouvre une PR sur GitHub avec diagramme Mermaid d'architecture, la merge dans main et publie la GitHub Release officielle avec tag et notes."

🎯 Conclusion : L'Ingénierie à l'Ère des Agents

En passant du prompting manuel répété à une bibliothèque d'ingénierie modulaire pilotée par des méta-orchestrateurs, nous avons éliminé la charge mentale du vibe coding tout en garantissant des standards de production irréprochables.

🔗 Liens & Ressources de la Série