job-state-machine

Manage asynchronous job state transitions with progress tracking and asset linking.

783|62|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/dadbodgeoff/drift --skill job-state-machine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: job-state-machine
Source: https://github.com/dadbodgeoff/drift/tree/main/drift%20v1%20depreciated/skills/job-state-machine
Command: npx skills add https://github.com/dadbodgeoff/drift --skill job-state-machine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that asynchronous jobs, such as image generation or data exports, are processed reliably with clear progress tracking and proper handling of success, failure, or partial completion.

Core Features & Use Cases

  • Validated State Transitions: Guarantees jobs move through predefined states (QUEUED, PROCESSING, COMPLETED, FAILED, PARTIAL) in a valid order.
  • Progress Tracking: Allows for real-time updates on the status of long-running operations.
  • Asset Linking: Enables associating generated assets (like images or reports) directly with the job that created them.
  • Use Case: When processing a large batch of user-uploaded images for a machine learning model, this Skill can manage the state of each image processing job, update its progress, and link the final processed image back to the original job.

Quick Start

Use the job-state-machine skill to create a new job for user 'user-123' of type 'image-processing'.

Frequently Asked Questions about job-state-machine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track progress for async job processing in TypeScript or Python?

Async job processing handles failures by validating state transitions to ensure jobs reach terminal states like FAILED or PARTIAL. This skill manages robust error handling in TypeScript and Python, preventing invalid state changes during execution.

Can I link generated assets directly to the job that created them during state machine execution?

Yes, asset linking associates generated assets like images or reports directly with their originating job. The state machine execution persists both job records and linked assets in a database, ensuring reliable asset management throughout the job lifecycle.

What is the best way to manage batch image processing state with validated transitions?

Managing batch image processing state requires validated state transitions through predefined states like QUEUED, PROCESSING, and COMPLETED. This skill ensures each image processing job follows a valid order, preventing invalid state changes during large batch operations.

Does this async job state machine support partial completion states for data exports?

Yes, the async job state machine supports partial completion states for data exports. Jobs can reach a PARTIAL state alongside COMPLETED or FAILED, ensuring proper handling of operations that complete with partial success during processing.