New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Django Q2

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

A skill your agent uses when adding, changing, testing, or debugging Django Q2 background tasks, scheduled jobs, qcluster workers, Redis broker configuration, or ORM broker fallback in Django…

MITAuto-check passedBackend & APIs

Install Django Q2

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

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins django-q2 --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-q2 .claude/skills/django-q2 && 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-q2
GitHub stars
1.3k
Token cost
~1.7k tokens
SKILL.md length
725 words
Files
2 (incl. assets)
Skills in repo
714
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when adding, changing, testing, or debugging Django Q2 background tasks, scheduled jobs, qcluster workers, Redis broker configuration, or ORM broker fallback in Django…

  • Works in 5 steps: Put the task function in the app that… → Keep the function importable at module… → Pass durable identifiers such as primary… → …
  • Debugging Django Q2 background tasks
  • SKILL.md covers Configuration Checks, Mental Model, Adding Tasks and Scheduling Work, plus 4 more sections
  • Calls python; needs SECRET_KEY

What it does

Django Q2 is an agent skill from hashgraph-online/awesome-codex-plugins. Use when adding, changing, testing, or debugging Django Q2 background tasks, scheduled jobs, qcluster workers, Redis broker configuration, or ORM broker fallback in Django projects.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including assets. Compatibility notes: Codex, Claude Code, and other Agent Skills-compatible clients.

It sits in Backend & APIs, covering Backend development, ORMs and data access and Background jobs. It works with Django, Redis and Python. 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

  • Debugging Django Q2 background tasks
  • Qcluster workers
  • Redis broker configuration
  • ORM broker fallback in Django projects

Example prompts

  • “/django-q2”

Requirements

  • Python 3
  • Docker
  • A credential in SECRET_KEY
  • 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. Put the task function in the app that owns the behavior, usually a
  2. Keep the function importable at module import time. Do not rely on request
  3. Pass durable identifiers such as primary keys, not model instances, open
  4. Make the task idempotent. Redis does not give exactly-once execution
  5. If the task depends on a just-saved database row, enqueue it from

What it can do on your machine

Read from SKILL.md and the folder at commit 9e7b281. 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

    Shell commands in SKILL.md call:

    • python

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

    • django-q2.readthedocs.io
    • github.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.

  • Compatibility

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

    From compatibility in the SKILL.md frontmatter.

Context cost

Django Q2 loads about 1.7k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 725 words of instructions outside code blocks.

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

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 9e7b281, republished under its MIT licence (© hashgraph-online). 725 words, ~1,699 tokens.

Download SKILL.mdSave it as .claude/skills/django-q2/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
django-q2
description
Use when adding, changing, testing, or debugging Django Q2 background tasks, scheduled jobs, qcluster workers, Redis broker configuration, or ORM broker fallback in Django projects.
compatibility
Codex, Claude Code, and other Agent Skills-compatible clients.
license
MIT
metadata.version
0.1.0
metadata.displayName
Django Q2
metadata.category
Django
metadata.tags
django,django-q2,background-jobs,redis

Django Q2 Background Jobs

Use this before touching task enqueueing, schedules, worker deployment, Q_CLUSTER, or code imported by Django Q2 workers.

Configuration Checks

  • The dependency is django-q2; the Python import path is django_q.
  • django_q is in INSTALLED_APPS; its migrations provide task result, schedule, and broker models.
  • Find Q_CLUSTER in the project's settings module before changing task, worker, or broker behavior.
  • Confirm the configured broker. Redis is common, often through an environment variable such as REDIS_URL; the ORM broker is useful for low-throughput or Redis-free deployments.
  • Confirm the project's worker command. The base command is python manage.py qcluster, but projects may wrap it with uv, Poetry, Docker Compose, process managers, or platform-specific worker declarations.
  • If Redis is removed as the broker, review any Redis-dependent cache, health check, Docker, deployment, and documentation references separately.

Mental Model

  • Web code calls async_task(...) or creates Schedule rows.
  • The broker stores queued task packages until a qcluster process reserves work.
  • Worker processes execute importable Python functions and save results or failures.
  • The scheduler runs inside the cluster. Schedules are database rows; they do nothing unless qcluster is running.

