Communitygithub.com

aj-geddes/rest-api-design

Diseña APIs RESTful siguiendo las mejores prácticas para modelado de recursos, métodos HTTP, códigos de estado, versionado y documentación. Úsalo al crear nuevas APIs, diseñar endpoints o mejorar la arquitectura de APIs existentes.

¿Qué es rest-api-design?

Este skill está diseñado para guiar a desarrolladores y agentes de IA en el diseño de APIs RESTful que cumplan con las mejores prácticas de la industria. Cubre aspectos fundamentales como el modelado de recursos, la selección y uso correcto de métodos HTTP (GET, POST, PUT, DELETE, PATCH), la elección de códigos de estado apropiados para cada respuesta, estrategias de versionado de APIs (por URI, mediante cabeceras o negociación de contenido) y la creación de documentación clara, eficaz y legible para otros desarrolladores. Es especialmente útil durante la fase de diseño de una nueva API, la revisión de endpoints existentes con vistas a su mejora o la estandarización de la arquitectura de múltiples APIs en un proyecto. El skill se apoya en el contenido de su archivo SKILL.md para proporcionar pautas, ejemplos de código y recomendaciones accionables, y puede ser utilizado en plataformas compatibles con la definición de habilidades de IA como Claude Code, Cursor o Codex.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aj-geddes/useful-ai-prompts/tree/main/skills/rest-api-design

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace rest-api-design?

Diseña APIs RESTful siguiendo las mejores prácticas para modelado de recursos, métodos HTTP, códigos de estado, versionado y documentación. Úsalo al crear nuevas APIs, diseñar endpoints o mejorar la arquitectura de APIs existentes.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

aj-geddes/android-kotlin-development

Develop native Android apps with Kotlin. Covers MVVM with Jetpack, Compose for modern UI, Retrofit for API calls, Room for local storage, and navigation architecture.

aj-geddes/ansible-automation

Infrastructure automation and configuration management using Ansible playbooks, roles, and inventory. Use for deploying applications, patching, and managing servers.

aj-geddes/architecture-diagrams

Create system architecture diagrams using Mermaid, PlantUML, C4 model, flowcharts, and sequence diagrams. Use when documenting architecture, system design, data flows, or technical workflows.

aj-geddes/code-review-analysis

Perform comprehensive code reviews with best practices, security checks, and constructive feedback. Use when reviewing pull requests, analyzing code quality, checking for security vulnerabilities, or providing code improvement suggestions.

aj-geddes/flask-api-development

Develop lightweight Flask APIs with routing, blueprints, database integration, authentication, and request/response handling. Use when building RESTful APIs, microservices, or lightweight web services with Flask.

aj-geddes/ios-swift-development

Develop native iOS apps with Swift. Covers MVVM architecture, SwiftUI, URLSession for networking, Combine for reactive programming, and Core Data persistence.

aj-geddes/jenkins-pipeline

Build Jenkins declarative and scripted pipelines with stages, agents, parameters, and plugins. Implement multi-branch pipelines and deployment automation.

aj-geddes/markdown-documentation

Master markdown formatting, GitHub Flavored Markdown, README files, and documentation formatting. Use when writing markdown docs, READMEs, or formatting documentation.

aj-geddes/nginx-configuration

Configure Nginx web server for high-performance reverse proxy, load balancing, SSL/TLS, caching, and API gateway functionality.

aj-geddes/nodejs-express-server

Build production-ready Express.js servers with middleware, authentication, routing, and database integration. Use when creating REST APIs, managing requests/responses, implementing middleware chains, and handling server logic.

aj-geddes/wireframe-prototyping

Create wireframes and interactive prototypes to visualize user interfaces and gather feedback early. Use tools and techniques to communicate design ideas before development.

Skills relacionados