skill-openapi-modi

What problem does it solve?

This Skill streamlines the creation of OpenAPI specifications for Italian Public Administration APIs, ensuring compliance with AgID guidelines and simplifying semantic interoperability.

Core Features & Use Cases

• Automated OpenAPI Generation: Generates compliant OpenAPI 3.0+ specs based on design inputs.
• Semantic Enrichment: Integrates Italian ontologies (CPV, DCAT-AP_IT) and vocabularies for linked data.
• Validation & Iteration: Uses MCP tools for automated validation against ModI standards and iterative refinement.
• Use Case: A developer needs to create a new REST API for a public service in Italy. They can use this Skill to guide the design, generate the OpenAPI spec, ensure it meets AgID requirements, and enrich it with semantic annotations for better data interoperability.

Quick Start

Use the skill-openapi-modi to generate an OpenAPI 3.0 specification for a new API managing citizen requests, ensuring compliance with AgID ModI guidelines.