pudo-handoff
Write the PUDO session handoff (.pudo/session.md) so another session, tool or teammate can continue the work. Use when the user…
@dongduong2001Install SkillDevelopment
Skill
/api-design
Planning and designing scalable, secure, and intuitive APIs
Claude Code
$ npx -y skills add DongDuong2001/pudo-code-system --skill api-design --agent claude-code
Codex
$ npx skills add DongDuong2001/pudo-code-system --skill api-design -a codex -y
Cursor
$ npx skills add DongDuong2001/pudo-code-system --skill api-design -a cursor -y
Gemini CLI
$ npx skills add DongDuong2001/pudo-code-system --skill api-design -a gemini-cli -y
GitHub Copilot
$ npx skills add DongDuong2001/pudo-code-system --skill api-design -a github-copilot -y
OpenCode
$ npx skills add DongDuong2001/pudo-code-system --skill api-design -a opencode -y
Windsurf
$ npx skills add DongDuong2001/pudo-code-system --skill api-design -a windsurf -y
SKILL.md
api-design.SKILL.mdname: api-design-plan description: Planning and designing scalable, secure, and intuitive APIs
API Design Skill
This skill is utilized during the PLAN phase when defining the contract between different services or between a client and a backend.
When to use this skill
- When defining RESTful endpoints, GraphQL schemas, or gRPC definitions.
- When creating API documentation (OpenAPI/Swagger).
- When planning API versioning and deprecation strategies.
Guidelines
- **Consistency:** Maintain consistent naming conventions (e.g., standardizing on plural nouns for REST collections).
- **Versioning:** Plan for API versioning from Day 1 (e.g., `/v1/users`).
- **Pagination & Filtering:** Design endpoints to handle large datasets natively.
- **Security:** Ensure authentication (OAuth2, JWT) and authorization (RBAC/ABAC) are built into the design.
Stats
5
Stars
0
Forks
Active
Maintenance
TypeScript
Language
MIT
License
Last commit
Created
In this plugin
See everything inside 538 skills1 agent
Stars on GitHub
Momentum
- stars in total
- 5
Other skills on pudo-code-system.
@dongduong2001Install Skillpudo-plan
PUDO Plan phase: turn a request into a short plan card (goal, scope, out of scope, success criteria, risks, steps) before any…
@dongduong2001Install Skillpudo-review
PUDO Optimize gate: review the current diff against the plan before calling work done: correctness, edge cases, tests, scope…
@dongduong2001Install Skillpudo
PUDO workflow: Plan -> Understand -> Develop -> Optimize. Use on any non-trivial coding task (features, bug fixes, refactors,…
@dongduong2001Install Skillfastapi
- [ ] **API Design:** Define RESTful endpoints, path parameters, and query parameters. - [ ] **Data Validation:** Plan Pydantic…
@dongduong2001Install Skillrust
- [ ] **Framework Selection:** Choose web framework (Axum, Actix-web) based on performance vs. ecosystem needs. - [ ] **Crate…
@dongduong2001Install SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about api-design.
- Which coding agents can use api-design?
- api-design installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.