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.

80

1.32x
Quality

76%

Does it follow best practices?

Impact

99%

1.32x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-wshobson/python-development/skills/python-background-jobs/SKILL.md

The canonical home for this skill is python-background-jobs in wshobson/agents

SKILL.md
Quality
Evals
Security

Quality

Content

57%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 well-organized pattern catalog with mostly executable, concrete code, but it functions as a monolithic reference that re-explains concepts and boilerplate Claude already knows, with no validation checkpoints for batch-style operations. The actionability is solid; conciseness, workflow validation, and file-level structure are the weaker axes.

Suggestions

Trim content Claude already knows: collapse the Core Concepts section to one line per concept and drop the Job dataclass/JobRepository boilerplate, keeping the highest-value examples (idempotency keys, retry configuration, DLQ handling).

Add an explicit verification step, e.g. after implementing, enqueue the same job twice to confirm idempotency and poll /jobs/{job_id} to confirm state transitions behave correctly.

Move the advanced patterns (dead letter queue, task chaining/workflows, alternative task queues) into references/ files linked from SKILL.md, keeping SKILL.md to overview, quick start, and fundamental patterns.

DimensionReasoningScore

Conciseness

Prose is tight, but the ~360-line body includes material Claude already knows: the Core Concepts section re-states idempotency and at-least-once delivery, and the full Job dataclass plus JobRepository SQL is boilerplate Claude can write unaided. This fits anchor 3 ('mostly efficient but some unnecessary explanation could be tightened') better than anchor 4's 'minor instances', though it avoids anchor 2's padded tutorial prose.

3 / 5

Actionability

Mostly executable guidance throughout: the Quick Start is copy-paste ready, Celery config uses real values (task_acks_late, soft/hard time limits), and retry code includes a concrete backoff formula (2 ** self.request.retries * 60). It misses anchor 5 because Pattern 3 contains a literal `pass` stub and Pattern 4's SQL has "UPDATE jobs SET status = $1, ... WHERE id = $2" with an ellipsis, but nearly all code is real rather than pseudocode, keeping it above anchor 3.

4 / 5

Workflow Clarity

The patterns are sequenced (core concepts → quick start → fundamental → advanced → best practices) but there are no validation checkpoints or feedback loops — no guidance to verify a job end-to-end or test idempotency by running a task twice — despite covering batch operations (chord over item_ids, webhook processing), which caps this at anchor 3's 'checkpoints missing or implicit'. It sits above anchor 2 because a clear progression exists.

3 / 5

Progressive Disclosure

Section headers are well organized, but everything is inlined in a single ~360-line SKILL.md with no bundle files — advanced patterns (DLQ, task chaining, alternative queues) and the job-state repository are content that could be split into one-level-deep reference files. This matches anchor 3's 'content that should be separate is inline'; it is above anchor 2 (structure is good, not headerless) but below anchor 4 (nothing is offloaded to separate files).

3 / 5

Total

13

/

20

Passed

Description

83%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 strong description that clearly and explicitly states both what the skill covers and when to use it, with natural trigger phrasing. Its only weaknesses are a non-comprehensive capability list and slightly broad trigger terms that create minor overlap risk with general async/architecture skills.

DimensionReasoningScore

Specificity

"Python background job patterns including task queues, workers, and event-driven architecture" names the domain plus several concrete capability areas, matching the 'several specific actions; minor gaps' anchor. It is below anchor 5 because coverage is not comprehensive (no mention of retries, job state tracking, or monitoring) and above anchor 3 because more than 1-2 concrete items are named.

4 / 5

Completeness

It explicitly answers both parts: what — "Python background job patterns including task queues, workers, and event-driven architecture" and when — "Use when implementing async task processing, job queues, long-running operations, or decoupling work from request/response cycles". This mirrors the anchor-5 example structure with concrete trigger phrases, so neither anchor 4 (vaguer 'when') nor any lower anchor fits better.

5 / 5

Trigger Term Quality

Trigger phrases "async task processing, job queues, long-running operations, or decoupling work from request/response cycles" are natural things users would say, giving good keyword coverage. It falls short of anchor 5's comprehensive coverage because common synonyms and specifics users would actually mention (Celery, RQ, background tasks, message queues) are missing, but exceeds anchor 3 by including multiple natural phrasings.

4 / 5

Distinctiveness Conflict Risk

"Python background job patterns" carves a mostly distinct niche with minor overlap risk from closely related skills, matching anchor 4. It is not anchor 5 because "async task processing" and "event-driven architecture" are broad enough to also pull in asyncio/concurrency or general architecture queries.

4 / 5

Total

17

/

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

Dicklesworthstone/pi_agent_rust

Path

tests/ext_conformance/artifacts/agents-wshobson/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.