set-workflow-state

Update workflow status, current task, and progress logs via a defined state schema.

2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/ucirello/sgai --skill set-workflow-state-ucirello
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: set-workflow-state
Source: https://github.com/ucirello/sgai/tree/main/cmd/sgai/skel/.sgai/skills/set-workflow-state
Command: npx skills add https://github.com/ucirello/sgai --skill set-workflow-state-ucirello

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a standardized mechanism for AI agents to communicate their operational status, current task, and progress updates to the broader workflow system and human supervisors.

Core Features & Use Cases

  • Status Reporting: Clearly indicates whether an agent is actively working, has completed its assigned task, or if the entire workflow is finished.
  • Task Tracking: Defines the specific task an agent is currently undertaking, offering real-time insight into the ongoing operations.
  • Progress Logging: Maintains an auditable trail of completed steps, decisions, and encountered issues, facilitating transparency and debugging.
  • Use Case: An agent working on code generation can use this skill to report "Writing unit tests for login module" and later update progress with "All tests passing for login module" before signaling agent-done.

Quick Start

Use the sgai_update_workflow_state tool to set the status to 'working' and add a progress note about starting the task.

Frequently Asked Questions about set-workflow-state

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

FAQPage Schema
How do I track progress and status in a multi-agent workflow?

To track progress in a multi-agent workflow, agents use a defined state schema and tool-based updates to report their current task, operational status, and progress logs to human supervisors and other agents.

How does agent communication work for workflow state management?

Agent communication for workflow state management works through a standardized mechanism where agents update a shared workflow system with their status, such as actively working or completed, and maintain an auditable trail of decisions and steps.

What's the best way to report task status to a human supervisor in an AI system?

The best way to report task status to a human supervisor is by updating the workflow state to indicate active work or completion while logging specific progress notes, such as passing unit tests, for real-time insight and debugging.

Can I use a state schema to signal that an agent is done with its assigned task?

Yes, you can use a state schema to signal an agent is done by updating the workflow status to a completed state and logging the final progress notes before signaling agent-done to the broader workflow system.

When do I need a defined state schema for progress tracking in agent systems?

You need a defined state schema for progress tracking when managing multi-agent system execution that requires transparency, status reporting across agents, and an auditable trail of completed steps and encountered issues.