Skill do Backend Developer para definição de APIs, banco de dados, e lógica de servidor. Use quando precisar definir schemas de banco, endpoints REST/GraphQL, validação server-side, autenticação, migrations, ou qualquer lógica de backend. Trigger em: "API", "endpoint", "banco de dados", "schema", "migration", "backend", "servidor", "autenticação", "JWT", "middleware", "ORM", "Prisma", "PostgreSQL", "Node.js", "Express", "NestJS", "validação server-side".
82
78%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/03-backend-api/SKILL.mdQuality
Discovery
92%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly defines its scope as backend development, lists concrete capabilities, and provides explicit trigger guidance with a comprehensive keyword list. The main weakness is its broad scope covering nearly all backend concerns, which could create overlap with more specialized skills in a large skill library. The description uses appropriate third-person voice and is well-structured.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: defining API schemas, database schemas, REST/GraphQL endpoints, server-side validation, authentication, migrations, and backend logic. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (defining APIs, database schemas, server logic, authentication, migrations) and 'when' with an explicit 'Use quando' clause and a dedicated 'Trigger em' list providing specific activation keywords. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including both general terms ('API', 'endpoint', 'banco de dados', 'backend', 'servidor') and specific technologies ('JWT', 'Prisma', 'PostgreSQL', 'Node.js', 'Express', 'NestJS', 'ORM'). These are terms users would naturally use when requesting backend work. | 3 / 3 |
Distinctiveness Conflict Risk | While the backend focus is clear, terms like 'API', 'banco de dados', and 'validação' could overlap with frontend API consumption skills, database administration skills, or full-stack skills. The scope is broad enough ('qualquer lógica de backend') that it could conflict with more specialized backend skills. | 2 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive backend development skill with excellent actionability — the code examples are concrete, executable, and cover the full stack from database schema to middleware to services. Its main weaknesses are verbosity (too much inline content that could be referenced) and a lack of an overarching development workflow with validation checkpoints. Some meta-sections (Integração com Pipeline, Código Limpo) add little value for Claude.
Suggestions
Move the large code examples (Prisma schema, middleware patterns, service pattern, Zod validators) into docs/skill-guides/backend-api.md and keep only brief summaries with references in SKILL.md to improve conciseness and progressive disclosure.
Add an explicit end-to-end workflow for creating a new backend feature (e.g., 1. Define schema → 2. Create migration → 3. Validate migration → 4. Implement service → 5. Add endpoints → 6. Run tests → 7. Handoff) with validation checkpoints at each step.
Remove or significantly trim low-value sections like 'Código Limpo', 'Integração com Pipeline', and 'Quando Não Usar' — these explain things Claude already knows or are better handled by the referenced policy files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains substantial useful content but is quite long (~300+ lines). Some sections like 'Quando Usar/Não Usar', 'Entradas/Saídas Esperadas', 'Evidencia de Conclusao', 'Código Limpo', and 'Integração com Pipeline' add marginal value and could be trimmed. The anti-rationalization table, while useful, adds bulk. However, the code examples themselves are lean and purposeful. | 2 / 3 |
Actionability | The skill provides fully executable, copy-paste ready code examples throughout: Prisma schema, Zod validators, Express middleware for validation/auth/error handling, a base service pattern, and concrete API endpoint patterns. The auth flow is step-by-step with specific implementation details. The migration strategy includes a concrete checklist. | 3 / 3 |
Workflow Clarity | The authentication flow is clearly sequenced with numbered steps, and the migration strategy includes a good zero-downtime checklist with rollback instructions. However, there's no overall workflow for creating a new backend feature end-to-end (e.g., define schema → create migration → validate migration → implement service → add endpoints → test → handoff). The migration section mentions testing in staging but lacks explicit validation checkpoints for the broader development process. | 2 / 3 |
Progressive Disclosure | The skill references external files well (GLOBAL.md, various policies, docs/skill-guides/backend-api.md) and mentions consulting the guide 'apenas quando necessario'. However, the SKILL.md itself is quite long with extensive inline code examples that could be split into referenced files. The Prisma schema, middleware patterns, and service patterns could live in separate reference files, keeping the SKILL.md as a concise overview. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
d87ad31
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.