Adding Tasks

  1. Put the task function in the app that owns the behavior, usually a tasks.py module or another importable module already used by the project.
  2. Keep the function importable at module import time. Do not rely on request objects, local closures, or process-local state.
  3. Pass durable identifiers such as primary keys, not model instances, open files, connections, or large payloads.
  4. Make the task idempotent. Redis does not give exactly-once execution guarantees, and receipt-based brokers can re-run work.
  5. If the task depends on a just-saved database row, enqueue it from transaction.on_commit(...).
python
def send_welcome_email(user_id: int) -> None:
    from django.contrib.auth import get_user_model

    user = get_user_model().objects.get(pk=user_id)
    ...
python
from django.db import transaction
from django_q.tasks import async_task

transaction.on_commit(
    lambda: async_task("myapp.tasks.send_welcome_email", user.pk)
)

Use q_options when Django Q2 options would collide with task kwargs:

python
async_task(
    "myapp.tasks.rebuild_report",
    report_id,
    q_options={"timeout": 300, "group": "reports"},
)

Scheduling Work

Prefer named, idempotent schedules created by a migration, admin action, or setup command. Avoid creating schedules unconditionally at import time or app startup.

python
from django_q.models import Schedule

Schedule.objects.get_or_create(
    name="clear-expired-sessions",
    defaults={
        "func": "django.core.management.call_command",
        "args": "'clearsessions'",
        "schedule_type": Schedule.HOURLY,
    },
)

Use Schedule.objects.get_or_create(name=..., defaults={...}) when seeding schedules so repeated setup does not duplicate jobs. Cron schedules require the optional croniter dependency; do not use Schedule.CRON unless the project includes it.

Missed schedules catch up by default. Set Q_CLUSTER["catch_up"] = False when a job should run once after downtime instead of replaying every missed interval.

Broker Choices

Redis Broker

Use Redis when the project already depends on it for workers or deployment:

python
Q_CLUSTER = {
    "name": "...",
    "timeout": 3600,
    "workers": 4,
    "redis": REDIS_URL,
}

Redis is fast and usually fits projects that already run Redis for cache, Docker, or deployment workers. The default Redis broker does not support delivery receipts. If a worker host dies catastrophically while executing a task, the in-flight package can be lost; if task code raises, Django Q2 records a failure. Use idempotent task design, explicit retries in task code where needed, and monitoring for failures.

Show full SKILL.md (276 more words)Show less
ORM Broker

Use the Django database broker only for low-throughput deployments, local simplicity, or environments where Redis is unavailable:

python
Q_CLUSTER = {
    "name": "...",
    "timeout": 3600,
    "retry": 4800,
    "workers": 4,
    "max_attempts": 2,
    "orm": "default",
}

When switching to ORM:

  • Remove the "redis" broker key; configure one broker per cluster unless you intentionally use custom clusters.
  • Run migrations for django_q. If the broker uses a non-default database alias, run migrations with --database <alias>.
  • Increase "poll" above the default 0.2 seconds, for example "poll": 2.0, when you need lower database polling pressure and can tolerate higher queue pickup latency.
  • The ORM broker enables the Queued Tasks admin table.
  • Review Redis-dependent cache, health check, Docker, and deployment settings separately. Schedules are always database rows; the broker setting controls queued task packages, not the schedule table.

Testing

  • Test task business logic by calling the function directly.
  • Test enqueueing with synchronous mode:
    • per call: async_task("myapp.tasks.fn", arg, sync=True)
    • per test: override Q_CLUSTER["sync"] = True
  • For worker/broker integration, run the project's qcluster command in a separate process and wait for result(task_id, 200) or a similar bounded wait; do not rely on arbitrary sleeps.
  • Use pytest.mark.django_db(transaction=True) when a real worker process must observe committed database rows.

Debugging Checklist

  • Is a qcluster process running with the same settings module, SECRET_KEY, broker URL, and cluster name as the web process?
  • Can the worker import the dotted task path?
  • Did database migrations run, including django_q migrations?
  • Is Redis reachable from both web and worker containers, or is the ORM broker polling the expected database?
  • Did a scheduled task duplicate because setup created another Schedule row with no stable name?
  • Did downtime trigger schedule catch-up?
  • Is task failure visible in Django admin, logs, or the configured error reporter?

References

© 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 (assets) in plugins/LVTD-LLC/skills/skills/django-q2 of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • assets/app-icon.png

Open the folder on GitHubat commit 9e7b281

