skill-openapi-modi

To create OpenAPI specifications compliant with Italian AgID ModI guidelines, use this Skill to automate the generation of OpenAPI 3.0+ specs, incorporating semantic enrichment with national ontologies like CPV and DCAT-AP_IT, and validate them using integrated MCP tools.

Semantic enrichment for Italian Public Administration APIs is the process of annotating OpenAPI specifications with national ontologies like CPV and DCAT-AP_IT. This Skill automates that process to ensure linked data interoperability and compliance with AgID standards.

To validate an OpenAPI spec against ModI standards, this Skill uses integrated MCP tools to perform automated compliance checking and semantic validation. It supports an iterative refinement workflow to ensure your API design meets all AgID guidelines.

Yes, you can generate OpenAPI 3.0 specs for Italian public services without deep prior ontology knowledge. The Skill streamlines the design-to-validation workflow by automatically incorporating semantic enrichment using national vocabularies and ontologies like CPV and DCAT-AP_IT.

A limitation of automating AgID compliance is that the generated OpenAPI specifications may still require iterative refinement. While the Skill automates semantic validation and compliance checking using MCP tools, developers must review and refine the API canvas outputs to ensure complete data interoperability.