CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dbos-python

Guide for building reliable, fault-tolerant Python applications with DBOS durable workflows. Use when adding DBOS to existing Python code, creating workflows and steps, or using queues for concurrency control.

Quality

84%

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

The canonical home for this skill is dbos-python in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 lean, well-structured overview with executable code for the critical rules and clear priority-based navigation into a well-organized one-level-deep reference bundle. The main gaps are that most reference files are never surfaced by name (including the _sections.md index) and that advertised use cases like queues lack any inline example.

Suggestions

Replace the 3-file 'How to Use' list with a link to references/_sections.md or a compact per-category file index (e.g., 'queue-: see queue-basics.md, queue-concurrency.md, ...') so all 34 reference files are discoverable from SKILL.md without inferring the prefix convention.

Add a minimal inline queue example (decorator + DBOS.enqueue + workflow) since 'using queues for concurrency control' is a headline use case in both the description and 'When to Use' but has no code in the body.

Delete the redundant restatement of the frontmatter description at the top of the body ('Guide for building reliable, fault-tolerant Python applications with DBOS durable workflows.') to save tokens without losing information.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence: no explanations of general Python or workflow concepts, compact code blocks, and constraint rules stated flatly. Minor trimmable redundancy keeps it from anchor 5: line 11 ('Guide for building reliable, fault-tolerant Python applications with DBOS durable workflows.') repeats the frontmatter description verbatim, and the 'When to Use' bullet list largely restates the description's trigger clause. It is well above anchor 3, which requires genuinely unnecessary explanation.

4 / 5

Actionability

Two complete, executable, copy-paste-ready code blocks (DBOS config/launch, workflow+step) plus concrete 'Do NOT' constraints give mostly executable guidance. It stops short of anchor 5's 'specific examples cover the common cases': queues, workflow communication, testing, and DBOSClient — all advertised in 'When to Use' — have no inline example and only 3 of 34 reference files are surfaced, so a common case (queue setup) requires hunting for the right file. It clearly exceeds anchor 3's pseudocode/incomplete level.

4 / 5

Workflow Clarity

The guide gives a clear priority-ordered path: check the priority table (CRITICAL lifecycle/workflow first), apply the explicit MUST/Do-NOT critical rules, then read the per-topic reference file — a coherent sequence with explicit gating constraints. As a best-practices reference rather than a destructive or batch operation, validation checkpoints are not required, so the workflow-clarity cap does not apply; anchor 4's 'clear sequence with minor gaps' fits better than anchor 3 (implicit checkpoints would matter only for risky operations) and better than anchor 5 (no explicit validation/feedback loop is provided, though none is needed).

4 / 5

Progressive Disclosure

The bundle structure is sound: 34 flat, prefix-named reference files exactly one level deep, and SKILL.md is a lean overview with a category table mapping prefixes to priorities. It falls short of anchor 5's 'well-signaled references; easy navigation' because the body explicitly names only 3 of 34 files (lifecycle-config.md, workflow-determinism.md, queue-concurrency.md — all real), never mentions the existing references/_sections.md index, and leaves discovery of the other 31 files to inferring the prefix convention. It is still clearly better organized than anchor 3's 'references present but not clearly signaled'.

4 / 5

Total

16

/

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 strong description that explicitly answers both 'what' and 'when' with concrete, DBOS-anchored trigger phrases in third person. Keyword coverage is good though it omits a few natural variations (durable execution, events/messages, testing) and the body advertises more use cases than the description covers.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'adding DBOS to existing Python code, creating workflows and steps, or using queues for concurrency control' — alongside a named domain ('DBOS durable workflows'). It falls short of anchor 5 because coverage has gaps: workflow communication (events, messages, streams), testing, and DBOSClient use cases from the body are absent, and 'reliable, fault-tolerant' leans slightly on buzzwords; it exceeds anchor 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

Both halves are explicit: 'what' is 'Guide for building reliable, fault-tolerant Python applications with DBOS durable workflows', and 'when' is a concrete 'Use when adding DBOS to existing Python code, creating workflows and steps, or using queues for concurrency control' clause with specific trigger phrases — matching the anchor 5 example structure. It exceeds anchor 4 because the 'when' clause needs no added explicitness.

5 / 5

Trigger Term Quality

Natural terms users would say are present: 'DBOS', 'Python', 'workflows', 'steps', 'queues', 'concurrency control', 'adding DBOS to existing Python code'. A few natural variants are missing ('durable execution', retries, events/messages, testing), matching anchor 4's 'good keyword coverage; a few natural terms missing' rather than anchor 5's comprehensive synonym coverage, and clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

DBOS durable workflows is a clear niche with distinct triggers (DBOS, durable workflows, DBOS queues); every capability mention is anchored to DBOS, so conflict risk with generic Python or queueing skills is minimal, matching anchor 5. Anchor 4's 'minor overlap risk' would apply if unqualified terms like bare 'queues' dominated, but they are consistently DBOS-qualified.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/dbos-python/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.