django-patterns

Patrones de arquitectura Django, diseño de API REST con DRF, buenas prácticas de ORM, caché, señales, middleware y aplicaciones Django de nivel producción.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./docs/es/skills/django-patterns/SKILL.md

Quality

Content

65%

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

A highly actionable, code-rich Django patterns reference, but it is verbose (reproducing much boilerplate Claude already knows), lacks workflow validation checkpoints for its batch operations, and keeps everything in a single monolithic file.

Suggestions

Trim standard boilerplate Claude already knows (basic DRF serializer/viewset skeletons, the N+1 explanation) to focus the body on the project-specific conventions and decisions that are not obvious.

Add a validation/retry checkpoint around batch and destructive operations (e.g., dry-run or count-before-delete for bulk_delete, verify-then-commit for bulk_update).

Move the full settings catalog and the serializer/viewset reference into separate reference files (e.g. references/settings.md, references/drf.md) linked from a concise overview, so SKILL.md becomes a navigable index.

Dimension	Reasoning	Score
Conciseness	Prose is minimal and code-focused (good), but the ~730-line body reproduces a large catalog of standard Django/DRF boilerplate Claude already knows (serializer/viewset patterns, select_related/prefetch_related basics, index definitions) and includes explanatory N+1 and bulk-operation sections that could be tightened.	2 / 3
Actionability	It provides extensive complete, executable, copy-paste-ready code for models, querysets, managers, serializers, viewsets, services, caching, signals, and middleware with specific field-level details.	3 / 3
Workflow Clarity	This is a patterns catalog rather than a sequenced workflow, and it shows batch/destructive operations (bulk_update, bulk_delete) with no validation checkpoints or feedback loops, capping workflow clarity at 2.	2 / 3
Progressive Disclosure	No bundle files exist and all content lives inline in one large SKILL.md; sections are well-organized with headers and a quick-reference table, but reference material that could be split out (full settings, serializer/viewset catalogs) is monolithic and inline.	2 / 3
	Total	9 / 12 Passed

Description

72%

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 specific, well-targeted description with strong natural trigger terms, but it lacks an explicit 'Use when' activation clause and includes some fluffy phrasing that softens its specificity.

Suggestions

Add an explicit activation clause, e.g. 'Use when building Django web apps, designing DRF APIs, or working with Django ORM, caching, signals, or middleware.'

Reframe topic nouns as concrete actions ('design REST APIs with DRF', 'optimize ORM queries', 'implement caching') to lift specificity, and drop vague filler like 'best practices' and 'production-grade'.

Dimension	Reasoning	Score
Specificity	The description names the domain and several specific areas ('Django architecture patterns, REST API design with DRF, ORM best practices, caching, signals, middleware') but frames them as topic nouns rather than concrete actions, and pads with fluff like 'best practices' and 'production-grade Django apps'.	2 / 3
Completeness	It clearly answers 'what' the skill does but has no 'Use when...' clause or equivalent explicit trigger guidance, so per the rubric completeness is capped at 2.	2 / 3
Trigger Term Quality	It includes natural keywords a Django developer would actually say — 'Django', 'REST API', 'DRF', 'ORM', 'caching', 'signals', 'middleware' — giving good coverage of recognizable terms.	3 / 3
Distinctiveness Conflict Risk	The Django+DRF+ORM+signals+middleware framing carves out a clear niche unlikely to trigger for the wrong skill.	3 / 3
	Total	10 / 12 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
skill_md_line_count	SKILL.md is long (734 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: affaan-m/ECC
Path: docs/es/skills/django-patterns/SKILL.md
Commit: 0c1d7be

Reviewed: 3 days 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.