Compare with similar skills

Django Q2 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 Q2 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Django Q2 this skillhashgraph-online/awesome-codex-plugins1.3k—~1.7kAutomated safety check: PassMIT
Django Access Reviewgetsentry/skills1k3 repos~2.6kAutomated safety check: NotesApache-2.0
Sentry Python SDKgetsentry/sentry-for-ai268—~4.1kAutomated safety check: PassApache-2.0
Django ExpertJeffallan/claude-skills12k—~1.5kAutomated safety check: PassMIT
Python PatternsxenitV1/Antigravity-Workflows1307 repos~2.2kAutomated safety check: PassMIT
Django Celeryaffaan-m/ECC276k—~240Automated safety check: PassMIT

Similar skills

  • 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

  • Sentry Python SDK

    getsentry/sentry-for-ai

    Official

    Full Sentry SDK setup for Python. An agent skill from getsentry/sentry-for-ai.

    268 GitHub stars~4.1k tokensUpdated today
    Backend & APIsAuto-check passed

  • Django Expert

    Jeffallan/claude-skills

    Builds Django apps and Django REST Framework APIs: models with indexes, ORM query optimization, serializers, viewsets and JWT authentication, with tests.

    12k GitHub stars~1.5k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed

  • Python Patterns

    xenitV1/Antigravity-Workflows

    Python development principles and decision-making. An agent skill from xenitV1/Antigravity-Workflows.

    130 GitHub starsUsed in 7 repos~2.2k tokens
    Backend & APIsAuto-check passed

  • Django Celery

    affaan-m/ECC

    DjangoおよびCeleryを使用した非同期タスク処理。タスクキューイング、ワーカー管理、エラー処理、スケジューリング。Redis/RabbitMQ ブローカー統合。

    276k GitHub stars~240 tokensUpdated 4 days ago
    Backend & APIsAuto-check passed

  • Fastapi

    ericrisco/rsc-harness

    A skill your agent uses when building, reviewing, testing, securing or shipping a FastAPI / async Python service — routers, Pydantic v2 schemas, dependency injection, async SQLAlchemy 2.0…

    174 GitHub stars~5k tokensUpdated yesterday
    Backend & APIsAuto-check: notes

More from hashgraph-online/awesome-codex-plugins

All 714 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.3k 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.3k 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.3k 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.3k GitHub stars~2.4k tokensUpdated today
    Auto-check passed

  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~2.9k 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.3k GitHub stars~618 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Django Q2

What does Django Q2 do?

A skill your agent uses when adding, changing, testing, or debugging Django Q2 background tasks, scheduled jobs, qcluster workers, Redis broker configuration, or ORM broker fallback in Django…. Django Q2 is an agent skill from hashgraph-online/awesome-codex-plugins. Use when adding, changing, testing, or debugging Django Q2 background tasks, scheduled jobs, qcluster workers, Redis broker configuration, or ORM broker fallback in Django projects.

When should I use Django Q2?

Django Q2 fits situations like: debugging Django Q2 background tasks; qcluster workers; redis broker configuration; ORM broker fallback in Django projects.

How do I install Django Q2 in Claude Code?

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

How do I install Django Q2 in Codex?

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

Can I use Django Q2 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-q2 -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-q2, .gemini/skills/django-q2, .github/skills/django-q2 and .opencode/skills/django-q2 in your project.

What does Django Q2 need to run?

Going by SKILL.md and its folder, Django Q2 needs the command-line tools its instructions call (python) and credentials named SECRET_KEY. Our summary lists: Python 3; Docker; A credential in SECRET_KEY. Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients..

Does Django Q2 access the network?

SKILL.md names 2 domains. As links in the text: django-q2.readthedocs.io and github.com. This is read from the text; nothing was executed.

Is Django Q2 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 Q2 use?

Django Q2 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 Q2 use?

About 1.7k tokens (SKILL.md is roughly 6.8k 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 Django Q2?

Skills that share tags, products or a category with Django Q2: Django Access Review (getsentry/skills, 1k stars), Sentry Python SDK (getsentry/sentry-for-ai, 268 stars), Django Expert (Jeffallan/claude-skills, 12k stars) and Python Patterns (xenitV1/Antigravity-Workflows, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Django Q2?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,255 GitHub stars. The repository holds 714 skills in this directory. The repository was last updated on October 9, 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.