Agent skill

Dj Settings

by dvf in dvf/opinionated-django

Organize Django settings.py into clearly sectioned blocks with banner-style headers.

MITAuto-check passedBackend & APIs

Install Dj Settings

skills CLI
$ npx skills add dvf/opinionated-django --skill dj-settings -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dvf/opinionated-django dj-settings --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dvf/opinionated-django.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dj-settings .claude/skills/dj-settings && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dj-settings
GitHub stars
109
Token cost
~640 tokens
SKILL.md length
233 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Organize Django settings.py into clearly sectioned blocks with banner-style headers.

  • Works in 12 steps: Imports and BASE_DIR (no banner — these… → LOGGING → SECURITY — SECRET_KEY, DEBUG,… → …
  • Tasks that involve Backend development
  • SKILL.md covers Section Format, Section Order, INSTALLED_APPS Sub-grouping and Rules
  • Reaches docs.djangoproject.com; needs SECRET_KEY

What it does

Dj Settings is an agent skill from dvf/opinionated-django. Organize Django settings.py into clearly sectioned blocks with banner-style headers. Use proactively whenever modifying src/project/settings.py — adding new settings, removing settings, or restructuring sections.

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Backend development. It works with Django. The repository describes itself as: An opinionated Django project with Repository pattern, Pydantic DTOs, svcs DI, and Stripe-style ULID IDs. The licence is MIT.

When your agent uses it

  • Tasks that involve Backend development

Example prompts

  • “/dj-settings”

Requirements

  • Python 3
  • A credential in SECRET_KEY
  • Pre-approved tools (allowed-tools): Read, Edit

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. Imports and BASE_DIR (no banner — these are preamble)
  2. LOGGING
  3. SECURITY — SECRET_KEY, DEBUG, ALLOWED_HOSTS, CORS, CSRF, cookie settings
  4. APPLICATION DEFINITION — INSTALLED_APPS, MIDDLEWARE
  5. URLS AND WSGI — ROOT_URLCONF, WSGI_APPLICATION
  6. TEMPLATES
  7. AUTH — AUTH_USER_MODEL, AUTH_PASSWORD_VALIDATORS, LOGIN_URL
  8. DATABASE
  9. SESSIONS
  10. CACHING
  11. INTERNATIONALIZATION — LANGUAGE_CODE, TIME_ZONE, USE_I18N, USE_TZ
  12. STATIC FILES — STATIC_URL, STATIC_ROOT, DEFAULT_AUTO_FIELD

What it can do on your machine

Read from SKILL.md and the folder at commit f17fc2d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • docs.djangoproject.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SECRET_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dj Settings loads about 640 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 233 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~640

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dvf/opinionated-django at commit f17fc2d, republished under its MIT licence (© dvf). 233 words, ~640 tokens.

Download SKILL.mdSave it as .claude/skills/dj-settings/SKILL.md (or your agent's skills folder).
name
dj-settings
description
Organize Django settings.py into clearly sectioned blocks with banner-style headers. Use proactively whenever modifying src/project/settings.py — adding new settings, removing settings, or restructuring sections.
allowed-tools
Read, Edit

Organize Django Settings

When modifying src/project/settings.py, enforce this structure.

Section Format

Every logical group of settings gets a banner header:

python
# =============================================================================
# SECTION NAME
# =============================================================================
  • Banner lines are exactly 77 characters (# + 75 = characters)
  • Section name is UPPERCASE
  • One blank line before each banner (except at top of file)
  • No blank lines between the banner and the first setting in that section
  • No inline comments explaining what standard Django settings do — the section header is enough

Section Order

Settings must appear in this order. Omit sections that have no settings.

  1. Imports and BASE_DIR (no banner — these are preamble)
  2. LOGGING
  3. SECURITY — SECRET_KEY, DEBUG, ALLOWED_HOSTS, CORS, CSRF, cookie settings
  4. APPLICATION DEFINITION — INSTALLED_APPS, MIDDLEWARE
  5. URLS AND WSGI — ROOT_URLCONF, WSGI_APPLICATION
  6. TEMPLATES
  7. AUTH — AUTH_USER_MODEL, AUTH_PASSWORD_VALIDATORS, LOGIN_URL
  8. DATABASE
  9. SESSIONS
  10. CACHING
  11. INTERNATIONALIZATION — LANGUAGE_CODE, TIME_ZONE, USE_I18N, USE_TZ
  12. STATIC FILES — STATIC_URL, STATIC_ROOT, DEFAULT_AUTO_FIELD
  13. CELERY — all CELERY_* settings
  14. Any additional project-specific sections in alphabetical order

INSTALLED_APPS Sub-grouping

Within INSTALLED_APPS, group entries with inline comments:

python
INSTALLED_APPS = [
    # Django core
    "django.contrib.admin",
    ...
    # Third-party
    "corsheaders",
    ...
    # Project apps
    "products.apps.ProductsConfig",
    "orders.apps.OrdersConfig",
]

Project apps must use the dotted path to their AppConfig subclass (e.g., "myapp.apps.MyAppConfig"), not the short app name.

Rules

  • Do NOT add Django docs URLs as comments (e.g., # https://docs.djangoproject.com/...)
  • Do NOT add "Quick-start" or "Generated by" boilerplate comments
  • Keep AUTH_PASSWORD_VALIDATORS compact — one dict per line when the only key is "NAME"
  • When adding a new setting, place it in the correct existing section. Create a new section only if none fit.

© dvf, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/dj-settings of dvf/opinionated-django.

Open the folder on GitHubat commit f17fc2d

Compare with similar skills

Dj Settings next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dj Settings compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dj Settings this skilldvf/opinionated-django109—~640Automated safety check: PassMIT
Saleor Django Schema Migrationsaleor/saleor23k—~1kAutomated safety check: PassBSD-3-Clause
Django Access Reviewgetsentry/skills1k3 repos~2.6kAutomated safety check: NotesApache-2.0
Silk Profilerbaserow/baserow6.1k—~2.9kAutomated safety check: PassCustom licence
Arch Wikiahmedemad3/arch-wiki249—~5.1kAutomated safety check: PassNone
Run Testsnetboxlabs/netbox-branching155—~1.2kAutomated safety check: PassCustom licence

Similar skills

  • Generates and splits Django schema migrations for Saleor with manage.py makemigrations, enforcing one new model or one field change per migration file.

    23k GitHub stars~1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Django Access Review

    getsentry/skills

    Official

    Django access control and IDOR security review. An agent skill from getsentry/skills.

    1k GitHub starsUsed in 3 repos~2.6k tokens
    Backend & APIsAuto-check: notes
  • Silk Profiler

    baserow/baserow

    Investigate backend performance using Django Silk profiling data.

    6.1k GitHub stars~2.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Arch Wiki

    ahmedemad3/arch-wiki

    Scans any project codebase for new/changed modules, endpoints, middleware, infrastructure, Docker topologies, SQL queries, or permissions and updates docs/architecture/architecture.json.

    249 GitHub stars~5.1k tokensUpdated 18 days ago
    Backend & APIsAuto-check passed
  • Run Tests

    netboxlabs/netbox-branching

    Run the netboxbranching plugin's Django test suite against a local NetBox checkout.

    155 GitHub stars~1.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Add or change a CLIST Django management command, including arguments, resource selection, EventLog monitoring, or cron and Healthchecks wiring.

    439 GitHub stars~848 tokensUpdated 3 days ago
    Backend & APIsAuto-check passed

More from dvf/opinionated-django

All 9 skills in this repo
  • Dj Architecture

    dvf/opinionated-django

    Implement a Django feature following the opinionated architecture — prefixed ULID IDs, repository pattern, Pydantic DTOs, svcs service locator, project-scoped django-ninja API, Celery reliable…

    109 GitHub stars~4k tokensUpdated 1 mo ago
    Auto-check: notes
  • Dj Models

    dvf/opinionated-django

    Structure Django models with proper Meta classes, verbose names, and optimized indexes.

    109 GitHub stars~4.9k tokensUpdated 1 mo ago
    Auto-check: notes
  • Dj Prefixed Ulids

    dvf/opinionated-django

    Use Stripe-style prefixed ULID primary keys (e.g. An agent skill from dvf/opinionated-django.

    109 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check: notes
  • Dj Pytest

    dvf/opinionated-django

    Set up and write pytest tests for an op-django project — pytest-django configuration, two-sided Celery testing (patched dispatch sites + plain-function task bodies, never eager mode), freezegun for…

    109 GitHub stars~4.3k tokensUpdated 1 mo ago
    Auto-check: notes
  • Dj Scaffold

    dvf/opinionated-django

    Set up a Django project into the op-django layout so the architecture, signals, and settings skills have a foundation to build on.

    109 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check: notes
  • Dj Services

    dvf/opinionated-django

    Structure Django business logic as plain services that receive their dependencies via constructor injection, and wire them through an svcs registry so they can be resolved anywhere — views, Celery…

    109 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check: notes

Works with

Categories

Questions about Dj Settings

What does Dj Settings do?

Organize Django settings.py into clearly sectioned blocks with banner-style headers. Dj Settings is an agent skill from dvf/opinionated-django.py into clearly sectioned blocks with banner-style headers.

When should I use Dj Settings?

Dj Settings fits situations like: tasks that involve Backend development.

How do I install Dj Settings in Claude Code?

Run `npx skills add dvf/opinionated-django --skill dj-settings -a claude-code`. Or copy the skill folder (skills/dj-settings in dvf/opinionated-django) into .claude/skills/dj-settings in your project. Claude Code loads it when a task matches its description.

How do I install Dj Settings in Codex?

Run `npx skills add dvf/opinionated-django --skill dj-settings -a codex`. Or copy the skill folder (skills/dj-settings in dvf/opinionated-django) into .agents/skills/dj-settings in your project. Codex loads it when a task matches its description.

Can I use Dj Settings in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dvf/opinionated-django --skill dj-settings -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dj-settings, .gemini/skills/dj-settings, .github/skills/dj-settings and .opencode/skills/dj-settings in your project.

What does Dj Settings need to run?

Going by SKILL.md and its folder, Dj Settings needs credentials named SECRET_KEY. Our summary lists: Python 3; A credential in SECRET_KEY. Its frontmatter pre-approves these tools: Read, Edit.

Does Dj Settings access the network?

SKILL.md names 1 domain. In commands or code: docs.djangoproject.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Dj Settings safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dj Settings use?

Dj Settings is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dj Settings use?

About 640 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dj Settings?

Skills that share tags, products or a category with Dj Settings: Saleor Django Schema Migration (saleor/saleor, 23k stars), Django Access Review (getsentry/skills, 1k stars), Silk Profiler (baserow/baserow, 6.1k stars) and Arch Wiki (ahmedemad3/arch-wiki, 249 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dj Settings?

dvf (a GitHub user) maintains it in dvf/opinionated-django, which has 109 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on August 14, 2026.

Source: dvf/opinionated-django on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.