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".
60
71%
Does it follow best practices?
Impact
—
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
100%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 comprehensive trigger terms. It includes both an explicit 'Use when' clause and a detailed trigger term list, making it easy for Claude to select appropriately. The only minor note is the use of Portuguese, but the structure and content quality are excellent.
| 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 detailed '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 | Clearly scoped to backend development with distinct triggers like 'migration', 'ORM', 'Prisma', 'middleware', 'JWT', and 'server-side validation' that are unlikely to conflict with frontend, DevOps, or other skill domains. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill excels at actionability with comprehensive, executable code examples covering the full backend stack, but severely suffers from verbosity — it inlines hundreds of lines of code that Claude largely already knows how to write. The content would benefit enormously from moving detailed implementations to referenced files and keeping only project-specific conventions and patterns in the main SKILL.md. The workflow aspects are adequate but lack explicit validation checkpoints for the development process.
Suggestions
Move the full code examples (middleware, services, validators, better-sqlite3 alternative stack) into referenced files like `docs/skill-guides/backend-api.md` and keep only conventions, response format contracts, and project-specific decisions in SKILL.md.
Remove explanations of patterns Claude already knows (base CRUD services, JWT auth mechanics, Zod usage) and replace with only project-specific conventions and deviations from standard patterns.
Add an explicit development workflow with validation checkpoints, e.g.: '1. Define schema → 2. Run `npx prisma validate` → 3. Create migration → 4. Implement endpoints → 5. Run tests → 6. Generate OpenAPI docs'.
Consolidate the anti-rationalization table and governance references into a shorter section or move to a referenced policy file to reduce token overhead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~350+ lines, inlining extensive code examples for schemas, middleware, services, validators, and an entire alternative stack (better-sqlite3) that could easily be in referenced files. It explains many patterns Claude already knows (base CRUD services, JWT auth flows, Zod validation) in full detail rather than providing only project-specific conventions. | 1 / 3 |
Actionability | The skill provides fully executable, copy-paste-ready code examples throughout — Prisma schemas, Zod validators, Express middleware, service patterns, SQLite repositories, and migration scripts. Endpoint patterns, response formats, and auth flows are all concrete and specific. | 3 / 3 |
Workflow Clarity | The auth flow and migration strategy have clear sequential steps, and the zero-downtime migration checklist is well-structured with a rollback step. However, there are no explicit validation checkpoints for the main development workflow (e.g., 'run tests after creating endpoints', 'validate schema before migrating'), and the overall process of going from inputs to outputs lacks a sequenced workflow with feedback loops. | 2 / 3 |
Progressive Disclosure | The skill references `docs/skill-guides/backend-api.md` for extended examples but then proceeds to inline massive amounts of code that should be in that referenced file. The entire alternative stack section (better-sqlite3), full middleware implementations, and service patterns are all inlined, creating a monolithic document. References to governance policies are listed but the content itself doesn't leverage progressive disclosure effectively. | 1 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (549 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
ec5fa71
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.