<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-84%25_with_skill_%7C_65%25_without_%7C_%2B19%25_delta-brightgreen" alt="Evals: 84% with skill | 65% without | +19% 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), [ChatGPT](https://chatgpt.com), [Codex](https://openai.com/codex/), [Grok Bot](https://x.ai/bot), [GitHub Copilot](https://github.com/features/copilot), [Gemini CLI](https://geminicli.com), [Mistral Vibe](https://vibe.mistral.ai), [Cursor](https://cursor.com), [Windsurf](https://windsurf.com), [Cline](https://cline.bot), [Aider](https://aider.chat), [Hermes Agent](https://hermes-agent.nousresearch.com)) 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
Chaque dossier de skill est autonome : il contient ses données, scripts et templates. Copier un dossier suffit. Voir [l'installation manuelle](docs/manual-install.md) pour les commandes Codex.
### Option 3 : Claude Code et Claude Cowork (marketplace de plugins)
Le dépôt est aussi une marketplace de plugins Claude. Le plugin `paperasse` installe les six skills d'un coup : `comptable`, `fiscaliste`, `notaire`, `controleur-fiscal`, `commissaire-aux-comptes`, `syndic`. Chaque skill ne se charge que lorsque votre question le concerne.
**Claude Code** (2.1.275 ou plus récent) :
```
/plugin install paperasse --marketplace romainsimon/paperasse
```
Avec une version plus ancienne :
```
/plugin marketplace add romainsimon/paperasse
/plugin install paperasse@paperasse
```
**Claude Cowork** : dans Plugins, choisir **Add marketplace**, saisir `romainsimon/paperasse`, puis cliquer sur **Install** sur le plugin `paperasse`.
### Option 4 : Grok Bot, installation en un clic
Chaque skill existe en template [Grok Bot](https://x.ai/bot) prêt à l'emploi. Ouvrez le lien, puis cliquez sur **Add to Grok Bot** :
| Skill | Template Grok Bot |
|-------|-------------------|
| Comptable | [Paperasse · Expert-Comptable](https://x.ai/bot/MmwMdZ7OVKXIKBUfc1dE5) |
| Fiscaliste | [Paperasse · Fiscaliste Particuliers](https://x.ai/bot/GNroMbol-LOahbXzb8Ovw) |
| Notaire | [Paperasse · Notaire](https://x.ai/bot/-H7Vc-5QDpqqEbF1PqLxy) |
| Contrôleur fiscal | [Paperasse · Contrôleur Fiscal](https://x.ai/bot/rGTJjgN2hrX5vJvM4wfis) |
| Commissaire aux comptes | [Paperasse · Commissaire aux Comptes](https://x.ai/bot/_zuqAPpyDT_WV2zpSvPxK) |
| Syndic de copropriété | [Paperasse · Syndic de Copropriété](https://x.ai/bot/F1uQVa6SA7p-8YbhGL_y0) |
---
## 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, Pennylane)
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
npm run fetch:pennylane # Transactions bancaires Pennylane seulement
```
Supporte plusieurs comptes Stripe, Stripe Connect et les transactions bancaires Pennylane. 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`.
---
## Données et services externes
Paperasse n'a pas de serveur : rien n'est envoyé à Paperasse, rien n'est conservé par Paperasse. Voir la [politique de confidentialité (Privacy)](PRIVACY.md). Les skills et scripts tournent chez vous, dans votre agent.
**Données lues et stockées localement** : le contexte de l'entreprise (`company.json` : raison sociale, SIREN, adresse, coordonnées bancaires), le foyer fiscal (`foyer.json`), les relevés bancaires, les factures et le FEC que vous fournissez. Les scripts écrivent leurs résultats sur votre machine (`data/transactions/`, `data/invoices/`, `output/`).
**Services tiers appelés par les scripts**, uniquement quand vous lancez la commande concernée :
| Service | Script | Données envoyées |
|---------|--------|------------------|
| Qonto (`thirdparty.qonto.com`) | `integrations/qonto`, `upload-qonto-attachments.js` | Votre clé API ; envoi de justificatifs seulement si vous lancez l'upload |
| Stripe (`api.stripe.com`) | `integrations/stripe`, `import-stripe-invoices.js` | Votre clé API |
| Pennylane (`app.pennylane.com`) | `integrations/pennylane` | Votre jeton API |
| Base adresse nationale (`api-adresse.data.gouv.fr`) | `fetch_notaire_data.py` | Adresse recherchée |
| IGN API Carto (`apicarto.ign.fr`) | `fetch_notaire_data.py` | Code INSEE, parcelle, coordonnées |
| Géorisques (`georisques.gouv.fr`) | `fetch_notaire_data.py` | Coordonnées du bien |
| DVF, Cerema (`apidf-preprod.cerema.fr`) | `fetch_notaire_data.py` | Code INSEE |
| Recherche d'entreprises (`recherche-entreprises.api.gouv.fr`) | `fetch_company.py`, `fetch_notaire_data.py` | SIREN ou nom de l'entreprise |
| Fichier des décès, matchID (`deces.matchid.io`) | `fetch_notaire_data.py` | Nom, prénom et date de naissance recherchés |
Les connecteurs Qonto, Stripe et Pennylane sont désactivés par défaut et utilisent vos propres clés. Enfin, ce que l'agent envoie au modèle d'IA dépend de l'agent que vous utilisez, pas de Paperasse.
## 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/` |
| **GitHub Copilot** | `~/.copilot/skills/` |
| **Gemini CLI** | `~/.gemini/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`.
Chaque dossier de skill est autonome (données, scripts et templates inclus) : un zip d'un seul dossier fonctionne pour les six skills.
### ChatGPT
ChatGPT accepte l'upload d'un skill sur les offres Business, Enterprise, Healthcare et Edu, selon les réglages de l'espace de travail ([aide OpenAI](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)). Comme pour Claude, chaque dossier de skill s'uploade seul.
---
## 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** (4 novembre 2026, 70 scénarios, un passage par scénario, claude-sonnet-4-6, grading haiku) :
| Skill | With Skill | Without Skill | Delta |
|-------|-----------|--------------|-------|
| commissaire-aux-comptes | 100% | 69% | **+31%** |
| fiscaliste | 87% | 59% | **+29%** |
| comptable | 88% | 66% | **+22%** |
| syndic | 76% | 64% | **+12%** |
| notaire | 82% | 79% | +3% |
| controleur-fiscal | 66% | 73% | -7% |
| **Aggregate** | **84%** | **65%** | **+19%** |
Le jeu d'evals a beaucoup grossi depuis avril (scénarios plus difficiles, sans skill comme avec) : les chiffres ne se comparent pas directement aux résultats précédents. `controleur-fiscal` passe sous la baseline sur ce passage (un scénario en timeout, un autre à 3/7) et fait l'objet d'un travail de suivi.
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).
### Premier Sponsors · 500 $ / mois
<p align="center"><!-- sponsors-premier --><sub>Become the first <a href="https://github.com/sponsors/romainsimon">Premier Sponsor</a>.</sub><!-- sponsors-premier --></p>
### Sponsors · 100 $ / mois
<p align="center"><!-- sponsors-sponsor --><sub>Become the first <a href="https://github.com/sponsors/romainsimon">Sponsor</a>.</sub><!-- sponsors-sponsor --></p>
### Supporters · 5 $ / mois
<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>