Agent Skill

Teach your AI agent to use the UpInvoice API

The upinvoice-api skill gives an AI agent what it needs to integrate the API without guessing: authentication, request format, field rules, error handling, safe retries and how to map the result to an ERP.

What it contains

  • SKILL.md: when to use the API, request and response format, errors and idempotency.
  • references/integration.md: recommended flow, validation checklist, field mapping and matching of third parties and products.
  • scripts/upinvoice_extract.py: command-line helper with retries, standard library only.

Installation

  • Claude Code: add the UpInvoice plugin marketplace and install the plugin, or unzip the .zip into your skills folder (personal or per project).
  • Claude apps: upload the .zip in Settings, under Capabilities, Skills.
  • Other agents: install it with the skills CLI (npx skills add upinvoice/skills) or copy the folder wherever they load skills from.
# 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

API key

The skill reads the key from the UPINVOICE_API_KEY environment variable. Create one at upinvoice.eu/api/tokens and never paste it into the chat.

Then ask your agent something like:

Use the upinvoice-api skill to write a script that reads every PDF in ./invoices and saves supplier, number, date and totals to a CSV.