# 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