Agent skill

Dj Lint

by dvf in dvf/opinionated-django

Run linting, formatting, and static type checks on a Django project using ruff and pyrefly, and fix any issues found.

MITAuto-check: notesBackend & APIs

Install Dj Lint

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

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

GitHub CLI
$ gh skill install dvf/opinionated-django dj-lint --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-lint .claude/skills/dj-lint && 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-lint
GitHub stars
109
Token cost
~475 tokens
SKILL.md length
226 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Run linting, formatting, and static type checks on a Django project using ruff and pyrefly, and fix any issues found.

  • Works in 3 steps: uv run ruff check src — lint the code → uv run ruff format --check src — verify… → uv run pyrefly check src — static type…
  • Type-check the codebase
  • Calls uv
  • Tasks that involve Linting and formatting

What it does

Dj Lint is an agent skill from dvf/opinionated-django. Run linting, formatting, and static type checks on a Django project using ruff and pyrefly, and fix any issues found. Use after making code changes, before committing, or whenever the user asks to lint, format, or type-check the codebase.

Its SKILL.md is about 480 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 Linting and formatting and Backend development. It works with Django and Ruff. 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

  • Type-check the codebase
  • Tasks that involve Linting and formatting
  • Tasks that involve Backend development

Example prompts

  • “/dj-lint”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Edit

Workflow steps

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

  1. uv run ruff check src — lint the code
  2. uv run ruff format --check src — verify formatting
  3. uv run pyrefly check src — static type analysis

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:

    • Bash
    • Read
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

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

  • Network

    Links to these hosts (documentation or services it may open):

    • pyrefly.org

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Dj Lint loads about 475 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 226 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Edit

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). 226 words, ~475 tokens.

Download SKILL.mdSave it as .claude/skills/dj-lint/SKILL.md (or your agent's skills folder).
name
dj-lint
description
Run linting, formatting, and static type checks on a Django project using ruff and pyrefly, and fix any issues found. Use after making code changes, before committing, or whenever the user asks to lint, format, or type-check the codebase.
allowed-tools
Bash, Read, Edit

Lint and Type-Check

Run the full static-analysis suite on the project and fix any issues found.

  1. uv run ruff check src — lint the code
  2. uv run ruff format --check src — verify formatting
  3. uv run pyrefly check src — static type analysis

Fix every issue reported (re-run until clean) and report a short summary of what changed when done. If a failure is not auto-fixable, explain what needs human judgement rather than silencing it.

Pyrefly + Django gotchas

Pyrefly has built-in Django support (via django-stubs), but a few things aren't covered yet. Recognize these before reaching for # type: ignore:

  • Reverse relations (user.order_set, author.article_set) are not supported. This is a known pyrefly limitation, not a real bug. The right fix is to query the child model directly from its repository (OrderRepository().list_for_user(user_id)) — push the access down into the repo layer rather than suppressing it. Only if that's impossible, narrow it with # type: ignore[attr-defined] at a single call site.
  • ManyRelatedManager is generic over [Parent, Model], not the concrete child. Don't rely on pyrefly to catch a mistyped M2M target — cover it with a test instead.
  • Chained QuerySet methods beyond .all() are thinly typed. Keep chains inside the repository where the return type is an annotated list[SomeDTO]; don't let querysets leak out into services.

See pyrefly.org/en/docs/django for the current support matrix. Pyrefly's Django support is actively evolving — re-check when upgrading.

© 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-lint of dvf/opinionated-django.

Open the folder on GitHubat commit f17fc2d

Compare with similar skills

Dj Lint 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 Lint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dj Lint this skilldvf/opinionated-django109—~475Automated safety check: NotesMIT
Update Dependenciesalorence/django-modern-rpc111—~1.3kAutomated safety check: PassMIT
Run And Verifyaropan/clist439—~461Automated safety check: PassApache-2.0
Python Rulessoftspark/ai-toolkit179—~2.9kAutomated safety check: PassApache-2.0
Python Projectmajiayu000/spellbook287—~2.7kAutomated safety check: NotesMIT
Pythonericrisco/rsc-harness174—~3.8kAutomated safety check: PassMIT

Similar skills

  • Update Dependencies

    alorence/django-modern-rpc

    Routine update of all project dependencies — uv itself, uv.lock (all groups), tool versions pinned in GitHub workflows and .pre-commit-config.yaml (uv, ruff, mypy...), and SHA-pinned GitHub Actions.

    111 GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Run And Verify

    aropan/clist

    Choose and run focused checks after changing CLIST Python code: Django tests, standalone pytest tests, offline parser fixtures, Ruff, or a relevant management-command check.

    439 GitHub stars~461 tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • Python Rules

    softspark/ai-toolkit

    Python coding rules: style, patterns, security, testing. An agent skill from softspark/ai-toolkit.

    179 GitHub stars~2.9k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Python Project

    majiayu000/spellbook

    Modern Python project architecture guide for 2025. An agent skill from majiayu000/spellbook.

    287 GitHub stars~2.7k tokensUpdated today
    Backend & APIsAuto-check: notes
  • Python

    ericrisco/rsc-harness

    A skill your agent uses when the task is Python itself, in any framework or none: PEP 695 generics, mypy --strict typing, dataclass/Protocol/TypedDict/Enum choices, asyncio.TaskGroup, stdlib idioms…

    174 GitHub stars~3.8k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Python Pro

    diegosouzapw/awesome-omni-skills

    python-pro workflow skill. An agent skill from diegosouzapw/awesome-omni-skills.

    159 GitHub stars~3.8k tokensUpdated 3 mo 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

Questions about Dj Lint

What does Dj Lint do?

Run linting, formatting, and static type checks on a Django project using ruff and pyrefly, and fix any issues found. Dj Lint is an agent skill from dvf/opinionated-django. Run linting, formatting, and static type checks on a Django project using ruff and pyrefly, and fix any issues found.

When should I use Dj Lint?

Dj Lint fits situations like: type-check the codebase; tasks that involve Linting and formatting; tasks that involve Backend development.

How do I install Dj Lint in Claude Code?

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

How do I install Dj Lint in Codex?

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

Can I use Dj Lint 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-lint -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-lint, .gemini/skills/dj-lint, .github/skills/dj-lint and .opencode/skills/dj-lint in your project.

What does Dj Lint need to run?

Going by SKILL.md and its folder, Dj Lint needs the command-line tools its instructions call (uv). Its frontmatter pre-approves these tools: Bash, Read, Edit.

Does Dj Lint access the network?

SKILL.md names 1 domain. As links in the text: pyrefly.org. This is read from the text; nothing was executed.

Is Dj Lint safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Dj Lint use?

Dj Lint 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 Lint use?

About 475 tokens (SKILL.md is roughly 1.9k 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 Lint?

Skills that share tags, products or a category with Dj Lint: Update Dependencies (alorence/django-modern-rpc, 111 stars), Run And Verify (aropan/clist, 439 stars), Python Rules (softspark/ai-toolkit, 179 stars) and Python Project (majiayu000/spellbook, 287 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dj Lint?

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.