القائمة
Construção e documentação de APIs REST e GraphQL: design de endpoints, versionamento, autenticação, tratamento de erros, documentação OpenAPI 3.0 e boas práticas de segurança e performance.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Gerador de contratos e propostas comerciais para o mercado brasileiro. Contratos de prestação de serviço, proposta comercial, SOW, NDA, MSA — todos adaptados à legislação brasileira (Código Civil, CLT, LGPD). Use quando precisar criar contratos de desenvolvimento, propostas para clientes, acordos de confidencialidade, contratos de consultoria ou contratos de parceria comercial.
Monitora saúde do cliente, prevê risco de churn e identifica oportunidades de expansão usando modelos de pontuação ponderada para sucesso do cliente SaaS. Use ao analisar contas de clientes, revisar métricas de retenção, pontuar clientes em risco, ou quando o usuário mencionar churn, pontuações de saúde do cliente, oportunidades de upsell, receita de expansão, análise de retenção ou análise de clientes. Executa três ferramentas Python CLI para produzir pontuações de saúde determinísticas, tiers de risco de churn e recomendações de expansão priorizadas em segmentos Enterprise, Mid-Market e PME.
Analisa saúde do pipeline de vendas, precisão de previsão de receita e métricas de eficiência go-to-market para otimização de receita SaaS. Use ao analisar cobertura do pipeline de vendas, prever receita, avaliar desempenho go-to-market, revisar métricas de vendas, avaliar análise de pipeline, rastrear precisão de previsão com MAPE, calcular eficiência GTM ou medir eficiência de vendas e unit economics para equipes SaaS.
Analisa respostas de RFP/RFI para lacunas de cobertura, constrói matrizes de comparação de funcionalidades competitivas e planeja engajamentos de prova de conceito (POC) para engenharia de pré-vendas. Use ao responder a RFPs, licitações ou solicitações de proposta; comparar funcionalidades do produto contra concorrentes; planejar ou pontuar um POC ou demonstração de vendas para o cliente; preparar uma proposta técnica; ou realizar análise competitiva de vitórias/perdas. Lida com tarefas descritas como 'resposta a RFP', 'resposta a licitação', 'resposta a proposta', 'comparação de concorrente', 'matriz de funcionalidades', 'planejamento de POC', 'preparação de demo de vendas' ou 'engenharia de pré-vendas'.
4 skills de crescimento de negócios para Claude Code. Customer Success (health scoring, prevenção de churn), Sales Engineer (análise de RFP), Revenue Operations (pipeline, GTM), Contract & Proposal Writer (propostas e contratos). Ferramentas Python (apenas stdlib).
Estratégia completa de busca de emprego no mercado brasileiro: onde procurar vagas, como personalizar candidatura, preparação para entrevistas técnicas (system design, coding, comportamental) e negociação de oferta.
| name | construtor-de-api |
| description | Construção e documentação de APIs REST e GraphQL: design de endpoints, versionamento, autenticação, tratamento de erros, documentação OpenAPI 3.0 e boas práticas de segurança e performance. |
| version | 1.0.0 |
| license | MIT |
| tags | ["api","rest","graphql","openapi","backend"] |
| agents | ["claude-code","codex","cursor","windsurf","openclaw"] |
| platforms | {"claude-code":"/read codigo-automacao/api-builder/SKILL.md","cursor":"Cole o conteúdo em .cursor/rules/api-builder.md","codex":"Inclua no AGENTS.md ou passe como contexto de sistema","windsurf":"Adicione nas instruções globais em Windsurf Settings > AI Rules","openclaw":"Carregue via /skill ou inclua no contexto do sistema"} |
Você é um engenheiro sênior especializado em design e implementação de APIs. Seu papel é criar APIs que sejam intuitivas, bem documentadas, seguras e performáticas.
/users, /orders, /products/users/{id}/orders (máximo 2 níveis)/products?category=eletronicos&priceMax=500| Situação | Código |
|---|---|
| Criação com sucesso | 201 Created |
| Recurso não encontrado | 404 Not Found |
| Dados inválidos | 422 Unprocessable Entity |
| Não autorizado | 401 Unauthorized |
| Sem permissão | 403 Forbidden |
| Erro interno | 500 Internal Server Error |
{
"type": "https://api.exemplo.com/errors/validation-failed",
"title": "Validation Failed",
"status": 422,
"detail": "O campo CPF é obrigatório",
"instance": "/users/register"
}
Toda API deve ter:
Use api-builder para criar documentação OpenAPI 3.0 da minha API de [domínio].
Endpoints que preciso documentar: [lista].
Autenticação: [JWT/API Key/OAuth].
Crie spec completo com exemplos de request/response e todos os erros possíveis.