CtrlK
BlogDocsLog inGet started
Tessl Logo

backend-api

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

Quality

78%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/03-backend-api/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
felvieira/claude-skills-fv
Reviewed

Table of Contents

Is this your skill?

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.