Agent Skill

Apprenez à votre agent IA à utiliser l'API UpInvoice

La skill upinvoice-api donne à un agent IA ce qu'il lui faut pour intégrer l'API sans deviner : authentification, format de requête, règles des champs, gestion des erreurs, nouvelles tentatives sûres et correspondance avec un ERP.

Contenu

  • SKILL.md : quand utiliser l'API, format de requête et de réponse, erreurs et idempotence.
  • references/integration.md : flux recommandé, liste de contrôles, correspondance des champs et rapprochement des tiers et des produits.
  • scripts/upinvoice_extract.py : script en ligne de commande avec nouvelles tentatives, bibliothèque standard uniquement.

Installation

  • Claude Code : ajoutez la marketplace de plugins UpInvoice et installez le plugin, ou décompressez le .zip dans votre dossier de skills (personnel ou du projet).
  • Applications Claude : importez le .zip dans Paramètres, rubrique Capacités, Skills.
  • Autres agents : installez-la avec la CLI skills (npx skills add upinvoice/skills) ou copiez le dossier là où ils chargent leurs skills.
# Claude Code (plugin marketplace)
claude plugin marketplace add upinvoice/skills
claude plugin install upinvoice-api@upinvoice

# Other agents (skills CLI)
npx skills add upinvoice/skills

# Manual install, personal (all projects)
mkdir -p ~/.claude/skills && cd ~/.claude/skills
# or only this project: mkdir -p .claude/skills && cd .claude/skills
curl -sSLO https://upinvoice.eu/downloads/upinvoice-api-skill.zip
unzip upinvoice-api-skill.zip && rm upinvoice-api-skill.zip

export UPINVOICE_API_KEY=...   # https://upinvoice.eu/api/tokens

Clé API

La skill lit la clé dans la variable d'environnement UPINVOICE_API_KEY. Créez-la sur upinvoice.eu/api/tokens et ne la collez jamais dans la conversation.

Demandez ensuite à votre agent quelque chose comme :

Utilise la skill upinvoice-api pour écrire un script qui lit tous les PDF de ./factures et enregistre fournisseur, numéro, date et totaux dans un CSV.