Communitygithub.com

aj-geddes/rest-api-design

Projete APIs RESTful seguindo melhores práticas para modelagem de recursos, métodos HTTP, códigos de status, versionamento e documentação. Use ao criar novas APIs, projetar endpoints ou melhorar a arquitetura de APIs existentes.

O que é rest-api-design?

Esta skill, 'aj-geddes/rest-api-design', é uma ferramenta especializada para projetar e documentar APIs RESTful de acordo com as melhores práticas da indústria. Ela oferece orientação sobre modelagem de recursos, seleção correta de métodos HTTP (GET, POST, PUT, DELETE, etc.), interpretação e uso apropriado de códigos de status, estratégias de versionamento (como versionamento por URL ou cabeçalho), e criação de documentação clara e abrangente. É útil para desenvolvedores que estão criando novas APIs do zero, refinando endpoints existentes ou revisando a arquitetura de uma API para garantir aderência a padrões RESTful. A skill é compatível com agentes de IA como Claude Code, Cursor e Codex, e funciona fornecendo recomendações contextuais baseadas nas necessidades do projeto. O conteúdo é baseado em documentação detalhada que inclui exemplos práticos e diretrizes para cada aspecto do design de APIs.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que rest-api-design faz?

Projete APIs RESTful seguindo melhores práticas para modelagem de recursos, métodos HTTP, códigos de status, versionamento e documentação. Use ao criar novas APIs, projetar endpoints ou melhorar a arquitetura 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.

Habilidades Relacionadas