Openapi Spec Writer
Expert in writing OpenAPI 3.0/3.1 specifications for REST APIs. Specializes in schema design, documentation best practices, API-first development, and tooling integration. Generates comprehensive API documentation that serves as both documentation and contract.
Install
/plugin marketplace add curiositech/some_claude_skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add curiositech/some_claude_skills --skill openapi-spec-writergit clone --depth 1 https://github.com/curiositech/some_claude_skills.git /tmp/some_claude_skills
mkdir -p ~/.claude/skills
cp -r /tmp/some_claude_skills/.claude/skills/openapi-spec-writer ~/.claude/skills/openapi-spec-writerPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# OpenAPI Spec Writer ## Overview Expert in writing OpenAPI 3.0/3.1 specifications for REST APIs. Specializes in schema design, documentation best practices, API-first development, and tooling integration. Generates comprehensive API documentation that serves as both documentation and contract. ## When to Use - Creating OpenAPI specifications for new APIs - Documenting existing REST APIs - Designing API contracts before implementation - Generating client SDKs from specs - Setting up interactive API documentation (Swagger UI, Redoc) - Validating API responses against schemas - Migrating from OpenAPI 2.0 (Swagger) to 3.x ## Capabilities ### Specification Writing - OpenAPI 3.0 and 3.1 syntax - Path and operation definitions - Request/response schemas - Authentication schemes - Server configurations ### Schema Design - JSON Schema with OpenAPI extensions - Reusable component schemas - Discriminators for polymorphism - oneOf, anyOf, allOf composition - Nullable types and defaults ### Documentation Quality - Meaningful descriptions and examples - Markdown in descriptions - Request/response examples - Error response documentation - Deprecation notices ### Tooling Integration - Swagger UI configuration - Redoc customization - Spectral linting rules - SDK generation setup - Mock server configuration ## Dependencies Works well with: - `api-architect` - API design patterns - `rest-api-design` - RESTful conventions - `typescript-pro` - Generated client types
Details
- Skill name
openapi-spec-writer- Repository
- curiositech/some_claude_skills
- Path
.claude/skills/openapi-spec-writer/SKILL.md- License
- MIT
- Repo updated
- 5 November 2026
FAQ
What does the Openapi Spec Writer skill do?
Expert in writing OpenAPI 3.0/3.1 specifications for REST APIs. Specializes in schema design, documentation best practices, API-first development, and tooling integration. Generates comprehensive API documentation that serves as both documentation and contract.
How do I install the Openapi Spec Writer skill?
Claude Code plugin: /plugin marketplace add curiositech/some_claude_skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Openapi Spec Writer popular?
It lives in curiositech/some_claude_skills, which has 272 GitHub stars and 46 forks.
Related skills
Email Composer
272curiositech/some_claude_skills
Draft professional emails for various contexts including business, technical, and customer communication. Use when the user needs help writing emails or composing professional messages.
2000s Visualization Expert
272curiositech/some_claude_skills
Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.
2026 Legal Research Agent
272curiositech/some_claude_skills
Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape. Activate on "find expungement data", "scrape state laws", "legal research", "court URLs", "statute sources", "Clean Slate laws", "automatic expungement research". NOT for interpreting laws (use national-expungement-expert), building UI, or legal advice.
Pet Memorial Creator
272curiositech/some_claude_skills
Compassionate support for pet loss, memorial creation, and honoring the bond between humans and their animal companions. Specializes in tribute writing, keepsake ideas, and navigating the unique grief of losing a pet.
Mermaid Graph Writer
272curiositech/some_claude_skills
Writes precise, well-structured Mermaid diagrams for any visualization need. Use when creating flowcharts, sequence diagrams, state machines, ER models, timelines, mindmaps, Gantt charts, or any other Mermaid-supported diagram type. Activate on "mermaid", "diagram", "flowchart", "sequence diagram", "state diagram", "ER diagram", "visualize", "draw graph". NOT for rendering/exporting Mermaid to images (use mermaid-graph-renderer), ASCII art, or GUI-based design tools.
Technical Writer
272curiositech/some_claude_skills
Expert technical documentation specialist for developer docs, API references, and runbooks. Activate on: documentation, docs, README, API reference, technical writing, user guide, runbook, ADR, changelog, release notes, tutorial, how-to guide. NOT for: marketing copy (use copywriting skills), blog posts (use content skills), code comments (handled by developers).
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.