Generate an OpenAPI 3.1.0 specification from design stories and domain models.
npx skills add https://github.com/paraskakis/skills --skill design-api-spec
Please help me install this Agent Skill. Skill: design-api-spec Source: https://github.com/paraskakis/skills/tree/main/api/design-api-spec Command: npx skills add https://github.com/paraskakis/skills --skill design-api-spec
Generate a standards-compliant OpenAPI 3.1.0 specification from API design stories, a domain model, API standards, and OpenAPI best practices, helping teams move from concepts to a validated document.
Provide the four required input documents and run the skill to generate a validated OpenAPI 3.1.0 specification.
High-intent search queries and answers about installing and using this skill.
To generate an OpenAPI 3.1.0 specification, provide your API design stories, domain model, API standards, and OpenAPI best practices. This process transforms your design artifacts into a fully specified, DRY OpenAPI document with components and schemas.
Enforcing a DRY OpenAPI structure involves generating the document from standardized design inputs like a domain model. This approach automatically organizes repeated definitions into reusable components and schemas, ensuring consistency and reducing redundancy across the API spec.
Yes, you can lint your OpenAPI spec to improve SDK readiness by using the optional RateMyOpenAPI integration. When an API key is available, the linter evaluates the document and returns a validated score to help iterate and improve quality.
Creating a standards-compliant OpenAPI document from scratch requires four inputs: design stories, a domain model, API standards, and OpenAPI best practices. These artifacts provide the necessary context to produce a validated, ready-to-implement specification.
Yes, API spec generation works without external linting dependencies. While RateMyOpenAPI integration is available for optional validation and scoring when an API key is provided, the core generation of the OpenAPI 3.1.0 document functions independently.
paraskakisTransform requirements and domain models into a linted OpenAPI document.
rrezartprebrezaGenerate Spring-compatible controllers, DTOs, and client stubs from OpenAPI specs.
muhammadhamad1104Execute type checks, linters, and tests to compute a codebase health score.
xsw632Generates C++ Verilator; testbenches from spec.json files for hardware modules.
