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.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Failed to scan

The risk profile of this skill

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.

The body is well-structured with executable examples, a sequenced workflow with validation checkpoints, and clean progressive disclosure into real reference files. Minor trimming of the redundant Knowledge Reference and Output Templates sections, plus an explicit migration error-recovery loop, would raise it further.

Suggestions

Remove or merge the 'Knowledge Reference' keyword list and 'Output Templates' section, which restate content already shown in the Minimal Working Example.

Add an explicit error-recovery loop for migrations (e.g., 'If makemigrations fails, fix model fields and re-run before proceeding') to strengthen the workflow's feedback loop.

Tighten the 'When to Use This Skill' list, which overlaps heavily with the frontmatter description, to avoid duplicated guidance.

Dimension	Reasoning	Score
Conciseness	Mostly lean with executable examples, but the 'Knowledge Reference' keyword dump and 'Output Templates' section restate information already demonstrated by the working example and could be trimmed. Not a 5 because of these minor padded sections; not a 3 because the bulk is efficient and assumes Claude's competence.	4 / 5
Actionability	Fully executable, copy-paste-ready code for models, serializers, viewsets, and tests, plus concrete commands (`manage.py makemigrations`, `APITestCase`, `curl`) covering the common Django/DRF cases.	5 / 5
Workflow Clarity	Six clearly sequenced steps with explicit validation checkpoints ('verify schema before proceeding', 'Confirm each endpoint return expected status codes ... before adding auth'). Not a 5 because there is no explicit error-recovery feedback loop (validate -> fix -> re-validate) for the migration/destructive steps.	4 / 5
Progressive Disclosure	A clear Reference Guide table points to one-level-deep, real reference files (models-orm.md, drf-serializers.md, viewsets-views.md, authentication.md, testing-django.md — all present) with 'Load When' guidance, keeping the overview concise while details live in separate files.	5 / 5
	Total	18 / 20 Passed

Description

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

The description is exemplary: third-person voice, concrete capabilities, explicit 'Use when'/'Invoke when' trigger guidance, and a comprehensive trigger-term list. It clearly distinguishes the skill from adjacent Python web skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('Creates Django models with proper indexes, optimizes ORM queries using select_related/prefetch_related, builds DRF serializers and viewsets, and configures JWT authentication') with comprehensive coverage of the Django/DRF domain.	5 / 5
Completeness	Explicitly answers both 'what' (creates models, optimizes queries, builds serializers/viewsets, configures JWT) and 'when' ('Use when building Django web applications...', 'Invoke when working with settings.py, models.py, manage.py') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Provides comprehensive natural trigger terms including synonyms and file names ('Django, DRF, Django REST Framework, Django ORM, Django model, serializer, viewset, Python web' plus settings.py, models.py, manage.py) that users would naturally say.	5 / 5
Distinctiveness Conflict Risk	Clear Django/DRF niche with distinct triggers and minimal conflict risk; the broad 'Python web' term is the only minor overlap but the surrounding Django-specific triggers keep it well-scoped.	5 / 5
	Total	20 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: jeffallan/claude-skills
Path: skills/django-expert/SKILL.md
Commit: 882ef55

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.