npx skills add majiayu000/claude-skill-registry --skill api-design-criptogus-liquid-ai --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# API Design - Princípios RESTful Esta skill implementa boas práticas para design de APIs RESTful consistentes e intuitivas. ## Princípios Fundamentais ``` ┌─────────────────────────────────────────────────────────────┐ │ 1. CONSISTÊNCIA - Padrões previsíveis em toda API │ │ 2. SIMPLICIDADE - Fácil de entender e usar │ │ 3. DOCUMENTAÇÃO - Auto-explicativa quando possível │ │ 4. VERSIONAMENTO - Evoluir sem quebrar clientes │ └─────────────────────────────────────────────────────────────┘ ``` ## URL Structure ### Naming Convention ``` # ✅ BOM - Substantivos no plural, kebab-case GET /api/v1/users GET /api/v1/user-profiles GET /api/v1/order-items # ❌ RUIM - Verbos, singular, camelCase GET /api/v1/getUser GET /api/v1/user GET /api/v1/orderItems ``` ### Hierarquia de Recursos ``` # Recurso principal GET /api/v1/users # Sub-recurso (pertence a user) GET /api/v1/users/{userId}/orders # Máximo 2-3 níveis de aninhamento GET /api/v1/users/{userId}/orders/{orderId}/items # Se muito profundo, promova a recurso próprio GET /api/v1/order-items?orderId={orderId} ``` ## HTTP Methods | Method | Uso | Idempotente | Body | |--------|-----|-------------|------| | `GET` | Ler recurso(s) | Sim | Não | |
- Princípios Fundamentais
- URL Structure
- Naming Convention
- Hierarquia de Recursos
- HTTP Methods
- Exemplos CRUD
- Status Codes
- Sucesso (2xx)
- Erro do Cliente (4xx)
- Erro do Servidor (5xx)
- Request/Response Format
- Request Headers
- Response Structure (Sucesso)
- Response Structure (Lista)
Listar todos os usuários GET /api/v1/users Obter usuário específico GET /api/v1/users/123 Criar usuário POST /api/v1/users Atualizar usuário (completo) PUT /api/v1/users/123 Atualizar usuário (parcial) PATCH /api/v1/users/123
What does the api-design skill do?
API Design - Princípios RESTful e boas práticas
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-criptogus-liquid-ai --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.