CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

python-background-jobs

Python background job patterns including task queues, workers, and event-driven architecture. Use when implementing async task processing, job queues, long-running operations, or decoupling work from request/response cycles.

63

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/python-development/skills/python-background-jobs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A solidly structured skill with concrete, mostly executable Celery-based patterns and a correctly wired one-level reference file. The main weaknesses are redundancy (Core Concepts re-teaching plus a best-practices summary that restates the patterns), an unresolved `pass` branch and incomplete SQL in two patterns, and no explicit end-to-end workflow with validation checkpoints for retry/payment-heavy work.

Suggestions

Remove the 'Best Practices Summary' section (or cut it to items not already covered) and compress 'Core Concepts' into one-line reminders, since idempotency, state machines, and at-least-once delivery are concepts Claude already knows.

Resolve the `pass` placeholder in Pattern 3 with a concrete in-progress strategy (e.g., return early with a warning or acquire a lock), and replace the `'UPDATE jobs SET status = $1, ... WHERE id = $2'` ellipsis with complete SQL.

Add a short ordered implementation workflow with checkpoints — e.g., define task → configure retries/timeouts → verify idempotency with a dry-run/duplicate-delivery test → expose the status endpoint → check queue depth after deploy.

DimensionReasoningScore

Conciseness

The body is mostly code with terse lead-ins, but it includes content Claude already knows (the four 'Core Concepts' definitions of idempotency, state machines, at-least-once delivery) and a 10-item 'Best Practices Summary' that largely restates the patterns above it — both could be tightened. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4, whose example has only trivially trimmable phrasing.

3 / 5

Actionability

Mostly executable, concrete code: the Celery Quick Start, the retry/backoff configuration, and the idempotency-key pattern are copy-paste-ready. It is not anchor 5 because of localized gaps — Pattern 3 leaves the 'Already in progress?' branch as a literal `pass`, and Pattern 4's UPDATE statement contains '...' and passes a dict as a single SQL parameter — but these are minor relative to ~100 lines of real code, fitting anchor 4's 'minor gaps' rather than anchor 3's pervasive pseudocode.

4 / 5

Workflow Clarity

There is an implicit sequence (accept request → enqueue → return job ID → worker processes → poll status) but no explicit ordered workflow with checkpoints, and the key concurrency checkpoint in Pattern 3 is an unresolved `pass`. Since job processing involves retries and payment side-effects where idempotency verification is the validation step, the missing/implicit checkpoints match anchor 3 ('sequence present but checkpoints missing or implicit'), one level below anchor 4's 'most checkpoints present'.

3 / 5

Progressive Disclosure

The single reference (`references/details.md`) is real, one level deep, correctly named, and explicitly signaled with a conditional read trigger ('Read that file when the navigation summary above is insufficient'), and details.md's '## Advanced Patterns' heading matches the promise. It falls short of anchor 5 because the main body is not a lean overview — substantial implementation detail (the full Job dataclass and JobRepository) is inlined rather than split out, which is the 'minor organization gaps' of anchor 4.

4 / 5

Total

14

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-formed description that explicitly answers both what the skill does and when to use it, with natural trigger terms and a clearly bounded niche. The only weaknesses are that the capability list is more topical than action-oriented and a few common synonyms/tool names (Celery, background task, scheduled jobs) are missing.

DimensionReasoningScore

Specificity

The description lists several specific capabilities — 'task queues, workers, and event-driven architecture' plus concrete use cases like 'decoupling work from request/response cycles' — but these are mostly noun-phrase subtopics rather than the multiple concrete actions of a top score, and tooling specifics (e.g., Celery, retries, scheduling) are absent. It sits above anchor 3 (only 1-2 concrete actions) and below anchor 5 (comprehensive concrete action list), so anchor 4 fits best.

4 / 5

Completeness

Both parts are explicit: the 'what' is 'Python background job patterns including task queues, workers, and event-driven architecture' and the 'when' is a concrete 'Use when implementing async task processing, job queues, long-running operations, or decoupling work from request/response cycles' clause with multiple concrete trigger phrases. This matches the anchor 5 example structure exactly; a missing or merely implied 'when' would have capped it at 3.

5 / 5

Trigger Term Quality

Strong natural keywords a user would actually say: 'background job', 'task queue', 'job queue', 'long-running operations'. It falls short of anchor 5 because common synonyms and tool names users would mention are missing — 'background task', 'Celery', 'RQ', 'cron/scheduled jobs', 'worker' is present but 'async' variants beyond one phrase are thin.

4 / 5

Distinctiveness Conflict Risk

'Python background job patterns' is a clear, well-bounded niche with distinct triggers ('task queue', 'job queue', 'background'), comparable to the PDF example at anchor 5. It is more distinct than the anchor 4 example (which spans two overlapping document domains); the only conceivable overlap is with a generic async-Python or API-design skill, which is minimal.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wshobson/agents

Path

plugins/python-development/skills/python-background-jobs/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.