skills.rest
sandgardenhq
sandgardenhqOFFICIAL
Explore all skills by this author →
GitHub

set-workflow-state

Update workflow state files with status, task, and progress via sgai_update_workflow_state.

130|8|Updated Jan 23, 2026
Search Tags:#workflow#agent#status#progress#state#sgai
One-click install
npx skills add https://github.com/sandgardenhq/sgai --skill set-workflow-state
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: set-workflow-state
Source: https://github.com/sandgardenhq/sgai/tree/main/cmd/sgai/skel/.sgai/skills/set-workflow-state
Command: npx skills add https://github.com/sandgardenhq/sgai --skill set-workflow-state

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Agents need a reliable way to communicate their current activity, progress, and any roadblocks to the surrounding environment so that humans and other agents stay synchronized.

Core Features & Use Cases

  • State File Protocol: Defines a JSON schema for status, message, task, and progress logs.
  • Update Tool: Provides sgai_update_workflow_state for safe, consistent state modifications.
  • Human Interaction: Enables structured questions to the human partner via ask_user_question.
  • Message‑Driven Navigation: Integrates with inter‑agent messaging to route work and signal handoffs.

Quick Start

Tell the AI to run sgai_update_workflow_state with status working, a task description, and a progress note to update the workflow state.

Frequently Asked Questions about set-workflow-state

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

FAQPage Schema
How do I report task status and progress in a multi-agent AI workflow?▼

To report task status in a multi-agent AI workflow, use the sgai_update_workflow_state tool with status, task, and addProgress parameters. This updates a workflow state file, broadcasting current activity and progress to keep humans and other agents synchronized.

What is a workflow state file and when do I need it for AI agents?▼

A workflow state file is a JSON schema defining status, message, task, and progress logs for AI agents. You need it when agents must signal working, completion, or handoff states to reliably communicate their current activity and roadblocks within goal-driven projects.

How can an AI agent signal a task handoff to other agents?▼

An AI agent signals a task handoff by using the sgai_update_workflow_state tool to modify the workflow state file. This integrates with inter-agent messaging to route work and signal handoffs, ensuring all agents in the environment stay synchronized.

Can I use the workflow state update tool to ask the human partner questions?▼

Yes, you can ask the human partner questions through the ask_user_question feature. This enables structured human interaction while the agent updates the workflow state file to broadcast its current task status and progress.

Does the workflow state update tool require any external dependencies?▼

No, the workflow state update tool does not require any external dependencies or components. It provides the sgai_update_workflow_state tool to safely and consistently modify the workflow state file for status broadcasting.

Related Skills

Explore More Software Engineering Skills→
abhimehroabhimehro
2

create-subagent

Create subagents by adding Markdown files with YAML frontmatter.

Community
Advanced
GeargrindadminGeargrindadmin

message-bus

Manage inter-agent communication through a file-based message queue and board deliberation protocol.

Community
Advanced
ucirelloucirello
2

human-interaction

Poll workspace state and submit human input via a respond endpoint.

Community
Intermediate
dd-xiaozhidd-xiaozhi
2

flow-engine

Manage state transitions and event logging for multi-step AI development workflows.

Community
Advanced