Back to browse
GitHub Repository

Generate agent skills from OpenAPI specs. Creates agentskills.io format documentation so AI agents can discover and call your API.

3 starsPython

OpenAPI 2 Skill – progressive disclosure of OpenAPI specs for agents

by scosman·Mar 20, 2026·2 points·0 comments

AI Analysis

MidNiche Gem

Progressive disclosure beats MCP tool flooding for large OpenAPI specs.

Strengths
  • Tag-based organization prevents context overflow from thousands of endpoints
  • Generated SKILL.md with linked reference files enables selective API discovery
  • Works from URL or local file with custom preamble support
Weaknesses
  • agentskills.io format has limited adoption compared to MCP servers
  • Essentially a format converter — no runtime or execution layer included
Category
Target Audience

Developers building AI agent integrations

Similar To

MCP Registry · OpenAPI Generator

Similar Projects

Developer Tools●●Solid

Turn any OpenAPI spec into agent-callable skills

It extracts focused, executable operations from giant OpenAPI files (the GitHub REST YAML is shown) to shrink context and avoid sidecar adapter sprawl — a pragmatic answer to token bloat and brittle ad-hoc integrations. Useful and concrete: if it actually generates tidy, updateable skill units and runtime hooks it saves a lot of maintenance. That said, the idea competes with existing LangChain/openai-function patterns; the repo will need clear runtime, versioning, and update strategies to feel like more than a nicer converter.

Solve My ProblemNiche Gem
yz-yu
103mo ago