Tutoriel · Installation pas à pas

Installez Skill Compta en vingt minutes.

Skill Compta est un outil gratuit et open source que j'ai créé. Il branche Claude (l'IA d'Anthropic) sur votre comptabilité Pennylane : il calcule la TVA et l'impôt, prépare le FEC et les écritures, affiche vos échéances et contrôle la cohérence de vos comptes, toujours sous votre validation. Ce guide vous montre comment l'installer et le tester vous-même. Comptez vingt minutes, aucune compétence de développeur requise.

Master 2 CCA4 ans en contrôle de gestion (TotalEnergies, puis PME)auteur de Skill Compta

Calculs déterministes · PCG officiel 838 comptes · 107 tests + 11 evals (intégration continue) · open source et gratuit.

Étape 1

Ce qu'il vous faut.

À installer une seule fois. Tout est gratuit.

  • Claude Code : l'application de Claude qui exécute le skill. L'obtenir.
  • Un compte Pennylane : inscription gratuite sur pennylane.com.
  • Trois petits programmes : Python, jq et curl (la commande ci-dessous les installe d'un coup).

Sur Mac, collez ceci dans le Terminal :

brew install jq python3

Sur Linux : sudo apt-get install jq python3 python3-pip curl. Sur Windows : installez Python et jq, puis travaillez dans Git Bash.

Étape 2

Installer le skill.

Trois lignes à coller dans le Terminal, dans l'ordre.

  1. Télécharger le projet.

    git clone https://github.com/paulcoindeau4-web/Skill-Compta-Paul-Coindeau.git
  2. Copier le skill dans Claude Code.

    mkdir -p ~/.claude/skills/pennylane && cp -R Skill-Compta-Paul-Coindeau/skills/pennylane/* ~/.claude/skills/pennylane/
  3. Vérifier que tout marche.

    python3 Skill-Compta-Paul-Coindeau/tests/test_calc.py

    Vous devez voir s'afficher :

    OK — 57 tests passés ✅

    C'est le module de calcul (57 tests). Au-delà, le projet compte 107 tests et 11 evals (intégration continue, Python 3.10 → 3.13) et embarque des garde-fous comptables : refus d'une écriture déséquilibrée, d'une saisie sur exercice clôturé ou d'un compte hors PCG.

Étape 3

Connecter Pennylane.

Le skill se connecte à Pennylane avec une clé API. Pas de logiciel intermédiaire, pas de « serveur MCP » à installer : la clé suffit.

  1. Dans Pennylane, allez dans Paramètres › Connectivité › Développeurs, puis cliquez sur Générer un token API (permissions lecture + écriture).

  2. Commencez en mode test (sandbox). Dans votre profil Pennylane, activez l'« environnement de test » et générez une clé dédiée : vos vraies données ne bougent pas.

  3. Collez votre clé dans le Terminal (remplacez par la vôtre) :

    export PENNYLANE_API_KEY=pl_sandbox_votre_cle_ici

    Pour ne pas la retaper à chaque fois, ajoutez-la à votre fichier shell : echo 'export PENNYLANE_API_KEY=pl_sandbox_votre_cle_ici' >> ~/.zshrc

Étape 4

Votre premier test.

Ouvrez Claude Code et tapez la commande du skill :

/pennylane

Le skill affiche vos échéances et confirme la connexion :

$ /pennylane

⏰ Prochaines échéances (dossier DEMO-001)
🔴 dans 4 j   — 15/06/2026 — Acompte IS n°2 (2 125 €)
🟠 dans 13 j  — 24/06/2026 — TVA CA3 mai

✓ API Pennylane connectée
✓ Environnement : sandbox
✓ Fraîcheur : tout dans les clous

Que souhaitez-vous traiter ?

Donnez-lui maintenant une tâche que les automatisations classiques ne savent pas faire : lire un document et en proposer les écritures. Joignez un contrat et demandez :

Lis ce contrat de crédit-bail et prépare l'écriture de la redevance de juin.

Claude lit le contrat et prépare l'écriture (montants vérifiés par le calculateur déterministe). Il peut aussi pointer un engagement à mentionner en annexe, à confirmer de votre côté :

J'ai lu le contrat : redevance 450 € HT/mois,
TVA 20 %, durée 48 mois, option d'achat 1 200 €.

## Écriture — redevance de juin
612200  Crédit-bail mobilier      450,00
445660  TVA déductible / B&S       90,00
   512000  Banque                        540,00

## À mentionner en annexe
Engagement de crédit-bail — redevances restant
à courir : 42 × 450 € = 18 900 €.

## À vérifier avant de valider
Le rapprochement avec le relevé bancaire de juin.

Claude lit le contrat et propose l'écriture ; les montants sont vérifiés par le calculateur, la validation reste la vôtre. Si vous obtenez ce type de réponse, l'outil fonctionne.

Au-delà de l'écriture, le skill conduit aussi la révision des comptes et produit de vrais livrables internes au cabinet : note de révision, points de différence, synthèse de contrôle TVA (cadre NP 2300 du CNOEC).

Étape 5

Avant de passer à vos vrais dossiers.

Tant que vous êtes en mode test, vous ne risquez rien. Avant d'utiliser une vraie clé (pl_live_…), lisez ceci.

Ce que l'outil ne fait pas.

  • Il prépare, structure et propose : l'écriture, la note de révision, le contrôle TVA. Il ne signe rien et n'envoie rien à l'administration sans votre validation.
  • La responsabilité du résultat reste la vôtre (ou celle de votre expert-comptable). Vous gardez la main, la relecture et la signature.
  • Le cadre légal de la profession s'applique pleinement (Ordonnance n° 45-2138). Je le respecte : je forme et j'accompagne, je ne tiens pas vos comptes à votre place.
  • Vos données passent par Claude lorsqu'il est utilisé en ligne ; pour des données sensibles, les recommandations de confidentialité sont dans le document ci-dessous.

L'outil fait gagner du temps sans sortir du cadre de la profession. Détails complets dans le document DISCLAIMER.md.

Après l'installation

L'installation est la partie simple.

Vous venez de le faire seul, en vingt minutes. Déployer l'outil dans un cabinet est un autre travail : le faire utiliser par toute l'équipe, sur les vrais dossiers, et le faire tenir dans le temps.

M'écrire

paulcoindeau@proton.me

Interventions en France et à l'international

Réponse sous 48 heures

Ou m'appeler

+33 6 38 62 86 92

Du lundi au samedi, de 8h à 20h