Skills
.Work. You
Rest

sscgen-openapi

Community

Convert OpenAPI specs into typed KDL REST clients.

Software Engineering#linting#openapi#code generation#swagger#kdl#rest client#schema conversion
Authorvypivshiy
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It turns formal API specifications (OpenAPI/Swagger) into ready-to-use, typed KDL DSL client code so you can integrate REST endpoints without manually designing schemas and request/response mappings.

Core Features & Use Cases

  • Deterministic OpenAPI → KDL conversion: transforms YAML/JSON specs into (rest)struct plus json schemas using strict, rule-based mappings.
  • Correct request generation: emits @request blocks with appropriate curl/raw-HTTP formatting for GET/POST (JSON vs form-urlencoded) and placeholder typing.
  • Schema-resolved, linter-verified output: resolves all $ref before generation, orders generated json blocks bottom-up, and requires uv run ssc-gen check ... -f json to pass before delivery.

Quick Start

Convert your OpenAPI file into a complete KDL REST client by asking: convert openapi.yaml to kdl using sscgen-openapi and ensure the generated KDL passes ssc-gen check -f json.

Dependency Matrix

Required Modules

None required

Components

references

💻 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: sscgen-openapi
Download link: https://github.com/vypivshiy/selector_schema_codegen/archive/main.zip#sscgen-openapi

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 471,000+ vetted skills library on demand.