backend-expert

Especialista Senior en Python, FastAPI y Domain-Driven Design (DDD) para backend. Úsalo cuando necesites crear endpoints, modificar lógica de negocio, diseñar entidades, actualizar servicios o trabajar con bases de datos.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

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

The body is a well-organized senior-backend SOP with concrete conventions and real reference files, but it inlines sizable technical rule blocks and omits explicit validation feedback loops for destructive/batch operations. Adding verification checkpoints and offloading more rules to the existing references would raise the score.

Suggestions

Add explicit validation steps to each procedure (e.g. run regression tests after a migration, verify DTO compatibility after a refactor) to provide feedback loops for destructive/batch operations.

Move detailed guardrails and SQLAlchemy/Alembic syntax rules into the reference files, keeping SKILL.md as a concise overview pointer.

Reference the existing standards.md from the 'Base de Conocimiento' section so all bundle files are reachable and discoverable.

Dimension	Reasoning	Score
Conciseness	Mostly efficient role/SOP/guardrails content that does not re-explain basic programming concepts, with only minor padding ('para mantener este prompt ágil', heavy bold emphasis) that could be trimmed.	4 / 5
Actionability	Provides concrete file-path conventions (e.g. 'domain/entity.py', 'repositories/[nombre]_repository.py', 'session.execute(select(Model))') and a clear layer pipeline, but lacks full copy-paste executable code examples.	4 / 5
Workflow Clarity	Three clearly sequenced procedures exist, but workflows involving destructive/batch operations (migrations, soft-delete enforcement) lack explicit validation checkpoints or feedback loops, which caps workflow clarity per the rubric.	3 / 5
Progressive Disclosure	Well-structured with one-level-deep references to real bundle files (architecture-rules.md, database.md, testing.md); however, substantial technical rules are inlined in the body and standards.md is present but unreferenced.	4 / 5
	Total	15 / 20 Passed

Description

92%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 that clearly states the skill's domain, lists concrete capabilities, and provides explicit 'use when' trigger guidance. The only minor gap is that trigger phrasing mirrors the skill's verbs rather than capturing the full range of synonyms a user might spontaneously say.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('crear endpoints', 'modificar lógica de negocio', 'diseñar entidades', 'actualizar servicios', 'trabajar con bases de datos') with comprehensive coverage of the backend domain.	5 / 5
Completeness	Explicitly answers both 'what' (Senior specialist in Python, FastAPI, DDD for backend) and 'when' ('Úsalo cuando necesites...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	'Úsalo cuando necesites crear endpoints, modificar lógica de negocio...' provides natural trigger phrases a user would say, though framed around the skill's own verbs rather than raw user-utterance synonyms.	4 / 5
Distinctiveness Conflict Risk	Clear niche (FastAPI + DDD backend) with distinct triggers and minimal conflict risk against unrelated skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
relative_links	Relative link issues: 3 missing, 3 deeper-than-1-level	Warning

	Total	15 / 16 Passed

Repository: alpacapurpura/ap_sales_agent
Path: .agents/skills/backend-expert/SKILL.md
Commit: d31f7bc

Reviewed: ~19 hours ago

Table of Contents

Discovery Implementation Validation

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.