{"id":"c020c455-eca8-4f82-9022-86ed5756d685","shortId":"ffkrAS","kind":"skill","title":"dbos-typescript","tagline":"Guide for building reliable, fault-tolerant TypeScript applications with DBOS durable workflows. Use when adding DBOS to existing TypeScript code, creating workflows and steps, or using queues for concurrency control.","description":"# DBOS TypeScript Best Practices\n\nGuide for building reliable, fault-tolerant TypeScript applications with DBOS durable workflows.\n\n## When to Use\nReference these guidelines when:\n- Adding DBOS to existing TypeScript code\n- Creating workflows and steps\n- Using queues for concurrency control\n- Implementing workflow communication (events, messages, streams)\n- Configuring and launching DBOS applications\n- Using DBOSClient from external applications\n- Testing DBOS applications\n\n## Rule Categories by Priority\n\n| Priority | Category | Impact | Prefix |\n|----------|----------|--------|--------|\n| 1 | Lifecycle | CRITICAL | `lifecycle-` |\n| 2 | Workflow | CRITICAL | `workflow-` |\n| 3 | Step | HIGH | `step-` |\n| 4 | Queue | HIGH | `queue-` |\n| 5 | Communication | MEDIUM | `comm-` |\n| 6 | Pattern | MEDIUM | `pattern-` |\n| 7 | Testing | LOW-MEDIUM | `test-` |\n| 8 | Client | MEDIUM | `client-` |\n| 9 | Advanced | LOW | `advanced-` |\n\n## Critical Rules\n\n### Installation\n\nAlways install the latest version of DBOS:\n\n```bash\nnpm install @dbos-inc/dbos-sdk@latest\n```\n\n### DBOS Configuration and Launch\n\nA DBOS application MUST configure and launch DBOS before running any workflows:\n\n```typescript\nimport { DBOS } from \"@dbos-inc/dbos-sdk\";\n\nasync function main() {\n  DBOS.setConfig({\n    name: \"my-app\",\n    systemDatabaseUrl: process.env.DBOS_SYSTEM_DATABASE_URL,\n  });\n  await DBOS.launch();\n  await myWorkflow();\n}\n\nmain().catch(console.log);\n```\n\n### Workflow and Step Structure\n\nWorkflows are comprised of steps. Any function performing complex operations or accessing external services must be run as a step using `DBOS.runStep`:\n\n```typescript\nimport { DBOS } from \"@dbos-inc/dbos-sdk\";\n\nasync function fetchData() {\n  return await fetch(\"https://api.example.com\").then(r => r.json());\n}\n\nasync function myWorkflowFn() {\n  const result = await DBOS.runStep(fetchData, { name: \"fetchData\" });\n  return result;\n}\nconst myWorkflow = DBOS.registerWorkflow(myWorkflowFn);\n```\n\n### Key Constraints\n\n- Do NOT call, start, or enqueue workflows from within steps\n- Do NOT use threads or uncontrolled concurrency to start workflows - use `DBOS.startWorkflow` or queues\n- Workflows MUST be deterministic - non-deterministic operations go in steps\n- Do NOT modify global variables from workflows or steps\n\n## How to Use\n\nRead individual rule files for detailed explanations and examples:\n\n```\nreferences/lifecycle-config.md\nreferences/workflow-determinism.md\nreferences/queue-concurrency.md\n```\n\n## References\n\n- https://docs.dbos.dev/\n- https://github.com/dbos-inc/dbos-transact-ts\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["dbos","typescript","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-dbos-typescript","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/dbos-typescript","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34831 github stars · SKILL.md body (2,896 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T06:51:01.833Z","embedding":null,"createdAt":"2026-04-18T21:35:46.071Z","updatedAt":"2026-04-24T06:51:01.833Z","lastSeenAt":"2026-04-24T06:51:01.833Z","tsv":"'/dbos-inc/dbos-transact-ts':326 '/dbos-sdk':155,180,234 '1':101 '2':105 '3':109 '4':113 '5':117 '6':121 '7':125 '8':131 '9':135 'access':216 'ad':19,59 'advanc':136,138 'alway':142 'api.example.com':241 'app':188 'applic':12,47,84,89,92,163 'ask':360 'async':181,235,245 'await':194,196,239,250 'bash':149 'best':37 'boundari':368 'build':6,41 'call':265 'catch':199 'categori':94,98 'clarif':362 'clear':335 'client':132,134 'code':24,64 'comm':120 'communic':76,118 'complex':213 'compris':207 'concurr':33,72,279 'configur':80,158,165 'console.log':200 'const':248,257 'constraint':262 'control':34,73 'creat':25,65 'criteria':371 'critic':103,107,139 'databas':192 'dbos':2,14,20,35,49,60,83,91,148,153,157,162,168,175,178,229,232 'dbos-inc':152,177,231 'dbos-typescript':1 'dbos.launch':195 'dbos.registerworkflow':259 'dbos.runstep':226,251 'dbos.setconfig':184 'dbos.startworkflow':284 'dbosclient':86 'describ':339 'detail':315 'determinist':290,293 'docs.dbos.dev':323 'durabl':15,50 'enqueu':268 'environ':351 'environment-specif':350 'event':77 'exampl':318 'exist':22,62 'expert':356 'explan':316 'extern':88,217 'fault':9,44 'fault-toler':8,43 'fetch':240 'fetchdata':237,252,254 'file':313 'function':182,211,236,246 'github.com':325 'github.com/dbos-inc/dbos-transact-ts':324 'global':301 'go':295 'guid':4,39 'guidelin':57 'high':111,115 'impact':99 'implement':74 'import':174,228 'inc':154,179,233 'individu':311 'input':365 'instal':141,143,151 'key':261 'latest':145,156 'launch':82,160,167 'lifecycl':102,104 'limit':327 'low':128,137 'low-medium':127 'main':183,198 'match':336 'medium':119,123,129,133 'messag':78 'miss':373 'modifi':300 'must':164,219,288 'my-app':186 'myworkflow':197,258 'myworkflowfn':247,260 'name':185,253 'non':292 'non-determinist':291 'npm':150 'oper':214,294 'output':345 'pattern':122,124 'perform':212 'permiss':366 'practic':38 'prefix':100 'prioriti':96,97 'process.env.dbos':190 'queue':31,70,114,116,286 'r':243 'r.json':244 'read':310 'refer':55,322 'references/lifecycle-config.md':319 'references/queue-concurrency.md':321 'references/workflow-determinism.md':320 'reliabl':7,42 'requir':364 'result':249,256 'return':238,255 'review':357 'rule':93,140,312 'run':170,221 'safeti':367 'scope':338 'servic':218 'skill':330 'skill-dbos-typescript' 'source-sickn33' 'specif':352 'start':266,281 'step':28,68,110,112,203,209,224,272,297,306 'stop':358 'stream':79 'structur':204 'substitut':348 'success':370 'system':191 'systemdatabaseurl':189 'task':334 'test':90,126,130,354 'thread':276 'toler':10,45 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':343 'typescript':3,11,23,36,46,63,173,227 'uncontrol':278 'url':193 'use':17,30,54,69,85,225,275,283,309,328 'valid':353 'variabl':302 'version':146 'within':271 'workflow':16,26,51,66,75,106,108,172,201,205,269,282,287,304","prices":[{"id":"745faf81-1fe6-4920-9893-e914a7ddaab9","listingId":"c020c455-eca8-4f82-9022-86ed5756d685","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:35:46.071Z"}],"sources":[{"listingId":"c020c455-eca8-4f82-9022-86ed5756d685","source":"github","sourceId":"sickn33/antigravity-awesome-skills/dbos-typescript","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/dbos-typescript","isPrimary":false,"firstSeenAt":"2026-04-18T21:35:46.071Z","lastSeenAt":"2026-04-24T06:51:01.833Z"}],"details":{"listingId":"c020c455-eca8-4f82-9022-86ed5756d685","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"dbos-typescript","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34831,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"265bce46ccbd92580e9df007f7b35f06b60a6e08","skill_md_path":"skills/dbos-typescript/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/dbos-typescript"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"dbos-typescript","description":"Guide for building reliable, fault-tolerant TypeScript applications with DBOS durable workflows. Use when adding DBOS to existing TypeScript code, creating workflows and steps, or using queues for concurrency control."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/dbos-typescript"},"updatedAt":"2026-04-24T06:51:01.833Z"}}