Design RESTful and GraphQL APIs with OpenAPI 3.0 specifications.
npx skills add https://github.com/icartsh/icartsh_plugin --skill api-designer-icartsh
Please help me install this Agent Skill. Skill: api-designer Source: https://github.com/icartsh/icartsh_plugin/tree/main/icartsh-plugin/skills/api-designer Command: npx skills add https://github.com/icartsh/icartsh_plugin --skill api-designer-icartsh
This Skill guides API design and documentation, including OpenAPI spec generation and authentication/documentation best practices.
Create an OpenAPI spec with scripts/api_helper.py generate; validate with scripts/api_helper.py validate; build docs with scripts/api_helper.py docs.
High-intent search queries and answers about installing and using this skill.
OpenAPI specification generation uses a design-first approach to document REST endpoints, request/response schemas, and authentication methods. This Skill provides scripts to generate valid OpenAPI 3.0 specs from your API design, validate them against the standard, and export documentation automatically.
Authentication patterns include OAuth, JWT tokens, and API keys, each suited to different security contexts. This Skill guides you through selecting and implementing the right scheme—plus role-based access control (RBAC)—and documenting it in your OpenAPI spec for client clarity.
Yes. This Skill handles both REST and GraphQL interfaces. For GraphQL, it covers schema design, type definitions, resolver planning, and documentation patterns alongside REST/OpenAPI workflows, so you can design either or both protocols with consistent practices.
Documentation as code converts your OpenAPI spec into human-readable guides and usage patterns automatically. This Skill generates quick references and integration examples from your spec, reducing manual doc maintenance and keeping examples in sync with schema changes.
OpenAPI validation checks your spec against the 3.0 standard, enforcing correct schema structure, security schemes, pagination rules, error handling patterns, and endpoint definitions. This Skill validates specs before deployment to catch design issues early and ensure client tooling compatibility.
Versioning strategies in OpenAPI let you manage backward compatibility and deprecation. This Skill covers planning version schemes in your spec, documenting breaking changes, and maintaining multiple API versions so clients can migrate at their own pace.
chaorenex1Parse code files to generate OpenAPI 3.0.3 compliant Markdown documentation.
fgarofalo56Design, document, generate, validate, and mock RESTful APIs with OpenAPI and Swagger.
SaturateGenerate OpenAPI specs and TypeScript types from contract-first API designs.
nashirabbashGenerate OpenAPI specs and interactive documentation for REST and GraphQL APIs.
