romainsimon/paperasse

Paperasse

Des skills pour agents IA spécialisés dans la bureaucratie française.

Parce que quelqu’un devait le faire, et ce quelqu’un n’a pas besoin de pause café.

---

Qu’est-ce que Paperasse ?

Paperasse est une collection de skills pour agents IA (Claude Code, Claude Cowork, Codex, Mistral Vibe, Cursor, Windsurf, Cline, Aider) spécialisés dans la comptabilité, la fiscalité, la facturation, le notariat et l’audit des entreprises françaises.

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. Pas besoin de cloner le repo et permet d’avoir tous les skills maintenus à jour automatiquement via 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 pour les commandes Codex et les vérifications.

---

Les 6 skills

---

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.

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 :

npm run closing    # Génère tout d'un coup (états financiers + FEC + PDFs)

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. 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.

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 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.

# 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) :

Le format evals.json est compatible avec le framework officiel anthropics/skills.

---

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.

Forks communautaires

Des forks par juridiction maintenus par la communauté :

• 🇹🇳 paperasse-tn (Tunisie) — skills pour la paperasse tunisienne (IRPP, BCT/forex, RNE/NAT, SUARL). Trois skills : mo7aseb, bct-shield, 3adel-ichhad.
• 🇧🇪 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.

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.

Founding Sponsors

Become the first Founding Sponsor.

Premier Sponsors

Become the first Premier Sponsor.

Sponsors

Become the first Sponsor.

Backers

Become the first Backer.

Supporters

Become the first Supporter.

---

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

---

La paperasse, c’est comme le cholestérol : y’en a du bon et du mauvais, mais surtout y’en a trop.

— Personne de célèbre, jamais

---

---

Fait avec des 🥐 et beaucoup de ☕ quelque part en France | Licence MIT