<p align="center">
<img src="assets/banner.jpg" alt="Paperasse" width="100%">
</p>
<h1 align="center">Paperasse</h1>
<p align="center">
<b>Des skills pour agents IA spécialisés dans la bureaucratie française.</b>
</p>
<p align="center">
<i>Parce que quelqu'un devait le faire, et ce quelqu'un n'a pas besoin de pause café.</i>
</p>
<p align="center">
<a href="https://github.com/romainsimon/paperasse/stargazers"><img src="https://img.shields.io/github/stars/romainsimon/paperasse" alt="GitHub stars"></a>
<img src="https://img.shields.io/badge/evals-88%25_with_skill_%7C_75%25_without_%7C_%2B13%25_delta-brightgreen" alt="Evals: 88% with skill | 75% without | +13% delta">
<a href="https://github.com/romainsimon/paperasse/blob/master/LICENSE"><img src="https://img.shields.io/github/license/romainsimon/paperasse?style=flat&color=blue" alt="License"></a>
</p>
<br />
---
## Qu'est-ce que Paperasse ?
<b>Paperasse est une collection de skills pour agents IA ([Claude Code](https://claude.com/product/claude-code), [Claude Cowork](https://claude.com/product/cowork), [Codex](https://openai.com/codex/), [Mistral Vibe](https://vibe.mistral.ai), [Cursor](https://cursor.com), [Windsurf](https://windsurf.com), [Cline](https://cline.bot), [Aider](https://aider.chat)) spécialisés dans la comptabilité, la fiscalité, la facturation, le notariat et l'audit des entreprises françaises.</b>
Chaque skill transforme votre agent en copilote expert d'un métier de la paperasse : comptabilité (PCG, TVA, IS, clôture annuelle, FEC, liasse fiscale), facturation (mentions obligatoires, facturation électronique 2026, plateformes agréées, e-reporting), contrôle fiscal, audit CAC, fiscalité des particuliers (IR, IFI, PFU, PEA, AV, LMNP, RSU, BSPCE, crypto, PER), droit notarial (immobilier, succession, donation), et gestion de copropriété (AG, charges, travaux, impayés). Il connaît les textes (CGI, BOFiP, NEP, loi 1965), les formulaires, les échéances, et ne se trompe pas de case dans la liasse fiscale.
Les skills sont du Markdown. Ils fonctionnent avec tout agent ou outil capable de lire des fichiers. Paperasse inclut aussi des connecteurs pour récupérer automatiquement vos transactions bancaires (Qonto) et paiements (Stripe).
---
## Installation rapide
### Option 1 : installation via agentskill.sh (recommandé)
Installe les skills depuis le registre [agentskill.sh](https://agentskill.sh/skillsets/paperasse).
Pas besoin de cloner le repo et permet d'avoir tous les skills maintenus à jour automatiquement via [ags](https://github.com/agentskill-sh/ags) + scan de sécurité, auto-review des skills, etc.
Copiez-collez ces instructions dans votre agent IA :
```
Suis les instructions pour installer le skillset Paperasse depuis https://agentskill.sh/skillsets/paperasse
Lance ensuite le setup pour la gestion de toute ma paperasse
```
### Option 2 : installation via GitHub
Copiez-collez ces instructions dans votre agent IA :
```
Installe tous les skills du repo github https://github.com/romainsimon/paperasse
Lance ensuite le setup pour la gestion de toute ma paperasse
```
L'agent va cloner le repo, installer les skills, et lancer le setup guidé qui vous posera quelques questions (nom de votre société, régime TVA, comptes bancaires) pour configurer votre environnement.
#### Installation manuelle
Si vous n'utilisez ni agentskill.sh ni un clone Git complet, attention aux liens symboliques vers les ressources partagées (`data`, `scripts`, `templates`, `integrations`).
Certains installateurs qui téléchargent les dossiers un par un via l'API GitHub les transforment en petits fichiers texte.
Voir [l'installation manuelle](docs/manual-install.md) pour les commandes Codex et les vérifications.
---
## Les 6 skills
| Skill | Rôle | Ce qu'il fait |
|-------|------|---------------|
| **`comptable`** | Expert-Comptable | Écritures comptables (800+ comptes PCG), TVA, IS/IR, clôture annuelle complète en 12 étapes, FEC, liasse fiscale, PDFs, rapprochement bancaire, facturation (mentions obligatoires, facturation électronique 2026, plateformes agréées, Factur-X, e-reporting) |
| **`controleur-fiscal`** | Contrôleur Fiscal | Simulation de contrôle DGFIP sur 8 axes, chefs de redressement avec base légale et montants |
| **`commissaire-aux-comptes`** | Commissaire aux Comptes | Audit NEP en 7 phases, validation croisée bilan/CR/liasse, opinion motivée |
| **`fiscaliste`** | Fiscaliste Particuliers | Fiscalité personnelle : IR (barème, QF, décote, plafonnement), IFI, PFU vs barème, PEA, assurance-vie, LMNP (micro/réel), RSU/BSPCE/stock-options, crypto (PAMC), PER, quotient revenus exceptionnels, CEHR |
| **`notaire`** | Notaire | Frais de notaire, plus-value immobilière, successions, donations, SCI, PACS, diagnostics, conseil patrimonial |
| **`syndic`** | Syndic de Copropriété | Gestion d'un parc de copropriétés : AG, appels de fonds, comptabilité (décret 2005), travaux, fournisseurs, impayés, transition de syndic |
---
## Exemples d'utilisation
```
> Voici mes transactions bancaires. Catégorise-les et génère les écritures.
> Fais la clôture annuelle de ma société pour l'exercice 2025.
> Simule un contrôle fiscal sur mes comptes 2025.
> Audite mes comptes annuels avant approbation.
> Calcule les frais de notaire pour un appartement à 350 000 EUR à Paris.
> Ma mère est décédée, nous sommes 3 enfants. Calcule les droits de succession.
> Rédige les statuts d'une SCI familiale pour gérer un immeuble locatif.
> Prépare la convocation de l'AG annuelle pour ma copropriété.
> Donne-moi un tableau de bord de toutes mes copropriétés.
> Le copropriétaire du lot 7 n'a pas payé depuis 6 mois. Que faire ?
> Génère une facture conforme pour mon client TechSolutions SAS.
> Suis-je prêt pour la facturation électronique obligatoire 2026 ?
> Quelle plateforme agréée gratuite me recommandes-tu ?
> Je suis célibataire, salaire 50 000 EUR, calcule mon impôt 2025.
> J'ai 5 000 EUR de dividendes. PFU ou barème ?
> Vesting RSU 100 000 EUR cette année : puis-je utiliser le quotient pour revenus exceptionnels ?
> Mon patrimoine immobilier net est de 1,4 M EUR, suis-je redevable de l'IFI ?
```
---
## Workflow : de zéro à la clôture annuelle
Vous pouvez lancer le workflow complet de clôture annuelle en copiant-collant le prompt suivant :
```
Fais la clôture annuelle de ma société
```
Les 4 skills s'enchaînent pour couvrir tout le cycle comptable :
1. **Comptabilité courante** (`comptable`) : classification des dépenses, écritures, TVA, rapprochement bancaire
2. **Clôture annuelle** (`comptable`) : cut-off, amortissements, provisions, IS, FEC, liasse fiscale, PDFs
3. **Audit** (`commissaire-aux-comptes`) : vérification du FEC, contrôle croisé bilan/CR/liasse, opinion
4. **Contrôle fiscal** (`controleur-fiscal`) : simulation DGFIP sur 8 axes, chefs de redressement
---
## Intégrations (Qonto, Stripe)
Des connecteurs pour récupérer automatiquement les transactions bancaires et les paiements. Configuration dans `company.json`, clés API en variables d'environnement.
```bash
npm run fetch # Récupère Qonto + Stripe
npm run fetch:qonto # Qonto seulement
npm run fetch:stripe # Stripe seulement
```
Supporte plusieurs comptes Stripe et Stripe Connect. Voir `integrations/` pour le détail de la configuration.
---
## Scripts et templates
Le repo inclut des scripts Node.js et des templates pour la génération de documents :
```bash
npm run closing # Génère tout d'un coup (états financiers + FEC + PDFs)
```
| Script / Template | Génère |
|-------------------|--------|
| `calc.js` | Calculs déterministes (CCA, amortissements, IS, TVA simplifiée, prorata) |
| `generate-statements.js` | Bilan, Compte de résultat, Balance |
| `generate-fec.js` | FEC 18 colonnes (art. L. 47 A-I LPF) |
| `generate-pdfs.js` | PDFs professionnels avec en-tête société |
| `templates/2065-sd.html` | Formulaire 2065-SD (Déclaration IS) |
| `templates/liasse-fiscale-2033.md` | Liasse fiscale 2033 (brouillon) |
| `templates/approbation-comptes.md` | PV d'approbation des comptes |
| `templates/declaration-confidentialite.html` | Déclaration de confidentialité |
| `templates/depot-greffe-checklist.md` | Checklist dépôt au greffe |
Prérequis : `npm install`, puis `cp company.example.json company.json` et remplir vos informations.
---
## Garde-fous
- **Contexte entreprise** : chaque skill vérifie les informations minimales (raison sociale, SIREN, forme juridique, régime TVA) avant de procéder. Si `company.json` existe, il est lu automatiquement. Sinon, le skill pose les questions.
- **Échéances fiscales** : le skill comptable affiche les prochaines échéances à chaque conversation (acomptes IS, TVA, etc.).
- **Fraîcheur des données** : chaque skill a une date `last_updated`. S'il a plus de 6 mois, l'agent vérifie les chiffres en ligne avant de répondre. Le législateur français change les règles plus souvent que vous changez de mot de passe. Contrairement à votre mot de passe, ça peut coûter cher.
- **Données open source** : PCG complet et nomenclature de la liasse fiscale issus de [data.gouv.fr](https://www.data.gouv.fr). APIs publiques pour le BOFiP et l'annuaire des entreprises (Sirene). Sources documentées dans `data/sources.json`.
---
## Installation manuelle (par plateforme)
Les skills sont du Markdown. Ils marchent partout où un agent peut lire des fichiers.
| Plateforme | Où copier les skills |
|------------|---------------------|
| **Claude Code** | `~/.claude/skills/` |
| **Cursor** | `~/.cursor/skills/` |
| **Windsurf** | `~/.windsurf/skills/` |
| **Codex** | `~/.codex/skills/` |
| **Mistral Vibe** | `~/.vibe/skills/` |
| **Cline** | `~/.cline/skills/` |
| **Aider** | `~/.aider/skills/` |
### Claude Desktop / claude.ai
Claude Desktop et claude.ai supportent les skills via upload :
1. Activer la capacité : Réglages → Capabilities → activer **Code execution and file creation** (sans ça, l'upload échoue).
2. Puis : Customize → Skills → uploader un `.zip` dont le dossier racine contient un `SKILL.md`.
**Limite importante** : certains skills partagent des ressources via des liens symboliques : comptable (`data/`, `scripts/`, `templates/`, `integrations/`), controleur-fiscal et commissaire-aux-comptes (`data/`), notaire (`scripts/`). Un zip d'un seul dossier de skill casse ces liens et le skill ne trouve plus ses ressources. Pour ces skills, préférer [agentskill.sh](https://agentskill.sh) ou un clone Git complet utilisé avec Claude Code. Les skills autonomes (fiscaliste, syndic) s'uploadent sans problème.
---
## Evals
Chaque skill est évalué automatiquement avec et sans le SKILL.md pour mesurer sa valeur ajoutée. Le runner utilise `claude --bare` en isolation, un grading LLM-as-judge, une exécution parallèle (~20 min pour la suite complète), et un cache adressé par contenu pour réutiliser les runs inchangés d'une itération à l'autre.
```bash
# Lancer les evals
uv run --project evals python evals/run_evals.py
# Un seul skill
uv run --project evals python evals/run_evals.py --skill notaire
# Réutiliser le cache inter-itérations
uv run --project evals python evals/run_evals.py --reuse-cache
# Ne lancer que les skills impactés par la branche courante
uv run --project evals python evals/run_evals.py --changed-only --reuse-cache
# Voir les résultats dans le navigateur
python evals/generate_review.py evals-workspace/iteration-xxx/
```
Pour les PRs, un workflow GitHub Actions `Evals Smoke` résout les skills impactés par rapport à la branche de base, restaure le cache `evals-workspace/cache`, et exécute uniquement la sélection nécessaire.
**Derniers résultats** (claude-sonnet-4-6, grading haiku) :
| Skill | With Skill | Without Skill | Delta |
|-------|-----------|--------------|-------|
| commissaire-aux-comptes | 100% | 75% | **+25%** |
| notaire | 96% | 92% | +4% |
| controleur-fiscal | 91% | 87% | +4% |
| comptable | 89% | 77% | **+12%** |
| fiscaliste | 84% | 64% | **+20%** |
| syndic | 83% | 68% | **+16%** |
| **Aggregate** | **88%** | **75%** | **+13%** |
Le format `evals.json` est compatible avec le [framework officiel anthropics/skills](https://github.com/anthropics/skills/tree/main/skills/skill-creator).
---
## Avertissement légal
**Ces skills ne remplacent pas un expert-comptable inscrit à l'Ordre, un commissaire aux comptes certifié, ou un notaire en exercice.** Ils sont conçus comme outils d'aide à la décision et de préparation.
Pour les situations complexes (litiges, montages fiscaux, contrôles en cours), consultez un professionnel avec une assurance RC Pro et un numéro SIRET.
---
## Contribuer
Vous avez un métier de la paperasse que vous aimeriez voir automatisé ? Consultez le [guide de contribution](CONTRIBUTING.md).
### Forks communautaires
Des forks par juridiction maintenus par la communauté :
- 🇹🇳 [**paperasse-tn**](https://github.com/YassineAta/paperasse-tn) (Tunisie) — skills pour la paperasse tunisienne (IRPP, BCT/forex, RNE/NAT, SUARL). Trois skills : `mo7aseb`, `bct-shield`, `3adel-ichhad`.
- 🇧🇪 [**paperasse-be**](https://github.com/Atelya-be/paperasse-be) (Belgique) : 16 skills adaptés au droit belge, FR/NL/DE/EN, avec table de correspondance FR/BE par skill. Maintenu par [Atelya](https://atelya.be).
Ces forks ne sont **pas maintenus par paperasse** : la fraîcheur des références fiscales et juridiques est de la responsabilité de leurs auteurs. Ouvrez une issue ici si vous voulez ajouter votre fork à cette liste.
---
## Sponsors
Paperasse est maintenu en open source grâce au soutien de ses sponsors. [Devenir sponsor](https://github.com/sponsors/romainsimon).
### Founding Sponsors
<p align="center"><!-- sponsors-founding --><sub>Become the first <a href="https://github.com/sponsors/romainsimon">Founding Sponsor</a>.</sub><!-- sponsors-founding --></p>
### Premier Sponsors
<p align="center"><!-- sponsors-premier --><sub>Become the first <a href="https://github.com/sponsors/romainsimon">Premier Sponsor</a>.</sub><!-- sponsors-premier --></p>
### Sponsors
<p align="center"><!-- sponsors-sponsor --><sub>Become the first <a href="https://github.com/sponsors/romainsimon">Sponsor</a>.</sub><!-- sponsors-sponsor --></p>
### Backers
<p align="center"><!-- sponsors-backer --><sub>Become the first <a href="https://github.com/sponsors/romainsimon">Backer</a>.</sub><!-- sponsors-backer --></p>
### Supporters
<p align="center"><!-- sponsors-supporter --><sub>Become the first <a href="https://github.com/sponsors/romainsimon">Supporter</a>.</sub><!-- sponsors-supporter --></p>
---
## Remerciements
- **L'administration française** — Pour avoir créé un système si complexe qu'il nécessite une IA pour le comprendre
- **Le Plan Comptable Général** — 800 comptes, vraiment ?
- **Le Code Général des Impôts** — 2 000 articles, et ils en rajoutent chaque année
- **La CNCC** — Pour les NEP, ces documents que personne ne lit mais que tout le monde cite
- **data.gouv.fr** — Pour les données ouvertes qui alimentent les skills
---
<p align="center">
<i>La paperasse, c'est comme le cholestérol : y'en a du bon et du mauvais, mais surtout y'en a trop.</i>
<br>
— Personne de célèbre, jamais
</p>
---
## Star History
<a href="https://www.star-history.com/?repos=romainsimon%2Fpaperasse&type=date&legend=bottom-right">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=romainsimon/paperasse&type=date&theme=dark&legend=bottom-right&sealed_token=OoDhXCZ4ONGXq4Zzx29kypQyE44toKKfYUlyyMBR6Eir979s5GZtkS1cu90g8EcIaw6VP9tSjC0Wdkoc_-GIkMW7m8CwIwWdOMzW6RK2Moe1nVn10UDO9A" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=romainsimon/paperasse&type=date&legend=bottom-right&sealed_token=OoDhXCZ4ONGXq4Zzx29kypQyE44toKKfYUlyyMBR6Eir979s5GZtkS1cu90g8EcIaw6VP9tSjC0Wdkoc_-GIkMW7m8CwIwWdOMzW6RK2Moe1nVn10UDO9A" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=romainsimon/paperasse&type=date&legend=bottom-right&sealed_token=OoDhXCZ4ONGXq4Zzx29kypQyE44toKKfYUlyyMBR6Eir979s5GZtkS1cu90g8EcIaw6VP9tSjC0Wdkoc_-GIkMW7m8CwIwWdOMzW6RK2Moe1nVn10UDO9A" />
</picture>
</a>
---
<p align="center">
Fait avec des 🥐 et beaucoup de ☕ quelque part en France | <a href="LICENSE">Licence MIT</a>
</p>