Agent skill

Django Query Plan Reading

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Read and compare Django/PostgreSQL query execution plans using QuerySet.explain(), EXPLAIN, EXPLAIN ANALYZE, scan types, joins, estimates, actual timing, buffers, and row counts.

MITAuto-check passedDatabases

Install Django Query Plan Reading

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill django-query-plan-reading -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins django-query-plan-reading --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/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/LVTD-LLC/skills/skills/django-query-plan-reading .claude/skills/django-query-plan-reading && 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
django-query-plan-reading
GitHub stars
1.2k
Token cost
~660 tokens
SKILL.md length
283 words
Files
2 (incl. references)
Skills in repo
686
Repo updated
First seen
Licence
MIT

At a glance

Read and compare Django/PostgreSQL query execution plans using QuerySet.explain(), EXPLAIN, EXPLAIN ANALYZE, scan types, joins, estimates, actual timing, buffers, and row counts.

  • Works in 5 steps: Get the exact query. → Generate a plan. → Read from the deepest node outward. → …
  • One SQL query dominates Django latency
  • SKILL.md covers Workflow, Safety Notes and Verification
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Django Query Plan Reading is an agent skill from hashgraph-online/awesome-codex-plugins. Read and compare Django/PostgreSQL query execution plans using QuerySet.explain(), EXPLAIN, EXPLAIN ANALYZE, scan types, joins, estimates, actual timing, buffers, and row counts. Use when one SQL query dominates Django latency or when an index, ORM rewrite, pagination change, or materialized view needs proof from a query plan.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/explain-checklist.md`). Compatibility notes: Codex, Claude Code, and other Agent Skills-compatible clients.

It sits in Databases, covering Query optimization, Backend development and SQL. It works with Django, SQL and PostgreSQL. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is MIT.

When your agent uses it

  • One SQL query dominates Django latency
  • Pagination change
  • Materialized view needs proof from a query plan

Example prompts

  • “/django-query-plan-reading”

Requirements

  • Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients.

Workflow steps

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

  1. Get the exact query.
  2. Generate a plan.
  3. Read from the deepest node outward.
  4. Decide the next change.
  5. Re-run the same plan after the change.

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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.

  • Compatibility

    Codex, Claude Code, and other Agent Skills-compatible clients.

    From compatibility in the SKILL.md frontmatter.

Context cost

Django Query Plan Reading loads about 660 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 89 tokens; SKILL.md has 283 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~660
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

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 hashgraph-online/awesome-codex-plugins at commit 78497e5, republished under its MIT licence (© hashgraph-online). 283 words, ~660 tokens.

Download SKILL.mdSave it as .claude/skills/django-query-plan-reading/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
django-query-plan-reading
description
Read and compare Django/PostgreSQL query execution plans using QuerySet.explain(), EXPLAIN, EXPLAIN ANALYZE, scan types, joins, estimates, actual timing, buffers, and row counts. Use when one SQL query dominates Django latency or when an index, ORM rewrite, pagination change, or materialized view needs proof from a query plan.
compatibility
Codex, Claude Code, and other Agent Skills-compatible clients.
license
MIT
metadata.version
0.1.0
metadata.displayName
Django Query Plan Reading
metadata.category
Django
metadata.tags
django,database,query-plans,postgres,performance

Django Query Plan Reading

Use this skill when the expensive unit is a specific SQL statement or queryset. The goal is to explain why the database is doing work, not to guess from the ORM code.

Workflow

  1. Get the exact query.

    • Prefer the queryset that produced it.
    • If starting from logged SQL, include bound parameters or representative literals.
  2. Generate a plan.

    • Use queryset.explain() for ORM-owned SQL.
    • Use database EXPLAIN for raw SQL, views, materialized views, or SQL copied from logs.
    • Use analyze=True only in a safe environment because the database executes the query.
  3. Read from the deepest node outward.

    • Identify table scans, index scans, joins, sorts, aggregations, and limits.
    • Compare estimated rows with actual rows when using analyze.
    • Look for high-cost nodes that feed many rows to later nodes.
  4. Decide the next change.

    • Missing selective access path: use django-index-design.
    • Query shape prevents useful index access: rewrite filters, ordering, or join strategy.
    • Large unavoidable aggregation: consider django-db-side-computation or django-materialized-views.
    • Deep offset cost: use django-pagination-performance.
  5. Re-run the same plan after the change.

    • Compare scan type, row counts, sort nodes, heap fetches, buffers, planning time, and execution time.

See explain-checklist.md for plan-reading cues and before/after review notes.

Safety Notes

  • EXPLAIN ANALYZE executes the query. Avoid it for mutations, unsafe functions, and production paths unless you know the impact.
  • A sequential scan is not automatically bad. It can be best when the table is small or the predicate returns much of the table.
  • A used index is not automatically good. Random heap access, bad cardinality estimates, or a post-index sort can still dominate.

Verification

Finish with the before/after plan excerpt and a plain explanation of which node changed and why that matters.

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

Files

SKILL.md and 1 other file (references) in plugins/LVTD-LLC/skills/skills/django-query-plan-reading of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/explain-checklist.md

Open the folder on GitHubat commit 78497e5

Compare with similar skills

Django Query Plan Reading 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.

Django Query Plan Reading compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Django Query Plan Reading this skillhashgraph-online/awesome-codex-plugins1.2k—~660Automated safety check: PassMIT
Dsqlawslabs/agent-plugins915—~6.9kAutomated safety check: PassApache-2.0
Postgresdbericrisco/rsc-harness167—~4.4kAutomated safety check: PassMIT
SQL ToolkitLeoYeAI/openclaw-master-skills2.2k—~3kAutomated safety check: PassMIT
Profiling Slow API EndpointsPostHog/posthog40k—~1kAutomated safety check: PassCustom licence
Safe SQL Executionsupabase/supabase111k—~4.2kAutomated safety check: PassApache-2.0

Similar skills

  • Dsql

    awslabs/agent-plugins

    Official

    Build with Aurora DSQL — manage schemas, execute queries, handle migrations, diagnose query plans, diagnose cluster performance, load data, and develop applications with a serverless, distributed…

    915 GitHub stars~6.9k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Postgresdb

    ericrisco/rsc-harness

    A skill your agent uses when PostgreSQL engine behaviour decides the answer — schema and type design, index choice, reading EXPLAIN on a slow query, zero-downtime DDL and backfills, or ops (roles…

    167 GitHub stars~4.4k tokensUpdated today
    DatabasesAuto-check passed
  • SQL Toolkit

    LeoYeAI/openclaw-master-skills

    Query, design, migrate, and optimize SQL databases. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~3k tokensUpdated 2 mo ago
    DatabasesAuto-check passed
  • Official

    Profiles slow PostHog API endpoints when the main cost is in Postgres or Python.

    40k GitHub stars~1k tokensUpdated today
    DatabasesAuto-check passed
  • Safe SQL Execution

    supabase/supabase

    Official

    A skill your agent uses whenever code will build, return, fetch, or execute SQL that runs against a user's real Postgres database — even when the request reads like an ordinary feature or bug fix…

    111k GitHub stars~4.2k tokensUpdated today
    DatabasesAuto-check passed
  • PostgreSQL Documentation Reference

    2025Emma/vibe-coding-cn

    PostgreSQL database documentation - SQL queries, database design, administration, performance tuning, and advanced features. Use when working with PostgreSQL…

    23k GitHub starsUsed in 1 repo~19k tokens
    DatabasesAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 686 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated today
    Auto-check passed
  • Manuscript Engagement Analytics

    hashgraph-online/awesome-codex-plugins

    Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…

    1.2k GitHub stars~875 tokensUpdated today
    Auto-check passed

Questions about Django Query Plan Reading

What does Django Query Plan Reading do?

Read and compare Django/PostgreSQL query execution plans using QuerySet.explain(), EXPLAIN, EXPLAIN ANALYZE, scan types, joins, estimates, actual timing, buffers, and row counts. Django Query Plan Reading is an agent skill from hashgraph-online/awesome-codex-plugins.explain(), EXPLAIN, EXPLAIN ANALYZE, scan types, joins, estimates, actual timing, buffers, and row counts.

When should I use Django Query Plan Reading?

Django Query Plan Reading fits situations like: one SQL query dominates Django latency; pagination change; materialized view needs proof from a query plan.

How do I install Django Query Plan Reading in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill django-query-plan-reading -a claude-code`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/django-query-plan-reading in hashgraph-online/awesome-codex-plugins) into .claude/skills/django-query-plan-reading in your project. Claude Code loads it when a task matches its description.

