Design consistent resource URLs, HTTP verbs, pagination, error responses, and idempotency headers for public APIs.
Andromity loads skills from folders you trust. Install with andromity skill install rest-api-design — autonomy and approval limits stay configurable per session.
# Install the "Pragmatic RESTful API Design" skill You are installing an AgenticMarket skill into this workspace. Follow these steps exactly. ## 1. Detect your environment and choose the destination file - Andromity: `.andromity/skills/rest-api-design/SKILL.md` (or user scope `~/.andromity/skills/rest-api-design/SKILL.md`) - Antigravity / Gemini CLI: `.agent/skills/rest-api-design/SKILL.md` - Cursor: `.cursor/rules/rest-api-design.mdc` - Claude Code: append to `CLAUDE.md` (or `.claude/skills/rest-api-design.md`) - Windsurf: append to `.windsurfrules` - Cline / Roo Code: `.clinerules/rest-api-design.md` - GitHub Copilot: append to `.github/copilot-instructions.md` - ChatGPT / web only: paste the content into Custom Instructions - Any other agent: save to `.agent/skills/rest-api-design/SKILL.md` ## 2. Create the destination file - Preserve every existing file and configuration entry. - Create parent folders as needed. - Never overwrite unrelated content. ## 3. Write exactly this content ```markdown --- name: rest-api-design description: "Design consistent resource URLs, HTTP verbs, pagination, error responses, and idempotency headers for public APIs." author: community license: mit version: 1.0.0 --- # Pragmatic REST API Design Standard API design rules: - Use plural nouns for resource paths (`/api/v1/servers`). - Use standard HTTP status codes: 200 OK, 201 Created, 204 No Content, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests. - Return structured error payloads with `error.code` and `error.message`. ``` ## 4. Verify - Confirm the file exists and is readable. - Report the destination path and confirm the "Pragmatic RESTful API Design" skill is installed and active. Skill metadata: - Slug: rest-api-design - Category: development - License: mit - Source: AgenticMarket
Standard API design rules:
AgenticMarket/api/v1/servers).error.code and error.message.Design consistent resource URLs, HTTP verbs, pagination, error responses, and idempotency headers for public APIs.
Pragmatic RESTful API Design works seamlessly with Cursor (.cursor/rules), Claude Code (CLAUDE.md & .claude/skills), Windsurf (.windsurfrules), Google Antigravity (.agent/skills), Andromity (.andromity/skills), and Cline.
Click '1-Click Prompt Install' in the right sidebar or copy the prompt into your agent chat (Cursor Composer, Claude Code, or Andromity). The agent automatically configures the skill instruction file into your workspace.
Yes, Pragmatic RESTful API Design is 100% free and open-source under the mit license on AgenticMarket with no per-call fees or paywalls.
Master React Server Components, Server Actions, parallel routes, streaming, ISR, and cache revalidation.
Implement Stripe Checkout sessions, webhook verification, customer portals, idempotency keys, and subscription billing.
Design type-safe database schemas, execute optimized relational queries, and manage migrations across SQLite, Postgres, and D1.
