CtrlK
BlogDocsLog inGet started
Tessl Logo

backend-expert

Implements FastAPI endpoints, creates SQLAlchemy 2.0 async models, generates idempotent Alembic migrations, structures bounded contexts following DDD (domain→infrastructure→application→api), and produces typed Pydantic v2 DTOs. Runs inside Docker (visionarias_brain_dev). Use when: 'create an endpoint', 'modify the backend', 'create a new entity', 'update a service', 'database logic', 'fix a backend bug', 'add a migration', 'create a repository', 'agrega un campo', 'nueva ruta API', 'corrige el servicio', or any Python/FastAPI/SQLAlchemy/Alembic task.

74

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered SOP: task-typed workflows with RED-first TDD gates, exact commands and paths, executable code patterns, and clean one-level-deep reference files. Remaining issues are small — a broken relative link path and duplicated reference/checklist listings that cost tokens and split navigation.

Suggestions

Fix the link to runtime-quality-checklist.md: change '[runtime-quality-checklist.md](backend-expert/references/runtime-quality-checklist.md)' to a plain relative path 'references/runtime-quality-checklist.md' so the link resolves from the skill bundle.

Consolidate 'Referencias (leer solo cuando aplique)' and 'Project invariants (read on demand)' into a single reference section — both list files in references/ and the duplication (especially the double mandatory-checklist callout) costs tokens and splits navigation.

Tighten the duplicated OBLIGATORIO emphasis: state the 'read before commit and before spawn auditor' rule once, next to the single link to runtime-quality-checklist.md, instead of repeating the full rationale in both the checklist section and the invariants section.

DimensionReasoningScore

Conciseness

The body is dense and telegraphic — no concept explanations, just directives — but it duplicates guidance: references/runtime-quality-checklist.md is mandated twice (once as a link in the checklist section, again under 'Project invariants'), both times with 'OBLIGATORIO antes commit y spawn auditor', and the 'Referencias' and 'Project invariants' sections overlap in purpose. This fits anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') rather than 5's 'every token earns its place'.

4 / 5

Actionability

Guidance is fully executable throughout: exact commands ('make extraction-contract', 'cd backend && .venv/bin/pytest tests/architecture/test_extraction_contract.py -x -q', 'make arch-test'), exact paths (docs/domains/INDEX.md, backend/src/modules/{nombre}/), and complete copy-paste code for the SQLAlchemy 2.0 query, Pydantic v2 DTO, and idempotent Alembic migration patterns, each with correct vs. prohibited contrasts. This matches anchor 5's 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The SOP sequences work explicitly: locate module → explore code → task-type procedure, with three distinct procedures (new features inside-out, modifications code-first, bugs outside-in). Validation is built in as explicit RED-first feedback loops ('escribir test que falla (RED) antes de implementar', 'NO corregir hasta tener test rojo'), a mandatory pre-commit runtime checklist, and enforced architecture tests ('El test arquitectural falla si saltas estos pasos'). This matches anchor 5 — clear sequence, explicit validation, feedback loops, and checklists — including for the database/migration operations the rubric flags as needing them.

5 / 5

Progressive Disclosure

The body is a proper overview that pushes detail into references/ ('Referencias (leer solo cuando aplique)' and 'Project invariants (read on demand)'), and all 10 referenced files exist exactly one level deep in the bundle. Two minor gaps keep it from anchor 5: the runtime-quality-checklist link uses a malformed path ('backend-expert/references/runtime-quality-checklist.md' with a stray skill-name prefix instead of a plain relative path), and reference listings are split across two overlapping sections rather than one navigable index.

4 / 5

Total

18

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it enumerates concrete, comprehensive capabilities in third person and pairs them with an explicit, bilingual 'Use when:' trigger clause. The only weakness is the generic 'any Python… task' catch-all, which slightly raises conflict risk with general Python skills.

DimensionReasoningScore

Specificity

The description lists five concrete, distinct capabilities covering the full backend stack — 'Implements FastAPI endpoints, creates SQLAlchemy 2.0 async models, generates idempotent Alembic migrations, structures bounded contexts following DDD (domain→infrastructure→application→api), and produces typed Pydantic v2 DTOs'. This matches the anchor 'multiple specific concrete actions; comprehensive coverage' — no meaningful gaps remain for this domain.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' is the concrete capability list, and the 'when' is an explicit 'Use when:' clause followed by concrete trigger phrases and a stack catch-all. This is exactly the anchor-5 pattern exemplified by 'Extract text and tables from PDF files... Use when working with PDF files or when the user mentions PDFs'.

5 / 5

Trigger Term Quality

Trigger phrases are natural user utterances with broad synonym coverage in two languages: 'create an endpoint', 'modify the backend', 'create a new entity', 'update a service', 'database logic', 'fix a backend bug', 'add a migration', 'create a repository', 'agrega un campo', 'nueva ruta API', 'corrige el servicio', plus the stack names themselves. This matches the top anchor's 'comprehensive coverage of natural terms including synonyms'.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — this project's FastAPI/SQLAlchemy/Alembic backend inside a named Docker container — and triggers are distinct from frontend/data/admin skills. However the trailing catch-all 'or any Python/FastAPI/SQLAlchemy/Alembic task' is broad enough to grab general Python work unrelated to this backend, so overlap risk is minor rather than minimal — fitting anchor 4, not 5.

4 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing, 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository
alpacapurpura/luana-method
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.