How do I install Django Query Plan Reading in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill django-query-plan-reading -a codex`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/django-query-plan-reading in hashgraph-online/awesome-codex-plugins) into .agents/skills/django-query-plan-reading in your project. Codex loads it when a task matches its description.

Can I use Django Query Plan Reading 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 hashgraph-online/awesome-codex-plugins --skill django-query-plan-reading -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/django-query-plan-reading, .gemini/skills/django-query-plan-reading, .github/skills/django-query-plan-reading and .opencode/skills/django-query-plan-reading in your project.

What does Django Query Plan Reading need to run?

SKILL.md names no scripts, command-line tools or credentials: Django Query Plan Reading is instructions for the agent only. Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients..

Does Django Query Plan Reading access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Django Query Plan Reading 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 Django Query Plan Reading use?

Django Query Plan Reading is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Django Query Plan Reading use?

About 660 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. Its references folder adds about 631 tokens, read only when the agent opens those files.

What are the alternatives to Django Query Plan Reading?

Skills that share tags, products or a category with Django Query Plan Reading: Dsql (awslabs/agent-plugins, 915 stars), Postgresdb (ericrisco/rsc-harness, 167 stars), SQL Toolkit (LeoYeAI/openclaw-master-skills, 2.2k stars) and Profiling Slow API Endpoints (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Django Query Plan Reading?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,242 GitHub stars. The repository holds 686 skills in this directory. The repository was last updated on October 8, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.