FreeSkills
Commits, branches and sync with the but CLI
- 361361 downloads
- 198198 likes
- 103103 saves
Works with
- Claude Code
- Codex
- Cursor
- and 3 more
Writing and reading an OpenAPI 2.0 (Swagger) spec v1.0.0
Use this resource to write, validate or interpret a Swagger 2.0 specification for a REST API
New
- 521 downloads
- 245 likes
- 134 saves
Free
Install with the CLI
In a terminal, from the folder you want:
npx --yes palatekit@latest install openapi-2-swagger-specWith no option, the skill goes to ~/.agents/skills/; add --agent claude-code (or codex, cursor…) to target an agent.
First time: connect the CLI with
npx --yes palatekit@latest loginThe agent writes or reads a Swagger 2.0 specification in JSON or YAML: paths, operations, parameters, responses, schema definitions and security. It can also prepare the basis for client or documentation generation. You get a specification file consistent with the 2.0 format.
Mostly picked by
Updated November 2, 2026
Previews
Details
- Install guides
- Generates with
- Your agent's model
- Licence
- MIT
Similar resources
View all- Free
FreeSkills
Sentry CLI guide
- 525525 downloads
- 117117 likes
- 128128 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
Drizzle ORM best practices with PostgreSQL
- 407407 downloads
- 194194 likes
- 151151 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
SLO design wizard
- 537537 downloads
- 105105 likes
- 242242 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
User stories and sprint fit
- 451451 downloads
- 150150 likes
- 132132 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
Capacity-based sprint plan
- 423423 downloads
- 192192 likes
- 102102 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
Startup CTO advisor
- 580580 downloads
- 201201 likes
- 242242 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
FreeSkills
Creating GitHub pull requests with quality checks
- 427427 downloads
- 230230 likes
- 196196 saves
Works with- Claude Code
- Codex
- Cursor
- and 3 more
What you get
- references/: format, data types, parameters and responses
- references/: security, schemas, extensions and authoring best practices
Good fit for
- You document an existing REST API in Swagger 2.0
- You need to validate or fix an OpenAPI 2.0 file
Not for
Tags
- openapi
- swagger
- api
- documentation
- rest
About
You say
“Write the Swagger 2.0 spec for this GET /users route with its pagination parameter.”
Skill published by hairyf under the MIT license, delivered in its original version.
Show moreShow less
How to use it
- Install the skill in your agent's skills folder
- Ask your agent to write, validate or interpret a Swagger 2.0 specification for a REST API
- Review and adjust the result
Content preview
Files
- GENERATION.md0.2 KB
- LICENSE1.1 KB
- NOTICE-PALATEKIT.md0.5 KB
- references/advanced-extensions-and-xml.md2.1 KB
- references/advanced-security-filtering.md1.5 KB
- references/advanced-vendor-extensions.md1.4 KB
- references/best-practices-spec-authoring.md2.3 KB
- references/core-data-types-and-formats.md2.2 KB
- references/core-example-object.md1.5 KB
- references/core-fixed-patterned-fields.md1.9 KB
- references/core-format-and-structure.md1.8 KB
- references/core-header-object.md2.3 KB
- references/core-headers-object.md1.6 KB
- references/core-http-status-codes.md1.6 KB
- references/core-info-metadata.md1.8 KB
- references/core-items-object.md2.5 KB
- references/core-mime-types.md1.8 KB
- references/core-path-templating.md1.8 KB
- references/core-reference-object.md2.1 KB
- references/core-swagger-object.md2.5 KB
- references/core-tags-and-external-docs.md1.6 KB
- references/parameters-collection-format.md2.1 KB
- references/parameters-definitions-reuse.md2 KB
- references/parameters.md2.6 KB
- references/path-item-ref.md1.9 KB
- references/paths-and-operations.md3 KB
- references/responses-definitions-reuse.md1.9 KB
- references/responses.md2.2 KB
- references/schema-and-definitions.md2.9 KB
- references/schema-json-schema-keywords.md2.3 KB
- references/security-basic-apikey.md1.9 KB
- references/security-oauth2-flows.md2.4 KB
- references/security-requirement-object.md1.7 KB
- references/security-scopes-object.md1.6 KB
- references/security.md2.5 KB
- SKILL.md5.7 KB
Origin and licence
Listed unmodified
- Author
- hairyf
- Source
- github.com/hairyf/skills/tree/ffa1f904012f48f5bdf34ebb692daa09c778d47f/skills/openapi-specification-v2
- Licence
- MIT
Notice
« openapi-specification-v2 » (hairyf, MIT) livré dans sa version d'origine : fiche en français et en anglais par PalateKit.
User reviews
–
No ratings yet
Loading reviews…