# django-celery-expert

A skill that gives your AI agent Django Celery guidance: background tasks, retries, periodic jobs, worker monitoring.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 installs · ★ 162
- Author: vintasoftware
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vintasoftware/django-ai-plugins/tree/HEAD/skills/django-celery-expert/SKILL.md
- Updated: 2026-07-23
- HTML: https://affpapa.org/en/nevibecode/skills/django-celery-expert

## What it does

The skill steers an agent through Celery work in Django: designing background tasks, configuring workers, handling retries and errors, running periodic jobs with Celery Beat, and setting up production monitoring. The agent first classifies the request, then reads the matching file under `references/` — Django integration, task design, configuration, error handling, periodic tasks, monitoring, production deployment. Only then does it write code.

Examples ship with it: sending a welcome email after registration via `transaction.on_commit`, a CSV import that reports progress through `update_state`, and a `chain` that validates inventory, charges payment and sends confirmation. Before handing over a solution the agent checks that task arguments are serializable, retried tasks are idempotent, errors carry context in the log, and long-running tasks have timeouts.

It stays out of general Django questions that have nothing to do with Celery, and out of Django Q, Huey or RQ. ML and data pipeline orchestration in Airflow or Prefect is also outside its scope. If your project runs one of those, this skill won't help.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-celery-expert -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/django-celery-expert/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/django-celery-expert/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-celery-expert -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/django-celery-expert/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-celery-expert -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/django-celery-expert/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vintasoftware/django-ai-plugins django-celery-expert
```

2. **Manually: put the files in place**
- File: `.github/skills/django-celery-expert/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-celery-expert -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vintasoftware/django-ai-plugins --path skills/django-celery-expert
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/django-celery-expert/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-celery-expert -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/vintasoftware/django-ai-plugins/tree/HEAD/skills/django-celery-expert/SKILL.md

## When to use it
- debug a Celery task that fails without retrying
- set up retries with backoff and timeouts
- move periodic jobs to Celery Beat with crontab
- wire up Flower or Prometheus for worker monitoring
- build a multi-step chain of tasks

## Example prompts
- Set up background email sending after user registration
- Build a Celery chain: validate inventory, charge payment, send confirmation
- How do I schedule a periodic task with Celery Beat every hour?

## Similar
- [django-celery](https://affpapa.org/en/nevibecode/skills/django-celery.md) — skill · 4600 installs
- [celery](https://affpapa.org/en/nevibecode/skills/celery.md) — skill · 454 installs
- [django-python](https://affpapa.org/en/nevibecode/skills/django-python.md) — skill · 933 installs
- [celery-expert](https://affpapa.org/en/nevibecode/skills/celery-expert.md) — skill · 454 installs
- [django-storages-s3](https://affpapa.org/en/nevibecode/skills/django-storages-s3.md) — skill · 900 installs
- [rest-api-django](https://affpapa.org/en/nevibecode/skills/rest-api-django.md) — skill · 712 installs

From the same set: [vintasoftware/django-ai-plugins](https://affpapa.org/en/nevibecode/by/vintasoftware/django-ai-plugins.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md