CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

The canonical home for this skill is backend-expert in alpacapurpura/luana-method

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 strong, highly actionable SOP: three well-sequenced workflows with mandatory validation gates, executable code patterns, and genuine one-level-deep progressive disclosure into a real references/ bundle. Weaknesses are cosmetic — duplicated reference/checklist listings and one broken link path.

Suggestions

Merge the 'Referencias (leer solo cuando aplique)' and 'Project invariants (read on demand)' sections into a single reference list; both enumerate the same references/ directory and the runtime-quality checklist is flagged OBLIGATORIO twice, which dilutes the signal.

Fix the runtime-quality-checklist link path: it points to 'backend-expert/references/runtime-quality-checklist.md' but the file lives at 'references/runtime-quality-checklist.md' relative to the skill.

Consider trimming the ETL warning block's repetition (e.g., 'No es opcional' after already saying the steps are OBLIGATORIOS and the test fails if skipped) to tighten token usage.

DimensionReasoningScore

Conciseness

The body is dense and imperative with zero concept explanations Claude already knows — every section carries project-specific signal (layer order, forbidden syntax, exact commands). It falls short of the top anchor because references are listed twice ('Referencias (leer solo cuando aplique)' and 'Project invariants (read on demand)' both enumerate reference files) and the runtime-quality checklist is flagged OBLIGATORIO in two separate sections, padding that could be merged.

4 / 5

Actionability

Guidance is fully executable: exact commands ('make extraction-contract', 'cd backend && .venv/bin/pytest tests/architecture/ -x -q', 'make arch-test'), copy-paste-ready code for SQLAlchemy 2.0 (correct vs prohibited), a typed Pydantic v2 DTO, and idempotent raw-SQL Alembic migrations. Concrete commands cover the common cases of each task type.

5 / 5

Workflow Clarity

Three task types each have a clearly sequenced workflow with explicit validation checkpoints: TDD RED tests required per layer before implementation ('escribir test que falla (RED) antes de implementar. Orden: domain → infra → app'), bugs require 'test de regresión que reproduce el bug (DEBE fallar RED). NO corregir hasta tener test rojo', and the ETL block mandates post-implementation verification with an architectural test that 'falla si saltas estos pasos'. Fitness tests and the pre-commit checklist close the loop.

5 / 5

Progressive Disclosure

Good structure: the SKILL.md is an overview with one-level-deep references, all listed files exist in references/ (architecture-rules.md, database.md, testing.md, standards.md, runtime-quality-checklist.md, backend-quality.md, etc.), and 'leer solo cuando aplique' / 'read on demand' signal when to load each. Minor gaps: the runtime-quality-checklist link uses a broken path ('backend-expert/references/runtime-quality-checklist.md' instead of references/), and the two separate reference sections could be consolidated for easier navigation.

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.

An excellent description: third-person voice, five concrete capabilities, an explicit bilingual 'Use when' trigger list, and a distinct backend stack niche. The only weakness is the broad 'any Python/FastAPI/SQLAlchemy/Alembic task' catch-all, which creates minor conflict risk with other Python skills.

DimensionReasoningScore

Specificity

The description lists five concrete, non-overlapping actions — 'Implements FastAPI endpoints, creates SQLAlchemy 2.0 async models, generates idempotent Alembic migrations, structures bounded contexts following DDD', 'produces typed Pydantic v2 DTOs' — with no vague filler. Coverage of the skill's scope is comprehensive, matching the top anchor for multiple specific concrete actions.

5 / 5

Completeness

It explicitly answers 'what' (five concrete capabilities plus the runtime environment 'Runs inside Docker (visionarias_brain_dev)') and 'when' via an explicit 'Use when:' clause with a dozen concrete trigger phrases. This matches the anchor example of clearly answering both what and when.

5 / 5

Trigger Term Quality

Trigger phrases are natural user utterances in two languages ('create an endpoint', 'fix a backend bug', 'add a migration', 'agrega un campo', 'nueva ruta API') plus technology-name variants ('any Python/FastAPI/SQLAlchemy/Alembic task'), covering synonyms comprehensively. A user asking for any of these would naturally phrase it this way.

5 / 5

Distinctiveness Conflict Risk

The stack-specific niche (FastAPI/SQLAlchemy 2.0/Alembic/DDD bounded contexts, a named Docker runtime) is clearly distinct, but the trailing catch-all 'or any Python/FastAPI/SQLAlchemy/Alembic task' broadens it to overlap with any other Python-related skill. It is mostly distinct with minor overlap risk, not the minimal-conflict top anchor.

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/ap_sales_agent

Path

.claude/skills/backend-expert/SKILL.md

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.