{"id":51320705,"url":"https://github.com/fdelbrayelle/cgp-skills","last_synced_at":"2026-07-01T13:02:17.375Z","repository":{"id":367808854,"uuid":"1282319752","full_name":"fdelbrayelle/cgp-skills","owner":"fdelbrayelle","description":"💼 Une suite modulaire de compétences financières pour Claude Code. Transformez votre terminal en Conseiller en Gestion de Patrimoine (CGP) virtuel pour auditer, rééquilibrer et optimiser votre allocation d'actifs.","archived":false,"fork":false,"pushed_at":"2026-06-27T18:01:22.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-27T20:04:39.919Z","etag":null,"topics":["cgp","claude-code","cli","personal-finance","wealth","wealth-management"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fdelbrayelle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-27T16:03:59.000Z","updated_at":"2026-06-27T18:01:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fdelbrayelle/cgp-skills","commit_stats":null,"previous_names":["fdelbrayelle/cgp-skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/fdelbrayelle/cgp-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdelbrayelle%2Fcgp-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdelbrayelle%2Fcgp-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdelbrayelle%2Fcgp-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdelbrayelle%2Fcgp-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fdelbrayelle","download_url":"https://codeload.github.com/fdelbrayelle/cgp-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdelbrayelle%2Fcgp-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35007278,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cgp","claude-code","cli","personal-finance","wealth","wealth-management"],"created_at":"2026-07-01T13:02:16.441Z","updated_at":"2026-07-01T13:02:17.354Z","avatar_url":"https://github.com/fdelbrayelle.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💼 CGP Skills — Votre CGP Virtuel sous Claude Code\n\nGérez et pilotez votre patrimoine personnel directement depuis Claude Code, comme avec un **Conseiller en Gestion de Patrimoine (CGP)** à portée de clavier. L'outil est conçu pour les investisseurs français et couvre toutes les spécificités locales : PEA, PER, Assurance Vie, SCPI (pleine et nue-propriété), or physique, private equity, crypto.\n\n---\n\n## 🎯 Philosophie\n\nCe projet est **Claude-native** : les skills sont des prompts en français dans `.claude/commands/`. Claude lit votre patrimoine JSON, fait tous les calculs et produit une analyse experte. Zéro dépendance Python pour la logique métier.\n\nSeul `cgp/export.py` utilise Python, pour générer des rapports HTML/PDF/PNG.\n\n---\n\n## 🚀 Démarrage rapide\n\n### 1. Cloner le projet\n\n```bash\ngit clone \u003cvotre-repo\u003e cgp-skills\ncd cgp-skills\n```\n\n### 2. Lancer l'onboarding\n\nDans Claude Code (terminal ou IDE), tapez :\n\n```\n/initializing:SKILL\n```\n\nClaude vous guidera **une question à la fois** (13 étapes) pour saisir :\n- Profil investisseur : âge, risque, horizon, TMI, dépenses mensuelles, objectif FIRE\n- Allocation cible par classe d'actifs\n- Liquidités (Livret A, LDDS, LEP, compte courant)\n- PEA (broker, date d'ouverture, composition)\n- PER, Assurance Vie(s)\n- SCPI pleine propriété et nue-propriété avec réinvestissement des loyers\n- Or physique (pièces et lingots, prix d'achat moyen)\n- Private Equity (FCPI, FIP, club deals)\n- Crypto (BTC, ETH, altcoins, DeFi/staking, prix de revient)\n- BSPCE (si salarié en startup : vesting, prix d'exercice, fiscalité)\n- Immobilier (résidence principale avec indivision, locatif)\n- Régime matrimonial (si marié ou pacsé)\n\n### 3. Lancer votre premier audit\n\n```\n/auditing:SKILL\n```\n\n---\n\n## 📋 Skills disponibles\n\n| Commande                | Description |\n|-------------------------|-------------|\n| `/initializing:SKILL`   | Onboarding interactif — 13 étapes, une question à la fois, toutes les classes d'actifs françaises |\n| `/auditing:SKILL`       | Audit expert : allocation, règle 100−âge, règle des 4%, cash par profil, fiscalité |\n| `/updating:SKILL`       | Mise à jour d'une valeur précise par menu numéroté (34 champs, dont BSPCE) |\n| `/rebalancing:SKILL`    | Allocation optimale du DCA mensuel en euros par classe DCA-compatible |\n| `/snapshotting:SKILL`   | Snapshot mensuel manuel → `data/history/YYYY-MM.json` |\n| `/taxing:SKILL`         | Guide fiscal personnalisé par formulaire (2042, 2044, 2086, 3916-bis, 2092) |\n| `/exporting:SKILL`      | Export rapport HTML / PDF / PNG |\n\n---\n\n## 🧠 Ce que fait `/auditing:SKILL`\n\nL'audit est le cœur du projet. Il produit une analyse complète en 8 sections :\n\n**1. Vue d'ensemble** — Patrimoine brut, net, passif, ratio\n\n**2. Répartition** — Tableau allocation actuelle vs cible + barres Unicode visuelles pour 9 classes d'actifs\n\n**3. Détail des actifs** — Analyse enveloppe par enveloppe :\n- PEA : ancienneté, plus-value latente, marge de versement\n- PER : économie d'impôt annuelle calculée à la TMI\n- AV : ancienneté, statut abattement 8 ans\n- SCPI PP : loyers nets après fiscalité, état du réinvestissement des loyers\n- SCPI NP : illiquidité, date fin usufruit, plus-value de reconstitution estimée\n- Or physique : option fiscale optimale calculée selon ancienneté (forfaitaire vs réelle)\n- Private Equity : état de blocage, exonération PV si \u003e 5 ans\n- Crypto : détail BTC/ETH/altcoins, DeFi, plus-values latentes\n\n**4. Analyse stratégique CGP** :\n- 🎯 **Règle des 100 − âge** : `100 − âge` = % cible en actions (ex : 34 ans → 66% en actions)\n- 📐 **Cohérence profil** : vos cibles vs les fourchettes de référence par profil\n- 🏠 **Concentration immobilière** : alerte si RP \u003e 50% du patrimoine brut\n- 🛡️ **Réserve de précaution** : 2–6 mois de dépenses selon profil (calculé sur vos dépenses réelles)\n- 💰 **Optimisation fiscale** : PER, PEA, AV, SCPI, or, PE, crypto\n\n**5. Règle des 4%** — Indépendance financière :\n- Revenu mensuel soutenable au taux 3,5% et 4%\n- Capital manquant pour atteindre votre objectif FIRE\n- Projection patrimoniale à [âge + horizon] ans avec DCA mensuel\n\n**6. Analyse de liquidité** — Part illiquide (immobilier + SCPI NP + PE + or) vs limites par profil\n\n**7. Score patrimonial /10** — Diversification, cohérence profil, enveloppes fiscales, réserve\n\n**8. 3 actions prioritaires** — Concrètes et priorisées\n\n---\n\n## 💸 Ce que fait `/taxing:SKILL`\n\nLe skill fiscal génère un guide personnalisé et structuré pour votre déclaration annuelle, formulaire par formulaire :\n\n| Formulaire | Ce qui est couvert |\n|------------|-------------------|\n| **2042** | PER (cases 6DD/6RS/6QS), rachats AV après 8 ans, retraits PEA, dividendes CTO |\n| **2044** | Revenus fonciers SCPI PP en direct — micro-foncier vs régime réel, conseil TMI |\n| **2086** | Cessions crypto vers fiat — calcul PV, outils recommandés (Waltio, Koinly) |\n| **3916-bis** | Exchanges étrangers à déclarer (Coinbase, Kraken...) — obligation annuelle |\n| **2092** | Or physique — calcul comparatif option forfaitaire 11,5% vs PV réelle 36,2% |\n| **Staking/DeFi** | Récompenses imposables en BNC (Lido, etc.) |\n| **FCPI/FIP** | Exonération IR si \u003e 5 ans de détention, PS 17,2% restants |\n| **Checklist IFU** | Documents à récupérer auprès de chaque établissement |\n\nLe skill commence par vous poser des questions sur vos transactions de l'année N-1 avant de générer le guide.\n\n---\n\n## 🔄 Workflow mensuel recommandé\n\n```\n1. /updating:SKILL    → Mettre à jour les soldes (PEA, crypto, or...)\n2. /auditing:SKILL    → Analyser l'état du patrimoine\n3. /rebalancing:SKILL → Savoir où mettre les X XXX €/mois de DCA\n4. /exporting:SKILL   → Archiver le rapport du mois\n```\n\n**En période fiscale (avril-mai) :**\n```\n5. /taxing:SKILL      → Guide personnalisé par formulaire pour votre déclaration N-1\n```\n\n---\n\n## 🇫🇷 Spécificités françaises intégrées\n\n| Produit | Règles intégrées |\n|---------|-----------------|\n| **PEA** | Règle des 5 ans, plafond 150k€, 1/personne, calcul PV latente |\n| **PER** | Déductibilité TMI, plafond 10% revenus, calcul économie d'impôt |\n| **Assurance Vie** | Règle des 8 ans, abattement 4 600/9 200 €/an, avantage successoral |\n| **SCPI PP** | Revenus nets après TMI + 17,2%, réinvestissement des loyers |\n| **SCPI NP** | Illiquidité, zéro fiscalité pendant usufruit, revalorisation non imposable |\n| **Or physique** | Option A (11,5% forfaitaire) vs Option B (36,2% sur PV réelle, abattement 5%/an) |\n| **Private Equity** | Réduction IR 18-25% FCPI/FIP, exonération PV IR après 5 ans |\n| **Crypto** | PFU 30%, échanges crypto/crypto non imposables, staking = BNC, 3916-bis |\n| **Règle 100−âge** | Exposition actions recommandée = 100 − âge |\n| **Règle des 4%** | SWR 3,5% (Europe) et 4% (Trinity Study), projection FIRE |\n\n---\n\n## 🌍 Utiliser les skills depuis n'importe où\n\nPar défaut, les skills `.claude/commands/` ne sont disponibles que lorsque Claude Code est lancé **depuis le répertoire `cgp-skills/`**. Trois options pour les rendre accessibles depuis n'importe où :\n\n---\n\n### Option A — Symlinks globaux *(recommandée)*\n\nCrée des liens symboliques vers le répertoire global `~/.claude/commands/` :\n\n```bash\nmkdir -p ~/.claude/commands\nfor skill in auditing initializing updating rebalancing snapshotting taxing exporting; do\n  ln -s /chemin/vers/cgp-skills/.claude/commands/$skill ~/.claude/commands/$skill\ndone\n```\n\nLes 7 skills (`/auditing:SKILL`, `/taxing:SKILL`, etc.) deviennent alors disponibles dans **toute session Claude Code**, quel que soit le répertoire courant.\n\n\u003e **Limitation :** `CLAUDE.md` (formules de calcul, règles fiscales, structure JSON) ne se charge pas automatiquement hors du répertoire projet. Les skills restent utilisables mais sans le contexte complet du CGP.\n\u003e\n\u003e **Contournement :** ajouter cette ligne dans `~/.claude/CLAUDE.md` pour charger le contexte globalement :\n\u003e ```\n\u003e @/chemin/vers/cgp-skills/CLAUDE.md\n\u003e ```\n\n\u003e **Nota :** `data/patrimoine.json` étant un chemin relatif, les skills chercheront ce fichier dans le **répertoire courant**. Lancer Claude Code depuis `cgp-skills/` reste la façon la plus simple de garantir le bon fonctionnement.\n\n---\n\n### Option B — Alias shell\n\nAjouter dans `~/.zshrc` ou `~/.bashrc` :\n\n```bash\nalias cgp='cd /chemin/vers/cgp-skills \u0026\u0026 claude'\n```\n\n```bash\nsource ~/.zshrc   # ou ~/.bashrc\ncgp               # Lance Claude Code dans cgp-skills — tout fonctionne\n```\n\nSimple, zéro configuration supplémentaire, `CLAUDE.md` et `data/` toujours disponibles.\n\n---\n\n### Option C — Setup complet avec chemins absolus\n\nPour une disponibilité totale sans contrainte de répertoire :\n\n1. Symlinks globaux (cf. Option A)\n2. Import global de `CLAUDE.md` dans `~/.claude/CLAUDE.md` :\n   ```\n   @/chemin/vers/cgp-skills/CLAUDE.md\n   ```\n3. Modifier chaque `SKILL.md` pour utiliser le chemin absolu de `data/patrimoine.json` :\n   ```\n   # Remplacer dans chaque SKILL.md :\n   data/patrimoine.json\n   # Par :\n   /chemin/vers/cgp-skills/data/patrimoine.json\n   ```\n\n\u003e ⚠️ Les modifications de chemins en Option C sont locales (ne pas commiter ces chemins absolus dans le repo partagé).\n\n---\n\n## 👥 Utiliser ce projet pour d'autres personnes\n\nCe projet peut être utilisé pour suivre le patrimoine de plusieurs personnes (famille, conjoint) en maintenant plusieurs fichiers JSON :\n\n```bash\n# Votre patrimoine\ncp data/patrimoine.json.example data/patrimoine.json\n\n# Patrimoine du conjoint (exemple)\ncp data/patrimoine.json.example data/patrimoine_conjoint.json\n```\n\n\u003e ⚠️ Ajoutez `data/patrimoine_*.json` à votre `.gitignore` pour protéger tous ces fichiers.\n\nPour qu'un autre utilisateur utilise ce projet sur sa propre machine :\n\n1. **Cloner le repo** (ou copier les fichiers du projet)\n2. **Ouvrir dans Claude Code** (`claude` dans le terminal depuis le dossier)\n3. **Lancer** `/initializing:SKILL` pour créer son propre `data/patrimoine.json`\n4. Les skills sont dans `.claude/commands/` → automatiquement disponibles dans Claude Code\n\n### Structure des commandes Claude Code\n\nLes skills sont stockés dans des dossiers nommés sous `.claude/commands/` :\n\n```\n.claude/commands/\n  auditing/SKILL.md      → /auditing:SKILL\n  initializing/SKILL.md  → /initializing:SKILL\n  updating/SKILL.md      → /updating:SKILL\n  rebalancing/SKILL.md   → /rebalancing:SKILL\n  snapshotting/SKILL.md  → /snapshotting:SKILL\n  taxing/SKILL.md        → /taxing:SKILL\n  exporting/SKILL.md     → /exporting:SKILL\n```\n\n\u003e **Note :** La syntaxe `dossier:fichier` est la convention Claude Code pour les sous-commandes.\n\u003e Le `CLAUDE.md` à la racine est chargé automatiquement comme contexte projet.\n\n---\n\n## 📁 Structure du projet\n\n```\ncgp-skills/\n├── CLAUDE.md                         ← Instructions CGP + formules de calcul + référentiels\n├── .claude/\n│   └── commands/\n│       ├── auditing/SKILL.md         ← /auditing:SKILL\n│       ├── initializing/SKILL.md     ← /initializing:SKILL\n│       ├── updating/SKILL.md         ← /updating:SKILL\n│       ├── rebalancing/SKILL.md      ← /rebalancing:SKILL\n│       ├── snapshotting/SKILL.md     ← /snapshotting:SKILL\n│       ├── taxing/SKILL.md           ← /taxing:SKILL\n│       └── exporting/SKILL.md        ← /exporting:SKILL\n├── cgp/\n│   ├── __init__.py\n│   ├── export.py                     ← Export HTML/PDF/PNG\n│   └── snapshot.py                   ← Historique automatique (hook PostToolUse)\n├── data/\n│   ├── patrimoine.json               ← VOS données (gitignored !)\n│   ├── patrimoine.json.example       ← Template complet avec données fictives\n│   └── history/                      ← Snapshots mensuels (gitignored)\n├── exports/                          ← Rapports générés (gitignored)\n├── requirements.txt\n└── .gitignore\n```\n\n---\n\n## 🔒 Sécurité \u0026 confidentialité\n\n- `data/patrimoine.json` → dans `.gitignore` → **jamais commité**\n- `exports/` → dans `.gitignore` → rapports non versionnés\n- Aucune donnée transmise à des services tiers\n- Tout reste sur votre machine locale\n\n\u003e ⚠️ Usage **strictement personnel**. Ne constitue pas un conseil financier professionnel réglementé.\n\n---\n\n## 🔐 Sauvegarde chiffrée automatique\n\n`patrimoine.json` et les snapshots mensuels sont sauvegardés automatiquement dans un **repo GitHub privé**, chiffrés avec [age](https://age-encryption.org/) avant d'être envoyés. Sans la clé privée, le contenu est illisible.\n\n### Installation de age\n\n**Ubuntu/Debian :**\n```bash\nsudo apt install age\n```\n\n**macOS :**\n```bash\nbrew install age\n```\n\n### Setup initial (une seule fois)\n\n```bash\n# 1. Générer une clé age\nmkdir -p ~/.age \u0026\u0026 age-keygen -o ~/.age/key.txt\n# → Sauvegarder ~/.age/key.txt dans un gestionnaire de mots de passe (Bitwarden, 1Password…)\n\n# 2. Créer le repo de backup privé\ngh repo create patrimoine-backup --private\ngit clone git@github.com:\u003cvotre-compte\u003e/patrimoine-backup.git ~/patrimoine-backup\n\n# 3. Activer le hook dans Claude Code (déjà configuré dans .claude/settings.json)\n# → La sauvegarde se déclenche automatiquement après chaque modification de patrimoine.json\n```\n\n### Ce qui est sauvegardé\n\n```\n~/patrimoine-backup/\n├── patrimoine.json.age      ← état actuel (chiffré)\n└── history/\n    ├── 2026-01.json.age     ← snapshots mensuels (chiffrés)\n    └── …\n```\n\n### Restaurer sur une nouvelle machine\n\n```bash\n# 1. Installer age et restaurer ~/.age/key.txt (depuis votre gestionnaire de mots de passe)\n# 2. Cloner le repo de backup\ngit clone git@github.com:\u003cvotre-compte\u003e/patrimoine-backup.git ~/patrimoine-backup\n# 3. Lancer le script de restauration\nbash cgp/restore_patrimoine.sh\n```\n\n### Déchiffrer manuellement\n\n```bash\nage --decrypt -i ~/.age/key.txt patrimoine.json.age \u003e patrimoine.json\n```\n\n---\n\n## 📦 Export de rapports\n\nHTML natif (aucune dépendance supplémentaire) :\n```bash\npython3 cgp/export.py --format html --scope global\n```\n\nPDF — installer weasyprint :\n```bash\npip install weasyprint\n# Ubuntu/Debian : sudo apt-get install libpango-1.0-0 libharfbuzz0b libpangoft2-1.0-0\npython3 cgp/export.py --format pdf\n```\n\nPNG — installer cairosvg :\n```bash\npip install cairosvg\npython3 cgp/export.py --format png --scope dca\n```\n\nDepuis Claude Code (plus simple) :\n```\n/exporting:SKILL --format pdf\n/exporting:SKILL --format png --scope dca\n```\n\n---\n\n*Fait avec ❤️ pour les investisseurs français qui prennent leur patrimoine en main.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffdelbrayelle%2Fcgp-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffdelbrayelle%2Fcgp-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffdelbrayelle%2Fcgp-skills/lists"}