Skills
.Work. You
Rest

graph-api-design

Community

Govern and audit APIs with OpenAPI, REST maturity, and contract validation.

Software Engineering#OpenAPI#REST API#Swagger#API governance#contract validation#API audit
Authorluissimon96
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a comprehensive API governance and design audit using OpenAPI/Swagger, REST maturity model, and contract validation, ensuring consistency and compliance across API surfaces.

Core Features & Use Cases

  • API Governance: Generates OpenAPI/Swagger specs for API documentation.
  • REST Maturity Model: Validates and enhances RESTful API design.
  • Contract Validation: Ensures endpoints have proper Zod schema validation.
  • Breaking Change Detection: Flags and documents breaking changes for migration paths.
  • Versioning & Deprecation: Tracks deprecated items and migration paths.
  • Documentation Check: Verifies API routes and MCP tools are well-documented.
  • API Report: Generates an audit report with compliance scores and recommendations.

Quick Start

Run the graph-api-design skill to audit the current API surface.

Dependency Matrix

Required Modules

openapi-generatorswagger-parserzod

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: graph-api-design
Download link: https://github.com/luissimon96/orchestration-devops-agents/archive/main.zip#graph-api-design

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 620,000+ vetted skills library on demand.