FreeSkills
Commits, branches and sync with the but CLI
- 361361 downloads
- 198198 likes
- 103103 saves
Works with
- Claude Code
- Codex
- Cursor
- and 3 more
REST and GraphQL API design with OpenAPI specs v1.0.0
Use this resource to design or review a REST or GraphQL API with its specification
New
- 323 downloads
- 181 likes
- 138 saves
Free
Install with the CLI
In a terminal, from the folder you want:
npx --yes palatekit@latest install api-design-and-openapi-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 defines resources and HTTP methods, generates an OpenAPI specification, sets the versioning strategy and flags breaking changes. You get a specification and a design review.
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
- reference/: design principles, errors, pagination and authentication patterns
- reference/: breaking change detection, deprecation policy and GraphQL design
Good fit for
- You are building a public API and want to document it
- An update could break existing clients
Not for
Tags
- api
- openapi
- rest
- graphql
- versioning
About
You say
“Design the booking API and generate the matching OpenAPI spec.”
Skill published by simota 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 design or review a REST or GraphQL API with its specification
- Review and adjust the result
Content preview
Files
- LICENSE1 KB
- NOTICE-PALATEKIT.md0.4 KB
- reference/ai-api-patterns.md10.6 KB
- reference/api-auth-patterns.md11.3 KB
- reference/api-decision-tree.md2.4 KB
- reference/api-design-principles.md5 KB
- reference/api-review-checklist.md2.2 KB
- reference/api-security-anti-patterns.md7.9 KB
- reference/api-security-patterns.md5.8 KB
- reference/autorun-schema.md0.9 KB
- reference/breaking-change-detection.md1.9 KB
- reference/deprecation-policy.md11 KB
- reference/error-pagination.md3.8 KB
- reference/graphql-design.md9.2 KB
- reference/messaging/channel-adapters.md13.1 KB
- reference/messaging/realtime-architecture.md8 KB
- reference/messaging/webhook-patterns.md7.7 KB
- reference/openapi-templates.md6.3 KB
- reference/output-format-template.md1 KB
- reference/rate-limit-patterns.md11.9 KB
- reference/rest-api-design.md8.4 KB
- reference/versioning-strategies.md4.1 KB
- reference/webhook-design.md9.1 KB
- SKILL.md23.8 KB
Origin and licence
Listed unmodified
- Author
- simota
- Source
- github.com/simota/agent-skills/tree/2e02cc9efb3852a45334495df3784d59b87b0e18/gateway
- Licence
- MIT
Notice
« gateway » (simota, MIT) livré dans sa version d'origine : fiche en français et en anglais par PalateKit.
User reviews
–
No ratings yet
Loading reviews…