{"id":51025468,"url":"https://github.com/openapi/openapi-skills","last_synced_at":"2026-06-21T19:30:33.669Z","repository":{"id":363764614,"uuid":"1264805531","full_name":"openapi/openapi-skills","owner":"openapi","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-10T08:17:43.000Z","size":355,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T09:23:57.013Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-10T07:40:11.000Z","updated_at":"2026-06-10T08:17:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/openapi/openapi-skills","commit_stats":null,"previous_names":["openapi/openapi-skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/openapi/openapi-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fopenapi-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fopenapi-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fopenapi-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fopenapi-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openapi","download_url":"https://codeload.github.com/openapi/openapi-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fopenapi-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T19:30:32.764Z","updated_at":"2026-06-21T19:30:33.653Z","avatar_url":"https://github.com/openapi.png","language":"Shell","funding_links":[],"categories":["Source Catalog"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://openapi.com/\"\u003e\n    \u003cimg alt=\"Openapi Skills\" src=\".github/assets/images/repo-header-a4.png\" \u003e\n  \u003c/a\u003e\n\n  \u003ch1\u003e🧩 Openapi® Skills\u003c/h1\u003e\n  \u003ch4\u003eAgent skills to interact with \u003ca href=\"https://openapi.com/\"\u003eOpenapi®\u003c/a\u003e APIs from Claude Code and any SKILL.md-compatible agent\u003c/h4\u003e\n\n[![Skills CI](https://github.com/openapi/openapi-skills/actions/workflows/skills.yml/badge.svg)](https://github.com/openapi/openapi-skills/actions/workflows/skills.yml)\n[![Release](https://img.shields.io/badge/release-v0.1.0-blue)](https://github.com/openapi/openapi-skills/releases)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n[![Skills](https://img.shields.io/badge/skills-11-blueviolet)](skills/)\n[![skills.sh](https://skills.sh/b/openapi/openapi-skills)](https://skills.sh/openapi/openapi-skills)\n\u003cbr\u003e\n[![Linux Foundation Member](https://img.shields.io/badge/Linux%20Foundation-Silver%20Member-003778?logo=linux-foundation\u0026logoColor=white)](https://www.linuxfoundation.org/about/members)\n\u003c/div\u003e\n\nAgent skills for using and integrating the services of the [Openapi](https://openapi.com) API marketplace — the largest certified API marketplace in Europe.\n\n```bash\nnpx skills add openapi/openapi-skills\n```\n\n## Repository layout\n\n| Folder | Purpose |\n|---|---|\n| [`knowledge/`](knowledge/) | Curated knowledge base: company profile, services catalog, platform guide (auth, billing, sandbox), FAQ, references, per-service endpoint docs and vendored OpenAPI specs |\n| [`skills/`](skills/) | The agent skills, one folder per domain, each with a `SKILL.md` |\n\n## Knowledge / skills separation\n\nThe two folders have strictly separated roles:\n\n- **`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.\n- **`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.\n- **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/\u003cservice\u003e.openapi.json`, the docs portal, the status page — not to local copies of them.\n\nMaintenance flow: update `knowledge/` from the official sources first, then propagate the relevant content into the affected `SKILL.md` files.\n\n## Skills\n\n| Skill | Covers |\n|---|---|\n| [openapi-auth](skills/openapi-auth/SKILL.md) | OAuth v2 token lifecycle, scopes, wallet, usage stats (required by all others) |\n| [openapi-company](skills/openapi-company/SKILL.md) | Company data: Italy, EU, worldwide |\n| [openapi-documents](skills/openapi-documents/SKILL.md) | Official documents: visure camerali, balance sheets, DURC, protests (DocuEngine, Visure Camerali, Visengine) |\n| [openapi-risk](skills/openapi-risk/SKILL.md) | Credit scores, CRIF reports, KYC, negative events |\n| [openapi-trust](skills/openapi-trust/SKILL.md) | Validation of emails, phones, IPs, URLs, PEC, fiscal codes, plates |\n| [openapi-geo](skills/openapi-geo/SKILL.md) | Geocoding, zip codes, Italian cadastre, real estate valuations |\n| [openapi-messaging](skills/openapi-messaging/SKILL.md) | SMS v2, PEC, Massive REM, postal mail via Poste Italiane |\n| [openapi-esignature](skills/openapi-esignature/SKILL.md) | eIDAS e-signatures and qualified time stamping |\n| [openapi-invoicing](skills/openapi-invoicing/SKILL.md) | Electronic invoicing (Invoice, SDI) and bill payments |\n| [openapi-automotive](skills/openapi-automotive/SKILL.md) | Vehicle data by license plate |\n| [openapi-utilities](skills/openapi-utilities/SKILL.md) | Exchange rates, HTML-to-PDF, .it domains, managed RAG |\n\n## Credentials\n\nSkills 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](knowledge/platform-guide.md).\n\n## Contributing\n\nContributions are always welcome! Whether you want to report bugs, suggest new features, improve documentation, or contribute code, your help is appreciated.\n\n## Authors\n\n- Francesco Bianco ([@francescobianco](https://www.github.com/francescobianco))\n- Openapi Team ([@openapi-it](https://github.com/openapi-it))\n\n## Partners\n\nMeet our partners using Openapi or contributing to this project:\n\n- [Blank](https://www.blank.app/)\n- [Credit Safe](https://www.creditsafe.com/)\n- [Deliveroo](https://deliveroo.it/)\n- [Gruppo MOL](https://molgroupitaly.it/it/)\n- [Jakala](https://www.jakala.com/)\n- [Octotelematics](https://www.octotelematics.com/)\n- [OTOQI](https://otoqi.com/)\n- [PWC](https://www.pwc.com/)\n- [QOMODO S.R.L.](https://www.qomodo.me/)\n- [SOUNDREEF S.P.A.](https://www.soundreef.com/)\n\n## Our Commitments\n\nWe believe in open source and we act on that belief. We became Silver Members\nof the Linux Foundation because we wanted to formally support the ecosystem\nwe build on every day. Open standards, open collaboration, and open governance\nare part of how we work and how we think about software.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\nThe 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.\n\nFor more details, see the full license text at the [MIT License page](https://choosealicense.com/licenses/mit/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenapi%2Fopenapi-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenapi%2Fopenapi-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenapi%2Fopenapi-skills/lists"}