⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
openapi-auth
Authenticate with the Openapi marketplace (oauth.openapi.com). Use when you need to create, inspect, renew or delete Bearer tokens, list available scopes, check wallet credit, subscriptions, or API usage stats. Required by every other openapi-* skill.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
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. EachSKILL.mdis populated from the knowledge but never links to it: an agent must be able to use a skill without this repository'sknowledge/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 athttps://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
- Francesco Bianco (@francescobianco)
- Openapi Team (@openapi-it)
Partners
Meet our partners using Openapi or contributing to this project:
- Blank
- Credit Safe
- Deliveroo
- Gruppo MOL
- Jakala
- Octotelematics
- OTOQI
- PWC
- QOMODO S.R.L.
- SOUNDREEF S.P.A.
Our Commitments
We believe in open source and we act on that belief. We became Silver Members of the Linux Foundation because we wanted to formally support the ecosystem we build on every day. Open standards, open collaboration, and open governance are part of how we work and how we think about software.
License
This project is licensed under the MIT License.
The MIT License is a permissive open-source license that allows you to freely use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, provided that the original copyright notice and this permission notice are included in all copies or substantial portions of the software.
For more details, see the full license text at the MIT License page.
// HOW IT'S BUILT
KEY FILES