CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

django-project-starter

Scaffold a production-ready Django 5.x project with REST Framework, split settings, apps structure, and pytest-django.

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./backend-python/django-project-starter/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 highly actionable, well-sectioned scaffolding guide with complete executable code, undermined by a monolithic all-in-one-file structure and a workflow with sequencing gaps and no validation checkpoints. The scaffold command alone does not actually produce the documented project structure, leaving the user to manually assemble the Essential Patterns.

Suggestions

Re-sequence the scaffold into a correct, ordered workflow: install dependencies before 'django-admin startproject', explicitly write the split settings files (moving 'startproject''s settings.py content into base.py) before running 'migrate', and end with a validation step such as running 'pytest' to confirm the scaffold works.

Move the Integration Notes (Docker, Celery, Channels) and optionally the per-file Essential Patterns into one-level-deep reference files (e.g., references/patterns.md, references/integrations.md) linked from a leaner SKILL.md overview.

Provide the contents of '.env.example' (DJANGO_SECRET_KEY, DJANGO_DEBUG, DJANGO_ALLOWED_HOSTS, DATABASE_URL) since First Steps instructs the user to copy it but the file is never created, and trim the stock Django defaults (MIDDLEWARE, TEMPLATES) plus the duplicated command listings to reduce token cost.

DimensionReasoningScore

Conciseness

No explanatory fluff, but a substantial share of the ~489-line body is stock Django 'startproject' boilerplate Claude already knows (default MIDDLEWARE stack, TEMPLATES block, context processors, near-default admin), and install/migrate/runserver commands are duplicated across the Scaffold Command, First Steps, and Common Commands sections. This is more than 'minor instances' of trimmable content, so it sits at anchor 3 rather than 4.

3 / 5

Actionability

The heredoc-generated pyproject.toml and the complete, executable code blocks for every project file are copy-paste ready, covering the common cases. It falls short of anchor 5 due to a minor gap: '.env.example' is referenced ('Copy .env.example to .env and fill in values') and shown in the project tree, but its contents are never provided and the scaffold command does not create it.

4 / 5

Workflow Clarity

A sequence is present (Scaffold Command, then First Steps After Scaffold) but with real gaps and no validation checkpoints: 'django-admin startproject' runs before any dependency installation step, the scaffold creates 'config/settings/' without ever writing or moving the settings files into it, 'migrate' runs before the AUTH_USER_MODEL app is built out, and there is no verify step (e.g., run pytest) after scaffolding. Since 'migrate' is a database operation with no feedback loop, workflow_clarity is capped at 3 per the rubric's scoring notes.

3 / 5

Progressive Disclosure

The body has clear section headers (better than anchor 2's headerless wall), but it is a 489-line monolith with zero reference files: ~300 lines of Essential Patterns code plus Integration Notes (Docker, Celery, Channels) are content that clearly belongs in separate one-level-deep reference files. Not anchor 4 because there are no references at all and content that should be separate is fully inline.

3 / 5

Total

13

/

20

Passed

Description

70%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 specific, distinctive description that clearly states what the skill builds, held back only by the complete absence of a 'when to use it' trigger clause and a few missing natural synonyms. Adding an explicit 'Use when starting a new Django/DRF project...' sentence would bring it to top-tier quality.

Suggestions

Add an explicit trigger clause, e.g., 'Use when starting a new Django project, scaffolding a Django/DRF backend, or setting up a Django app from scratch.'

Include common synonyms users would naturally say, such as 'DRF', 'new Django project', 'Django boilerplate', or 'set up Django', to broaden trigger coverage.

DimensionReasoningScore

Specificity

"Scaffold a production-ready Django 5.x project with REST Framework, split settings, apps structure, and pytest-django" names the domain and several concrete deliverables, matching anchor 4's 'several specific actions; minor gaps in coverage'. It is not anchor 5 because it is a single verb governing components rather than multiple distinct actions, and coverage gaps exist (env handling, migrations, API conventions).

4 / 5

Completeness

The 'what' is clearly and concretely stated, but the 'when' is entirely absent — there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not anchor 2 because the 'what' is specific, not vague; not anchor 4 because no trigger guidance exists at all.

3 / 5

Trigger Term Quality

Natural terms users would say include 'Django', 'scaffold', 'REST Framework', and 'pytest-django' — good keyword coverage per anchor 4. Not anchor 5 because common synonyms and variations are missing, e.g., 'DRF', 'new Django project', 'Django boilerplate', 'set up a Django app'.

4 / 5

Distinctiveness Conflict Risk

The combination of 'Django 5.x', 'REST Framework', 'split settings', and 'pytest-django' carves a clear scaffolding niche with distinct triggers and minimal conflict risk against adjacent Django skills (testing, optimization, deployment). Fits anchor 5's 'clear niche with distinct triggers'.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

achreftlili/deep-dev-skills

Path

backend-python/django-project-starter/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.