Agent skills
Skills are packaged instructions (MIT) that teach a coding agent or assistant how to use Open Factura: what to ask, what to validate, and when to ask for confirmation. They are distributed through skills.sh.
npx skills add xaviigna/openfactura # all fournpx skills add xaviigna/openfactura --skill openfactura-facturar # just one| Skill | What it teaches |
|---|---|
openfactura-conectar |
Connecting the MCP or the CLI, choosing an of_test_/of_live_ key and minimum permissions |
openfactura-facturar |
Validating, confirming, and issuing; which DTE type applies; VAT in prices; returns |
openfactura-errores |
What to do with each error code, contingency, uncertain issuance, and invalidation deadlines |
openfactura-webhooks |
Configuring webhooks, implementing the endpoint that receives them, and verifying the signature |
Rules the agents follow
Section titled “Rules the agents follow”- Validate before issuing and fix every problem.
- Confirm the summary with you (type, recipient, lines, total, and environment) before issuing.
- Don’t calculate taxes: show the total Open Factura returns.
- One
idempotencyKeyper attempt, reused on retries. - Don’t guess tax details: look them up in saved customers (in production) or ask.
- Branch on the error’s
code, never on the message text.
The skills work together with the MCP server or the CLI.
For AI assistants: llms.txt ·llms-full.txt ·every page as Markdown by adding .md to its path.