CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

django-expert

Use when building Django web applications or REST APIs with Django REST Framework. Invoke when working with settings.py, models.py, manage.py, or any Django project file. Creates Django models with proper indexes, optimizes ORM queries using select_related/prefetch_related, builds DRF serializers and viewsets, and configures JWT authentication. Trigger terms: Django, DRF, Django REST Framework, Django ORM, Django model, serializer, viewset, Python web.

74

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

Well-structured content: an executable example that demonstrates the stated MUST DO constraints, a sequenced workflow with validation gates, and clean one-level progressive disclosure into five real reference files. The main improvements are trimming the redundant keyword/when-to-use sections and adding explicit error-recovery loops around the migration and validation steps.

Suggestions

Remove the 'Knowledge Reference' keyword list and merge 'When to Use This Skill' into the opening line — both duplicate information Claude already has (the frontmatter description and general Django knowledge), trimming tokens without losing guidance (addresses conciseness).

Add an explicit error-recovery loop to Core Workflow steps 2 and 4, e.g., 'If makemigrations fails or the schema check is wrong, fix the model and re-run before proceeding' and 'If an endpoint returns an unexpected status, fix it before adding auth' (addresses workflow_clarity).

Drop the 'Output Templates' section or fold its four bullets into the workflow's final step — it repeats constraints already stated in MUST DO and the example.

DimensionReasoningScore

Conciseness

The body is mostly lean — a tight workflow, a purposeful code example, and constraint lists — but the "Knowledge Reference" keyword list ("Django 5.0, DRF, async views, ORM, QuerySet, select_related...") restates concepts Claude already knows, and "When to Use This Skill" duplicates the frontmatter description. These are minor instances of padding that could be trimmed, fitting anchor 4 rather than 3 (no concept explanations or verbose prose).

4 / 5

Actionability

The "Minimal Working Example" is complete, executable, copy-paste-ready code spanning models.py, serializers.py, views.py, and tests.py for the canonical CRUD case, and the workflow cites concrete commands ("manage.py makemigrations", "APITestCase or curl check"). This matches the anchor for fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

Six clearly ordered steps with explicit checkpoints: "run makemigrations and migrate; verify schema before proceeding" and "Confirm each endpoint returns expected status codes with a quick APITestCase or curl check before adding auth". This fits anchor 4 (clear sequence, most checkpoints present); it falls short of 5 because there is no explicit fix-and-retry error-recovery loop, a notable gap given the database migration steps.

4 / 5

Progressive Disclosure

The Reference Guide table maps each topic to a real file (all five paths in references/ exist: models-orm.md, drf-serializers.md, viewsets-views.md, authentication.md, testing-django.md) with explicit "Load When" conditions, one level deep with no nested references. SKILL.md stays an overview plus a minimal example while details live in the bundle — a clear match for the top anchor.

5 / 5

Total

18

/

20

Passed

Description

96%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: concrete, third-person action list with specific API names, explicit 'Use when' triggers including project file names, and a dedicated trigger-term list with synonyms. The only weakness is the generic 'Python web' trigger, which creates minor conflict risk with other Python web framework skills.

DimensionReasoningScore

Specificity

"Creates Django models with proper indexes, optimizes ORM queries using select_related/prefetch_related, builds DRF serializers and viewsets, and configures JWT authentication" lists four concrete actions naming specific APIs (select_related/prefetch_related, JWT), covering models, ORM, API layers, and auth. This matches the anchor for multiple specific concrete actions with comprehensive coverage rather than score 4, since no meaningful capability in the skill's domain is left unmentioned.

5 / 5

Completeness

Explicit 'when' guidance ("Use when building Django web applications or REST APIs with Django REST Framework. Invoke when working with settings.py, models.py, manage.py, or any Django project file") is paired with an explicit 'what' (the four concrete actions). Both questions are answered clearly and concretely, matching the anchor example structure exactly.

5 / 5

Trigger Term Quality

Trigger terms "Django, DRF, Django REST Framework, Django ORM, Django model, serializer, viewset, Python web" include both the abbreviation and full-name synonyms plus file-level triggers ("settings.py, models.py, manage.py"). This matches the anchor for comprehensive natural-term coverage including synonyms and file extensions; score 4 would require identifiable missing natural terms, and users needing this skill would naturally say these words.

5 / 5

Distinctiveness Conflict Risk

Django/DRF triggers form a clear niche, but "Python web" and "serializer" are broad enough to overlap with closely related Python web skills (e.g., a FastAPI skill). This fits 'mostly distinct; minor overlap risk with closely related skills'; not 5 because the generic 'Python web' trigger term is not Django-specific.

4 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Jeffallan/claude-skills

Path

skills/django-expert/SKILL.md

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.