api-design
Design REST, GraphQL, RPC, webhook, and internal service APIs.
Skill by PAISHU-AI
Chalk Labs
Need help deploying api-design?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/paishu-ai-api-design
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: documents, design, backend
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/api-design
What's inside
- Skill name
api-design- Description
- Design REST, GraphQL, RPC, webhook, and internal service APIs. Use for routes, status codes, request/response schemas, error models, pagination, filtering, versioning, idempotency, and OpenAPI or contract documentation.
- License
- MIT
- Instructions
- 35 lines in SKILL.md · view on GitHub
Agent Skills spec issues
- name: "api-design" does not match folder "06-api-design"
Files (1)
- SKILL.md
SKILL.md (first lines)
# API Design ## Workflow 1. Identify resource, action, caller, authorization boundary, and compatibility needs. 2. Choose API style that matches the existing system. 3. Define request schema, response schema, error schema, and status codes. 4. Define pagination, filtering, sorting, idempotency, rate limits, and versioning when applicable. 5. Add tests or contracts for normal, error, and boundary behavior. ## REST Defaults - Use HTTP semantics accurately. - Use safe and idempotent methods correctly. - Return errors in a consistent problem format; RFC 9457 Problem Details is a good default when no local standard exists. - Use OpenAPI when the project already documents APIs or when external consumers need a contract. ## Webhook Defaults - Verify signatures. - Prevent replay when possible. - Make processing idempotent. - Store enough event metadata for audit and replay diagnosis. ## Output Provide endpoint summary, schema shape, error cases, security notes, and compatibility risks. ## Boundaries - Do not claim files, generated media, deployments, scans, account changes, or external writes unless the active tool or command output proves them. - Do not override system, developer, user, project, or selected-skill rules. - If another skill is more specific for the user's intent, hand off or use it as the main skill instead of duplicating its workflow.
From PAISHU-AI/PAI-zong-NB-v5.8, MIT.
More from PAISHU-AI/PAI-zong-NB-v5.8
- 0.495score
backend-design
PAISHU-AI
Design backend architecture, service boundaries, domain models, data flow, async jobs, reliability strategy, error handling, observability, and deployment…
SkillCFreshness: C★ 1Claude Code +9 - 0.493score
code-review
PAISHU-AI
Review code changes for bugs, regressions, security issues, missing tests, API contract breaks, data risks, performance risks, maintainability problems, and…
SkillCFreshness: C★ 1Claude Code +9 - 0.493score
ui-polish
PAISHU-AI
Improve visual quality, spacing, hierarchy, typography, color, motion, icons, empty states, and perceived product quality for desktop and web UI.
SkillCFreshness: C★ 1Claude Code +9 - 0.493score
project-context
PAISHU-AI
Inspect and summarize project context before coding.
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
database
PAISHU-AI
Design and modify database schemas, migrations, SQL queries, indexes, transactions, constraints, and query performance.
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
security
PAISHU-AI
Analyze and implement security-sensitive code involving authentication, authorization, tokens, sessions, uploads, payment, encryption, secrets, webhooks…
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
devops
PAISHU-AI
Work on Docker, deployment, CI/CD, environment variables, server configuration, build pipelines, health checks, logs, monitoring, rollbacks, infrastructure…
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
performance
PAISHU-AI
Diagnose and improve frontend, backend, database, build, memory, CPU, and network performance.
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
i18n
PAISHU-AI
Internationalize and localize user interfaces, APIs, documents, and formatting.
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
docs-rules
PAISHU-AI
Create and maintain README files, API docs, usage docs, comments, AGENTS.md, .ai_project.md, prompt rules, skill files, and project conventions.
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
api-client
PAISHU-AI
Build and maintain API client layers for desktop and web apps, including request wrappers, typed clients, authentication headers, retries, cancellation…
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
web-app
PAISHU-AI
Build and improve API-driven web applications, dashboards, admin panels, SaaS tools, and browser-based product UI.
SkillCFreshness: C★ 1Claude Code +9
Signals
- Stars
- 1
- Forks
- 1
- Open issues
- 0
- Last commit (this folder)
- Jul 18, 2026 (3 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/PAISHU-AI/PAI-zong-NB-v5.8
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
More from PAISHU-AI
- 0.495score
backend-design
PAISHU-AI
Design backend architecture, service boundaries, domain models, data flow, async jobs, reliability strategy, error handling, observability, and deployment…
SkillCFreshness: C★ 1Claude Code +9 - 0.493score
ui-polish
PAISHU-AI
Improve visual quality, spacing, hierarchy, typography, color, motion, icons, empty states, and perceived product quality for desktop and web UI.
SkillCFreshness: C★ 1Claude Code +9 - 0.493score
project-context
PAISHU-AI
Inspect and summarize project context before coding.
SkillCFreshness: C★ 1Claude Code +9 - 0.493score
code-review
PAISHU-AI
Review code changes for bugs, regressions, security issues, missing tests, API contract breaks, data risks, performance risks, maintainability problems, and…
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
backend
PAISHU-AI
Implement backend services, business logic, API handlers, jobs, integrations, file processing, authentication flows, and server-side fixes.
SkillCFreshness: C★ 1Claude Code +9 - 0.490score
ui-design
PAISHU-AI
Design practical user interfaces, flows, information architecture, layout systems, component states, and design tokens.
SkillCFreshness: C★ 1Claude Code +9
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get api-design running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
api-design skill. Agent Mart. https://agentmart.dev/skills/paishu-ai-api-design (last updated 2026-10-24)