CtrlK
BlogDocsLog inGet started
Tessl Logo

django-patterns

Django架构模式,使用DRF设计REST API,ORM最佳实践,缓存,信号,中间件,以及生产级Django应用程序。

43

Quality

31%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./docs/zh-CN/skills/django-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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

The description provides a reasonable topic-level overview of Django-related areas but lacks concrete action verbs describing what the skill does and completely omits any 'Use when...' guidance for skill selection. It reads as a feature list rather than a functional description, and being written in Chinese without explicit trigger clauses makes it harder for Claude to reliably select this skill in the right contexts.

Suggestions

Add an explicit 'Use when...' clause with trigger terms, e.g., 'Use when the user asks about Django projects, DRF APIs, Django models, views, serializers, middleware, or production Django deployment.'

Replace the topic list with concrete action verbs describing what the skill does, e.g., 'Designs REST APIs using Django REST Framework, implements ORM queries and model relationships, configures caching strategies, creates custom middleware and signals.'

Consider writing the description in English (or bilingual) to maximize matching with user queries, and include common variations like 'Django REST framework', 'Django models', 'Django views', 'serializers', 'queryset optimization'.

DimensionReasoningScore

Specificity

The description names the domain (Django) and lists several specific areas like DRF REST API design, ORM best practices, caching, signals, middleware, and production-grade Django apps. However, it reads more like a topic list than concrete actions — it doesn't use action verbs describing what the skill actually does (e.g., 'designs', 'implements', 'configures').

2 / 3

Completeness

The description only addresses 'what' (and even that is more of a topic list than clear capabilities). There is no 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill, which per the rubric should cap completeness at 2 — and since the 'what' is also weak (topic list, not actions), it falls to 1.

1 / 3

Trigger Term Quality

Contains relevant keywords like 'Django', 'DRF', 'REST API', 'ORM', 'caching', 'signals', 'middleware' that users might mention. However, it misses common variations and natural language terms users would say, such as 'Django project', 'Django views', 'serializers', 'models', 'migrations', 'deployment', or 'Django REST framework' (spelled out).

2 / 3

Distinctiveness Conflict Risk

The Django/DRF focus provides some distinctiveness, but the broad scope covering architecture, ORM, caching, signals, and middleware could overlap with general Python skills, web development skills, or database skills. The lack of explicit trigger boundaries increases conflict risk.

2 / 3

Total

7

/

12

Passed

Implementation

29%

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

This skill is essentially a Django/DRF cheat sheet that dumps extensive boilerplate code Claude already knows into a single massive file. While the code examples are high quality and executable, the skill fails on conciseness (explaining standard Django patterns at length), workflow clarity (no sequenced processes or validation checkpoints), and progressive disclosure (everything crammed into one file with no external references). It would be far more effective as a brief overview pointing to topic-specific reference files, focusing only on project-specific conventions rather than general Django knowledge.

Suggestions

Reduce content by 70-80% by removing patterns Claude already knows (basic settings, standard model fields, N+1 prevention) and focus only on project-specific conventions and non-obvious decisions.

Split into separate files (models.md, drf-patterns.md, caching.md, performance.md) with SKILL.md serving as a concise overview with clear navigation links.

Add workflow sequences with validation checkpoints for multi-step operations like 'setting up a new app', 'adding a new API endpoint', or 'deploying to production'.

Replace the quick reference table with actionable decision trees (e.g., 'When to use select_related vs prefetch_related' as a brief rule, not a full code example).

DimensionReasoningScore

Conciseness

Extremely verbose at ~500+ lines. Much of this is boilerplate Django code that Claude already knows (settings files, basic model definitions, standard serializer patterns, N+1 query prevention). The skill explains fundamental Django concepts rather than providing novel, project-specific guidance. The closing sentence 'Django provides many shortcuts...' is unnecessary filler.

1 / 3

Actionability

The code examples are concrete, executable, and copy-paste ready. Every pattern includes complete, runnable Python code with proper imports, class definitions, and usage examples. The project structure is clearly laid out with specific file paths.

3 / 3

Workflow Clarity

There are no sequenced multi-step workflows with validation checkpoints. The skill is a reference catalog of patterns rather than a guided process. For operations like bulk updates or order processing with transactions, there are no verification steps or error recovery guidance. The content reads as a collection of code snippets without clear workflow sequencing.

1 / 3

Progressive Disclosure

The entire skill is a monolithic wall of code examples with no references to external files. All content is inline in a single massive document. There are no bundle files, and the content would greatly benefit from splitting into separate files (e.g., models.md, drf.md, caching.md, performance.md) with a concise overview in SKILL.md.

1 / 3

Total

6

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
affaan-m/everything-claude-code
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.