| name | claude-setup |
| description | Bootstrap complet d'un environnement Claude Code optimisé. Installe les CLIs, configure les MCP servers, clone les skills et sub-agents, centralise les API keys et initialise un Second Brain personnel. À lancer une seule fois après l'installation de Claude Code. |
Claude Setup — Le setup parfait pour Claude Code
Ce skill automatise le bootstrap complet d'un nouvel utilisateur Claude Code. En 5 minutes, tu passes d'une installation vierge à un environnement productif avec Second Brain, sub-agents, skills et MCP servers.
Inspiré de la présentation YouTube de Gauthier — "Le setup parfait pour Claude Code".
Objectif
Mettre en place en une seule commande :
- Un Second Brain (
~/brainOS/) qui sert de mémoire persistante à tous tes agents.
- Les CLIs essentiels (Claude Code, GitHub CLI, Vercel CLI, Playwright).
- Les skills officiels Anthropic (
anthropics/skills) et la collection communautaire.
- Les 32 sub-agents Agency (
msitarzewski/agency-agents) installés dans ~/.claude/agents/.
- Le Playwright MCP server câblé dans la config Claude Code.
- Une gestion centralisée des API keys (
~/brainOS/secrets/keystore.env, chmod 600).
- Un agent perso avec son
soul.md, créé à partir de tes réponses.
Quand l'utiliser
- Juste après avoir installé Claude Code pour la première fois.
- Quand tu reçois une nouvelle machine et tu veux retrouver ton setup en 5 min.
- Pour mettre à jour un setup existant — le script est idempotent, il skip ce qui existe déjà.
Procédure (8 étapes orchestrées)
00 — detect-system → OS, shell, runtimes, package managers
01 — init-second-brain → ~/brainOS/{user.md, environment.md, goals.md, ...}
02 — install-clis → claude, gh, vercel, playwright (si absents)
03 — install-skills → anthropics/skills + agency-agents → ~/.claude/agents/
04 — setup-mcp → Playwright MCP dans ~/.claude.json (jq merge)
05 — collect-keys → Toutes les API keys → ~/brainOS/secrets/keystore.env
06 — create-agent → Agent perso avec soul/identity à partir des réponses
07 — recap → Résumé final + next steps
Chaque script est lancable individuellement depuis scripts/ si tu veux skip ou rejouer une étape.
Questions posées à l'utilisateur
Le skill est conversationnel. Il pose ~12 questions, distribuées sur les scripts :
| # | Question | Script |
|---|
| 1 | Ton prénom ? | 01 |
| 2 | Ton rôle (dev / designer / PM / founder) ? | 01 |
| 3 | Stack principal (TS / Python / Go / Other) ? | 01 |
| 4 | Niveau Claude Code (débutant / intermédiaire / avancé) ? | 01 |
| 5 | Path du Second Brain (défaut ~/brainOS) ? | 01 |
| 6 | Tu veux un agent perso ? Si oui, son nom ? | 06 |
| 7 | Ton de l'agent (formel / direct / cool) ? | 06 |
| 8 | Tu vas utiliser Vercel ? | 05 |
| 9 | Tu utilises GitHub ? | 02 + 05 |
| 10 | Tu as un compte Anthropic API ? | 05 |
| 11 | Tu veux Playwright MCP installé maintenant ? (oui par défaut) | 04 |
| 12 | Tu veux les 32 sub-agents Agency ? (oui par défaut) | 03 |
Si une réponse est déjà connue (env var, config existante), elle est récupérée silencieusement.
Output final
Une fois les 8 étapes terminées, l'utilisateur voit :
======================================================================
CLAUDE SETUP — TERMINÉ
======================================================================
Second Brain : ~/brainOS/
Agent perso : ~/brainOS/agents/<id>/soul.md
Sub-agents installés: 32 (~/.claude/agents/)
API keys : 5 stockées dans ~/brainOS/secrets/keystore.env
MCP servers actifs : playwright
Next steps :
1. Lance Claude Code : `claude`
2. Charge le contexte avec le skill `session-bootstrap`
3. Vérifie ton agent perso : `cat ~/brainOS/agents/<id>/soul.md`
Bon dev.
Lancement
Mode one-liner (recommandé pour un nouveau dev)
bash <(curl -fsSL https://raw.githubusercontent.com/gquthier/claude-setup/main/install.sh)
Mode local (pour développer/tester le skill)
git clone https://github.com/gquthier/claude-setup.git
cd claude-setup
bash install.sh
Mode étape par étape
bash scripts/00-detect-system.sh
bash scripts/01-init-second-brain.sh
Idempotence
Tous les scripts sont rejouables. Si tu relances install.sh :
- Les CLIs déjà installés sont skippés (
command -v check).
- Les fichiers existants ne sont jamais écrasés sans confirmation.
- Les API keys déjà présentes dans le keystore ne sont pas redemandées.
- La config MCP est mergée via
jq, pas écrasée.
Architecture finale
Voir docs/ARCHITECTURE.md pour le schéma complet : comment le Second Brain, les skills, les agents et les MCP servers s'articulent dans le workflow Claude Code.
