Dbos Python

This gives Claude the patterns for building fault-tolerant Python apps with DBOS's durable workflow system. It covers the critical stuff like proper lifecycle setup (you need to configure and launch DBOS in your main function), the workflow and step model (external calls must be steps, workflows must be deterministic), and concurrency control through queues. The guidelines are organized by priority, from lifecycle basics to advanced patterns, with specific guardrails like not calling start_workflow from steps and avoiding global state mutations. If you're building systems that need to survive failures or coordinate distributed work in Python, the workflow communication patterns and queue controls are worth the read.

skills.sh installs: 858
GitHub stars: 20
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add dbos-inc/agent-skills --skill dbos-python --agent claude-code

Installs into .claude/skills of the current project.

Files

DBOS Python Best Practices

Guide for building reliable, fault-tolerant Python applications with DBOS durable workflows. Targets DBOS Python 3.x.

When to Apply

Reference these guidelines when:

Adding DBOS to existing Python code
Creating workflows and steps
Using queues for concurrency control
Implementing workflow communication (events, messages, streams)
Configuring and launching DBOS applications
Using DBOSClient from external applications
Testing DBOS applications
Upgrading DBOS Python 2.x code to 3.x

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Lifecycle	CRITICAL	`lifecycle-`
2	Workflow	CRITICAL	`workflow-`
3	Step	HIGH	`step-`
4	Queue	HIGH	`queue-`
5	Communication	MEDIUM	`comm-`
6	Pattern	MEDIUM	`pattern-`
7	Testing	LOW-MEDIUM	`test-`
8	Client	MEDIUM	`client-`
9	Advanced	LOW	`advanced-`

Critical Rules

DBOS Configuration and Launch

A DBOS application MUST configure and launch DBOS inside its main function:

import os
from dbos import DBOS, DBOSConfig

SKILL.md on GitHub

Details

Repository: github.com/dbos-inc/agent-skills
Categories: Documentation, AI & Agent Building, Python
First seen: Jun 3, 2026