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".

60

Quality

71%

Does it follow best practices?

Impact

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

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.

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 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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (549 lines); consider splitting into references/ and linking

Warning

Total

10

/

11

Passed

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.