Can this skill auto-approve completed tasks?

Yes, if the internal confidence score meets or exceeds a predefined threshold (typically 95%), the state machine can transition a task to 'Done' without manual intervention.

Is this skill compatible with Linear?

Yes, the implementation includes specific logic to interface with Linear's API to update issue states, assignees, and comments based on the state machine logic.

How does the skill handle infinite loops?

It enforces configurable iteration limits for execution retries and feedback rounds, automatically escalating the task to a 'Blocked' state if the limit is reached.

What happens when a task becomes blocked?

The state machine moves the task to a 'Blocked' state, logs the specific transition error or dependency issue, and alerts the user for manual intervention.

What is the purpose of validation gates in this skill?

Validation gates ensure a task meets specific quality standards, such as passing all unit tests or having defined acceptance criteria, before it is allowed to transition to the next stage.

Workflow State Machine

Name: Workflow State Machine
Author: MadAppGang

byMadAppGang

•

214

•

Productivity & Workflow

Automates task lifecycle transitions with rigorous validation gates and iteration limits for reliable workflow management.

The Workflow State Machine skill provides a structured framework for managing task transitions within an autonomous development lifecycle. By enforcing validation gates between states like Todo, In Progress, and Done, it ensures that tasks only advance when specific criteria—such as passing tests, build success, or high confidence scores—are met. This skill is essential for teams using Claude for semi-autonomous task execution, as it prevents infinite loops through predefined iteration limits and automatically escalates blocked issues for human intervention, maintaining high standards for project velocity and code quality.

Key Features

01Rigorous entry conditions for starting and completing work

02Confidence-based auto-approval and manual review triggers

03Automatic escalation paths for blocked tasks and unresolvable dependencies

04Built-in iteration limits to prevent infinite execution loops

05Automated state transitions based on custom validation gates

06214 GitHub stars

Use Cases

01Standardizing task movement in project management tools like Linear

02Managing complex development workflows with clear escalation policies

03Automating QA gates for AI-generated code before human review

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add madappgang/claude-code state-machine

For use in Claude.ai and ChatGPT

Download Skill