CtrlK
BlogDocsLog inGet started
Tessl Logo

django-patterns

Django architecture patterns, REST API design with DRF, ORM best practices, caching, signals, middleware, and production-grade Django apps. Use when building or reviewing Django apps, DRF APIs, ORM queries, or caching.

60

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/django-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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-organized, mostly executable Django pattern catalog whose main costs are token weight and structure: heavy standard-boilerplate code, everything inlined in one large file with no references, and no validation checkpoints despite covering batch database operations. Strongest on actionability, weakest on conciseness and workflow.

Suggestions

Trim code Claude already knows — the default INSTALLED_APPS/MIDDLEWARE lists, the stock AbstractUser example, and the N+1 explanation — to roughly halve token cost while keeping the project-specific patterns (split settings, service layer, custom QuerySet).

Split the DRF serializer/ViewSet, caching, and signals/middleware pattern catalogs into reference files (e.g. references/drf.md, references/caching.md) and keep SKILL.md as a short overview with clearly signaled links.

Add validation checkpoints to the database-related workflows: after model changes run `python manage.py makemigrations --check` and `python manage.py check`, and verify row counts after bulk_create/bulk_update operations before proceeding.

DimensionReasoningScore

Conciseness

Prose is lean, but the ~735-line body includes substantial boilerplate Claude already knows — the full default INSTALLED_APPS/MIDDLEWARE stacks, a stock AbstractUser subclass, and textbook select_related/prefetch_related examples — so 'mostly efficient but includes some unnecessary explanation or could be tightened' fits. Not 4 because the redundant standard-settings and default-middleware code is more than a minor trim, and not 2 because there is little padded prose or concept explanation.

3 / 5

Actionability

Most patterns are concrete, copy-paste-ready code (custom QuerySet chaining, serializer validation, ViewSet actions, low-level cache get/set). It misses 5 because several snippets are not executable as written: undefined `env()`, `slugify`, `timezone`, `logger`, `Count`, `Cart`/`PaymentGateway`, and `# ... fields ...` placeholders — 'concrete code or commands with minor gaps'.

4 / 5

Workflow Clarity

This is a pattern catalog with clear topical sections but no sequenced workflow and no validation checkpoints — after model changes nothing says to run `manage.py makemigrations --check`/`check`, and the bulk-operations section (bulk_create/bulk_update/bulk delete) includes no verification step, which caps workflow clarity at 3 per the batch-operations guideline. Not 2 because each pattern is internally coherent and clearly scoped; not 4 because checkpoints are absent entirely, not just minor.

3 / 5

Progressive Disclosure

Section headers, a Quick Reference table, and code comments make the file navigable, but everything lives in one ~735-line SKILL.md with no bundle files — the DRF serializer/ViewSet patterns, caching strategies, and signals/middleware sections are each substantial enough to be separate reference files, i.e. 'content that should be separate is inline'. Not 4 because at this size the split isn't a minor organization gap; not 2 because the internal structure is far from the header-less inline dump of the 2-anchor example.

3 / 5

Total

13

/

20

Passed

Description

87%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: third-person, concrete, with an explicit 'Use when...' trigger clause listing natural terms. Minor room to sharpen the 'what' with action verbs and add a few synonyms, but it clearly answers what and when with low conflict risk.

DimensionReasoningScore

Specificity

The description names the domain and several concrete capability areas — 'REST API design with DRF, ORM best practices, caching, signals, middleware' — giving specific, actionable coverage. It falls short of the 5 anchor because the items are topic names rather than concrete actions (e.g. 'ORM best practices' rather than 'optimize N+1 queries'), a pattern the 5-anchor examples ('Extract text and tables... fill forms, merge documents') follow with explicit verbs.

4 / 5

Completeness

It explicitly answers both questions: a clear 'what' ('Django architecture patterns, REST API design with DRF, ORM best practices, caching, signals, middleware, and production-grade Django apps') and a concrete trigger clause ('Use when building or reviewing Django apps, DRF APIs, ORM queries, or caching'), matching the 5 anchor's structure exactly. Not 4 because the 'when' is as explicit and specific as the anchor example, not merely adequate.

5 / 5

Trigger Term Quality

'building or reviewing Django apps, DRF APIs, ORM queries, or caching' covers the natural phrases a user would say. It misses the 5 anchor because there are no synonyms or variations beyond the core terms (e.g. 'Python web app', 'Django REST Framework' spelled out alongside DRF appears only in the what-clause, not the trigger clause).

4 / 5

Distinctiveness Conflict Risk

Django/DRF/ORM is a clear, well-defined niche with distinct technical triggers; a user needing this skill would say these exact words, and it would not fire for non-Django work. Minimal conflict risk with other framework or language skills.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository
affaan-m/ECC
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.