Skip to content

Openapi Skills

A powerful collection of agent skills to interact with the @Openapi® API marketplace — company data, official documents, KYC/risk, e-signatures, invoicing, SMS, PEC, and more

Install

$npx skills add openapi/openapi-skills
Claude Code
claude mcp add openapi-skills -- npx skills add openapi/openapi-skills
Cursor / Claude Desktop (mcp.json)
{
  "mcpServers": {
    "openapi-skills": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "openapi/openapi-skills"
      ]
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.


🧩 Openapi® Skills Agent skills to interact with Openapi® APIs from Claude Code and any SKILL.md-compatible agent

Agent skills for using and integrating the services of the Openapi API marketplace — the largest certified API marketplace in Europe.

npx skills add openapi/openapi-skills

Repository layout

Folder Purpose
knowledge/ Curated knowledge base: company profile, services catalog, platform guide (auth, billing, sandbox), FAQ, references, per-service endpoint docs and vendored OpenAPI specs
skills/ The agent skills, one folder per domain, each with a SKILL.md

Knowledge / skills separation

The two folders have strictly separated roles:

  • knowledge/ is build-time material. It is the mass of curated information used to create and align the skills (and to refresh them when Openapi changes). It is consulted by maintainers of this repo, not by agents executing a skill.
  • skills/ are self-contained deliverables. Each SKILL.md is populated from the knowledge but never links to it: an agent must be able to use a skill without this repository's knowledge/ folder being available.
  • External references are allowed in skills, but never routed through knowledge/. Skills point directly to official sources — e.g. the canonical specs at https://console.openapi.com/oas/en/<service>.openapi.json, the docs portal, the status page — not to local copies of them.

Maintenance flow: update knowledge/ from the official sources first, then propagate the relevant content into the affected SKILL.md files.

Skills

Skill Covers
openapi-auth OAuth v2 token lifecycle, scopes, wallet, usage stats (required by all others)
openapi-company Company data: Italy, EU, worldwide
openapi-documents Official documents: visure camerali, balance sheets, DURC, protests (DocuEngine, Visure Camerali, Visengine)
openapi-risk Credit scores, CRIF reports, KYC, negative events
openapi-trust Validation of emails, phones, IPs, URLs, PEC, fiscal codes, plates
openapi-geo Geocoding, zip codes, Italian cadastre, real estate valuations
openapi-messaging SMS v2, PEC, Massive REM, postal mail via Poste Italiane
openapi-esignature eIDAS e-signatures and qualified time stamping
openapi-invoicing Electronic invoicing (Invoice, SDI) and bill payments
openapi-automotive Vehicle data by license plate
openapi-utilities Exchange rates, HTML-to-PDF, .it domains, managed RAG

Credentials

Skills expect OPENAPI_EMAIL and OPENAPI_API_KEY (account credentials for oauth.openapi.com) and/or a ready-made OPENAPI_TOKEN Bearer token in the environment. See knowledge/platform-guide.md.

Contributing

Contributions are always welcome! Whether you want to report bugs, suggest new features, improve documentation, or contribute code, your help is appreciated.

Authors

Similar plugs

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…

Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.

The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…