# Api Designer

> Arquitecto de APIs REST y GraphQL para diseñar APIs robustas y escalables. Úsalo al diseñar APIs nuevas o mejorar las existentes.

Fuente: https://skillsagentes.com/skills/zhaono1/agent-playbook/api-designer
Markdown: https://skillsagentes.com/skills/zhaono1/agent-playbook/api-designer.md

Repositorio: https://github.com/zhaono1/agent-playbook
Autor: zhaono1
Licencia: no declarada
Actualizado: hace 5 meses
Coste de contexto: 31 tok instalada, 1.3k tok al activarse, 2.5k tok con todos los archivos del bundle
Bundle: 6 archivos, 10 KB
Permisos que pide: read, write, edit, bash, grep, glob, webfetch, websearch

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add zhaono1/agent-playbook --skill api-designer --agent claude-code
# Cursor
npx -y skills add zhaono1/agent-playbook --skill api-designer --agent cursor
# Codex
npx -y skills add zhaono1/agent-playbook --skill api-designer --agent codex
# Gemini CLI
npx -y skills add zhaono1/agent-playbook --skill api-designer --agent gemini
# Windsurf
npx -y skills add zhaono1/agent-playbook --skill api-designer --agent windsurf
# Cline
npx -y skills add zhaono1/agent-playbook --skill api-designer --agent cline
```

## Qué hace

- Aplica principios de diseño orientado a recursos, métodos HTTP y códigos de estado correctos
- Define convenciones de nombres, paginación, filtrado y ordenamiento en endpoints REST
- Diseña esquemas GraphQL con conexiones basadas en cursor y payloads de mutación
- Establece estrategias de versionado, autenticación, autorización y rate limiting
- Genera scaffolds de API y valida especificaciones OpenAPI mediante scripts

## Cuándo usarla

- Al diseñar una API nueva
- Al revisar el diseño de una API existente
- Al mejorar una API existente
- Al crear especificaciones de API

## Qué la activa

- "Diseña una API REST para gestionar usuarios y sus perfiles"
- "Revisa el diseño de esta API y sugiere mejoras"
- "Ayúdame a definir el esquema GraphQL para posts y comentarios"
- "Genera el scaffold de una API para el recurso 'orders'"

## Antes de instalar

- Requiere Python para ejecutar los scripts generate_api.py y validate_api.py.
- Necesita en el PATH: python
- runs shell commands
- writes to your files
- makes network requests

## Archivos

- README.md — 831 B
- SKILL.md — 5 KB
- references/graphql-patterns.md — 231 B
- references/rest-patterns.md — 275 B
- scripts/generate_api.py — 2 KB
- scripts/validate_api.py — 1 KB

## SKILL.md

No se reproduce aquí. Léelo en https://github.com/zhaono1/agent-playbook/blob/main/skills/api-designer/SKILL.md

## Dónde encaja

- Categoría: [Desarrollo de APIs](https://skillsagentes.com/categorias/desarrollo-apis.md) — Diseña, prueba y documenta APIs HTTP y GraphQL.
- Creador: [zhaono1](https://skillsagentes.com/creators/zhaono1.md) — 0 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Figma Designer](https://skillsagentes.com/skills/zhaono1/agent-playbook/figma-designer.md): Analiza diseños de Figma y genera PRDs listos para implementar con especificaciones visuales detalladas. Requiere conexión al servidor MCP de Figma.
- [Session Logger](https://skillsagentes.com/skills/zhaono1/agent-playbook/session-logger.md): Guarda el historial de conversación en archivos de log de sesión. Úsalo al decir '保存对话', '保存对话信息', '记录会话', 'save session' o 'save conversation'.
- [Skill Router](https://skillsagentes.com/skills/zhaono1/agent-playbook/skill-router.md): Enruta de forma inteligente las solicitudes del usuario hacia el skill de Claude Code más apropiado; es el punto de entrada por defecto cuando no está claro qué skill usar.
- [Prd Planner](https://skillsagentes.com/skills/zhaono1/agent-playbook/prd-planner.md): Crea PRDs mediante planificación persistente basada en archivos. Úsalo cuando el usuario diga explícitamente 'PRD', 'product requirements document' o '产品需求文档'.
- [Create Pr](https://skillsagentes.com/skills/zhaono1/agent-playbook/create-pr.md): Crea pull requests con revisión de documentación bilingüe, asegurando que los README en inglés y chino se mantengan sincronizados cuando cambia el catálogo de skills.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)