Django架构模式、使用DRF的REST API设计、ORM最佳实践、缓存、信号、中间件以及生产级Django应用程序。
65
48%
Does it follow best practices?
Impact
96%
1.41xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./docs/zh-CN/skills/django-patterns/SKILL.mdQuality
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 identifies Django-related topics but reads more like a feature list than actionable skill guidance. It lacks concrete actions (what the skill does) and completely omits trigger conditions (when to use it). The Chinese language is appropriate if the target users are Chinese-speaking, but the description needs restructuring to be effective for skill selection.
Suggestions
Add an explicit 'Use when...' clause specifying trigger conditions, e.g., '当用户提到Django项目、DRF API开发、Django ORM优化时使用'
Convert topic areas into concrete actions, e.g., '设计Django REST API、优化ORM查询、配置缓存策略、实现中间件'
Include natural language variations users might say, such as 'Django项目', 'Python后端', 'Web应用开发'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Django) and lists several specific areas (DRF REST API design, ORM best practices, caching, signals, middleware), but these are topic areas rather than concrete actions the skill performs. | 2 / 3 |
Completeness | Describes what topics the skill covers but completely lacks any 'Use when...' clause or explicit trigger guidance. The 'when' component is entirely missing. | 1 / 3 |
Trigger Term Quality | Includes relevant technical keywords like 'Django', 'DRF', 'REST API', 'ORM', 'middleware' that users might mention, but lacks common variations and natural language triggers like 'web app', 'backend', 'Python web framework'. | 2 / 3 |
Distinctiveness Conflict Risk | Django-specific focus provides some distinctiveness, but could overlap with general Python skills, web development skills, or API design skills. The broad scope ('production-grade Django applications') increases conflict risk. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive Django patterns reference with excellent, production-ready code examples covering models, DRF, services, caching, signals, and middleware. The main weaknesses are its monolithic structure (could benefit from splitting into focused sub-documents) and lack of explicit workflow guidance with validation steps. The content is actionable but could be more concise by trimming basic Django concepts.
Suggestions
Split the content into separate focused files (e.g., MODELS.md, DRF_PATTERNS.md, CACHING.md, PERFORMANCE.md) and make SKILL.md an overview with navigation links
Add explicit workflow sequences for common tasks like 'Setting up a new Django app' or 'Adding a new API endpoint' with validation checkpoints
Trim verbose sections - remove basic Meta class explanations and standard field configurations that Claude already knows
Add a 'Common Pitfalls' section with validation/debugging steps for issues like N+1 queries or migration conflicts
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some verbose sections. The project structure and settings examples are thorough but could be trimmed. Some patterns like the basic model examples explain concepts Claude likely knows (e.g., basic Meta class options, standard field types). | 2 / 3 |
Actionability | Excellent executable code throughout - all examples are copy-paste ready with complete imports, proper class definitions, and realistic field configurations. The code covers models, serializers, viewsets, services, caching, signals, and middleware with fully functional examples. | 3 / 3 |
Workflow Clarity | The skill presents patterns and code examples but lacks explicit workflow sequences with validation checkpoints. For example, the service layer shows transaction.atomic but doesn't provide a step-by-step workflow for implementing services or validating the integration. No explicit 'do this, then validate, then proceed' patterns. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear section headers and a quick reference table at the end. However, this is a monolithic document (~500 lines) that could benefit from splitting into separate files (e.g., MODELS.md, DRF.md, CACHING.md) with the main skill providing an overview and navigation. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 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 | 10 / 11 Passed | |
ae2cadd
Table of Contents
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.