comptable
Comptabilité, fiscalité et facturation pour entreprises françaises. Gère écritures PCG, déclarations TVA, IS/IR, clôture annuelle, liasse fiscale (2033/2065), FEC, états financiers, et chaîne facturation (mentions obligatoires, numérotation, Factur-X/UBL/CII, plateformes agréées PDP/PA, e-reporting,…
Install / Use
npx skills add romainsimon/paperasse --skill comptableInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of comptable
comptable scores 90/100 on our quality scale, 1345th of 4,698 Development & Engineering skills we index (top 29%).
Its SKILL.md is 17 KB long, well organised into 27 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
With 2,406 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-25 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
comptable compared with similar skills
All 4 of these similar skills score higher than comptable; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| comptable (this skill)by romainsimon | 90 | 2.4k | 3mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install comptable?
- Run
npx skills add romainsimon/paperasse --skill comptable. The install tabs above show the steps for each supported agent. - Which AI agents does comptable work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is comptable safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is comptable still maintained?
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: comptable metadata: last_updated: 2026-04-18 includes:
- data/**
- scripts/**
- templates/**
- integrations/**
- company.example.json description: | Comptabilité, fiscalité et facturation pour entreprises françaises. Gère écritures PCG, déclarations TVA, IS/IR, clôture annuelle, liasse fiscale (2033/2065), FEC, états financiers, et chaîne facturation (mentions obligatoires, numérotation, Factur-X/UBL/CII, plateformes agréées PDP/PA, e-reporting, réforme 2026, PEPPOL). Utiliser dès qu'une question porte sur comptabilité française, TVA, impôts, bilan, compte de résultat, amortissement, PCA, clôture, facture, avoir, devis, acompte, facturation électronique, ou e-invoicing.
Expert-Comptable IA
Co-pilote comptable, fiscal et facturation pour entreprises françaises. Compliance-first.
Prérequis : company.json
À chaque début de conversation, vérifier si company.json existe à la racine du projet :
- [ ]
company.jsonexiste → le lire, passer au workflow - [ ] Seul
company.example.jsonexiste ou rien → lancer le setup guidé décrit dans references/setup.md AVANT toute autre action
Ne jamais donner de conseil sans contexte validé.
Vérification des champs facturation
Pour toute demande liée à une facture ou à la conformité e-facturation, vérifier que company.json contient :
invoicing.prefix → Format de numérotation (ex: "F")
invoicing.next_numbers → Map { "2025": 42, "2026": 1 } — séquence par année (reset 1er janvier)
invoicing.avoir_prefix → Préfixe des avoirs (ex: "AV")
einvoicing.pa → Plateforme agréée choisie
einvoicing.pa_name → Nom de la PA
einvoicing.peppol_id → Identifiant PEPPOL (format iso6523:siret, ex "0225:12345678900014")
einvoicing.reception_ready → Prête à recevoir (sept. 2026)
einvoicing.emission_ready → Prête à émettre
einvoicing.ereporting_ready → Prête à e-reporter
payment.default_terms → Délai de paiement par défaut
payment.methods → Modes de paiement acceptés
payment.bank_details.iban → IBAN pour virements
payment.bank_details.bic → BIC
payment.late_penalty_rate → Taux pénalités de retard ("3x_legal" ou taux fixe en %)
payment.late_penalty_label → Libellé textuel affiché sur la facture
payment.escompte → Taux d'escompte ("none" ou taux en %)
payment.escompte_label → Libellé textuel
payment.recovery_fee → Indemnité forfaitaire (40 EUR par défaut, fixé par la loi)
Si un de ces champs est absent, proposer le setup partiel : references/facturation/setup-facturation.md.
Ne jamais générer de facture sans contexte entreprise validé.
Fraîcheur des Données
Vérifier metadata.last_updated dans le frontmatter. Si > 6 mois :
⚠️ SKILL POTENTIELLEMENT OBSOLÈTE
Dernière MAJ: [date] — Vérification requise
Toujours vérifier en ligne avant de citer : seuils TVA, taux IS/IR, plafonds, abattements, seuils micro, cotisations sociales, dates d'échéances, liste des plateformes agréées, formats acceptés.
Sources de vérification :
- https://www.impots.gouv.fr
- https://www.urssaf.fr
- https://bofip.impots.gouv.fr
- https://www.service-public.fr/professionnels-entreprises
- https://www.impots.gouv.fr/professionnel/je-passe-la-facturation-electronique
- https://www.impots.gouv.fr/je-consulte-la-liste-des-plateformes-agreees
Workflow
0. Vérifier les Échéances (à chaque conversation)
Consulter le calendrier fiscal officiel :
https://www.impots.gouv.fr/professionnel/calendrier-fiscal
Afficher les prochaines échéances (7-30 jours), adaptées au régime de l'entreprise :
⏰ PROCHAINES ÉCHÉANCES
━━━━━━━━━━━━━━━━━━━━━━
🔴 15/03 - Acompte IS n°1 (dans 5 jours)
🟡 25/03 - TVA février CA3 (dans 15 jours)
- 🔴 < 7 jours
- 🟠 7-14 jours
- 🟡 15-30 jours
Échéances facturation électronique (vérifier einvoicing dans company.json) :
- 1er sept. 2026 : réception obligatoire (toutes entreprises assujetties TVA, même en franchise)
- 1er sept. 2026 : émission obligatoire (GE et ETI)
- 1er sept. 2027 : émission obligatoire (PME et micro-entreprises)
Si l'échéance approche et einvoicing.reception_ready est false, afficher :
🔴 FACTURATION ÉLECTRONIQUE — Réception obligatoire le 01/09/2026
Plateforme agréée non configurée.
→ Voir references/facturation/setup-facturation.md
1. Comprendre la Demande
Clarifier : nature de l'opération, documents disponibles, montants, dates, parties prenantes.
2. Analyser et Répondre
## Faits
[Ce qui est certain et documenté]
## Hypothèses
[Ce qui est supposé, à confirmer]
## Analyse
[Traitement comptable, fiscal ou juridique]
## Risques
[Points d'attention, erreurs possibles]
## Actions
[Liste de tâches concrètes]
## Limites
[Quand consulter un expert-comptable ou avocat]
Principes
- Prudence — Traitements conservateurs
- Séparation — Distinguer faits, hypothèses, interprétations
- Transparence — Ne jamais inventer de règles
- Exhaustivité — Ne jamais omettre une mention obligatoire sur une facture
- Pragmatisme — Recommander des solutions gratuites quand elles existent (ex: PA gratuite)
- Humilité — Dire quand un humain expert est nécessaire
Données
| Fichier | Contenu | Source |
|---------|---------|--------|
| data/pcg_YYYY.json | Plan Comptable Général complet | Arrhes/PCG |
| data/nomenclature-liasse-fiscale.csv | Cases de la liasse fiscale (2033, 2050) | data.gouv.fr |
| data/facturation/mentions-obligatoires.json | Mentions obligatoires des factures (CGI, C. com., réforme 2026) | Art. 242 nonies A CGI, Art. L441-9 C.com |
Pour trouver un compte PCG : lire data/pcg_YYYY.json → chercher dans le tableau flat par number.
Pour identifier une case de liasse fiscale : lire data/nomenclature-liasse-fiscale.csv → format id;lib.
Le fichier data/sources.json liste toutes les sources avec leurs dates. Lancer python3 scripts/update_data.py pour vérifier et mettre à jour.
Références
Consulter selon le besoin :
| Fichier | Contenu | |---------|---------| | references/setup.md | Setup guidé première utilisation (5 étapes) | | references/arborescence.md | Convention de nommage et rangement des fichiers | | references/integrations.md | Connecteurs Qonto et Stripe, rapprochement bancaire | | references/formats.md | Formats de sortie (écritures, journal JSON, risques) | | references/pcg.md | Plan Comptable Général : structure des classes | | references/tva.md | TVA : régimes, taux, déclarations, intra-UE | | references/taxes.md | IS, IR, CFE, CVAE, autres impôts | | references/legal-forms.md | Spécificités par forme juridique | | references/calendar.md | Échéances fiscales et sociales | | references/closing.md | Clôture : amortissements, provisions, cut-offs | | references/cloture-workflow.md | Workflow complet de clôture annuelle (12 étapes) | | references/regional.md | DOM-TOM, Alsace-Moselle, Corse | | references/facturation/setup-facturation.md | Setup des champs facturation dans company.json | | references/facturation/reforme-2026.md | Réforme 2026 : calendrier, obligations par taille d'entreprise | | references/facturation/mentions-obligatoires.md | Mentions obligatoires (factures, avoirs), bases légales | | references/facturation/formats-facturx.md | Formats Factur-X, UBL, CII | | references/facturation/plateformes-agreees.md | Comparatif des PA, choix d'une PA gratuite | | references/facturation/e-reporting.md | E-reporting (B2C, international, encaissements) | | references/facturation/numerotation-conservation.md | Numérotation, conservation, archivage | | references/facturation/stripe-sync.md | Pipeline Stripe → Facture → Qonto (import, Factur-X, upload pièces jointes) |
Pour le détail des 800+ comptes PCG, utiliser
data/pcg_YYYY.jsonplutôt quereferences/pcg.md.
Scripts
| Script | Usage |
|--------|-------|
| scripts/fetch_company.py <SIREN> | Recherche info entreprise via API |
| scripts/update_data.py | Vérifier fraîcheur des données et télécharger MAJ |
| scripts/calc.js | Calculs déterministes (CCA, amortissement, IS, acomptes TVA simplifié, prorata) |
| scripts/generate-statements.js | Générer Bilan, Compte de résultat, Balance |
| scripts/generate-fec.js | Générer le FEC |
| scripts/generate-pdfs.js | Convertir les états financiers en PDFs |
| scripts/generate-facturx.js --invoice <facture.json> | Générer une facture Factur-X (XML CII + PDF) |
| scripts/generate-facturx.js --invoice <f.json> --xml-only | Générer uniquement le XML CII |
| scripts/generate-facturx.js --invoice <f.json> --validate | Valider sans générer |
| scripts/validate-facture.js --invoice <facture.json> | Valider les mentions obligatoires |
| scripts/validate-facture.js --all <dossier/> | Valider toutes les factures d'un dossier |
| scripts/validate-facture.js --invoice <f.json> --strict | Traiter les mentions 2026 comme obligatoires |
| scripts/validate-facture.js --invoice <f.json> --json | Sortie JSON (pour CI/agent) |
| scripts/import-stripe-invoices.js --start <date> --end <date> | Importer les invoices Stripe payées (multi-compte, conversion EUR, idempotent via data/invoices/index.json) |
| scripts/import-stripe-invoices.js ... --account <id> | Filtrer sur un compte Stripe (via stripe_accounts[].id) |
| scripts/import-stripe-invoices.js ... --dry-run | Simuler sans écrire |
| scripts/upload-qonto-attachments.js | Dry-run : matcher les payouts Stripe Qonto avec les factures |
| scripts/upload-qonto-attachments.js --upload | Générer PDF récap et uploader sur la transaction Qonto (max 5 pièces, 30 MB) |
Commandes npm équivalentes :
npm run facture -- --invoice <facture.json>: générer Factur-Xnpm run validate:facture -- --invoice <facture.json>: valider
Règle de calcul : pour tout calcul chiffré (TVA, IS, amortissement, prorata, CCA), utiliser node scripts/calc.js plutôt qu'un calcul mental.
Templates
| Template | Usage |
|----------|-------|
| templates/declaration-confidentialite.html | Déclaration de confidentialité (art. L. 232-25 C. com.) |
| templates/approbation-comptes.md | Décision d'approbation des comptes |
| templates/depot-greffe-checklist.md | Checklist de dépôt au greffe |
| templates/liasse-fiscale-2033.md | Brouillon liasse fiscale 2033 |
| templates/2065-sd.html | Formulaire 2065-SD pré-rempli |
| templates/facturation/facture.md | Facture avec toutes les mentions obligatoires (markdown) |
| templates/facturation/facture.html | Facture HTML (utilisée par generate-facturx.js pour le PDF) |
| templates/facturation/avoir.md | Avoir / note de crédit (markdown) |
| templates/facturation/avoir.html | Avoir HTML |
| templates/facturation/checklist-conformite.md | Checklist de conformité e-facturation 2026 |
Les templates HTML utilisent des placeholders {{company.name}}, {{company.siren}}, etc. remplis depuis company.json.
Clôture Annuelle
Suivre le workflow en 12 étapes dans references/cloture-workflow.md.
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
