← Back to Skills Marketplace
kangyishuai

Agent Workflow

by nano · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
237
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install agent-workflow
Description
A structured workflow plugin for OpenClaw agents. Guides work through brainstorm → plan → execute → verify → deliver with persistent state, branching, parall...
README (SKILL.md)

Agent Workflow

A structured workflow engine for OpenClaw agents. Migrated and generalized from the superpowers workflow system into a code-agnostic, general-purpose workflow plugin.

What it does

Provides a persistent state machine that guides your agent through a complete work lifecycle:

brainstorming → writing-plans → [execute] → verification → finishing-work
                                     ↓
                          subagent-driven-execution
                               OR
                          executing-plans

With support for:

  • Persistent state — workflow survives session restarts
  • Multi-project — run multiple workflows concurrently
  • Branching — choose execution strategy at branch points
  • Context-plugins — fork into review/parallel-agents without leaving main flow
  • Soft-guard goto — jump to any step with warnings about skipped prerequisites
  • 11 bundled Skills — covering the full workflow lifecycle

Installation

This is a Plugin, not a plain Skill. Install via:

openclaw plugins install clawhub:agent-workflow
openclaw gateway restart

Then enable in your ~/.openclaw/openclaw.json:

{
  "plugins": {
    "allow": ["agent-workflow"]
  },
  "tools": {
    "allow": ["agent_workflow"]
  }
}

Usage

In your agent (via Feishu, Discord, or any channel):

Start a new workflow for my Q2 planning project

The agent will call agent_workflow with action: "start" and guide you through the workflow.

Tool: agent_workflow

Action Description
start Begin a new workflow
status View current state (all active workflows if no ID given)
next Advance to the next step
goto Jump to any node (soft-guard warns about skipped steps)
complete Mark current node done
fork Activate a context-plugin without leaving main flow
join Complete a fork and return
getSkill Load full SKILL.md for the current node
list List all workflows
abandon Abandon a workflow

Bundled Skills

  • brainstorming — Turn ideas into specs
  • writing-plans — Break specs into tasks
  • executing-plans — Sequential execution
  • subagent-driven-execution — Parallel subagent execution
  • verification-before-completion — Evidence before claims
  • finishing-work — Delivery options
  • dispatching-parallel-agents — Fork independent tasks
  • requesting-review — Dispatch reviewer subagent
  • receiving-review — Evaluate feedback rigorously
  • systematic-problem-solving — Root-cause diagnosis
  • writing-skills — Create/improve Skills
Usage Guidance
This plugin appears to be what it claims — a persistent workflow engine that reads project files, writes workflow state, and dispatches subagents. Before installing: 1) Verify the plugin source (clawhub:agent-workflow) is trusted; if unsure, inspect the full source (especially src/state-store.ts and src/skill-loader.ts) for any network calls or unexpected file access. 2) Check the package contents that will be installed (the package-lock shows many SDKs not in package.json) to ensure no surprising third-party binaries are included. 3) Confirm you are comfortable with workflow state being written under ~/.openclaw (or set storageDir to a controlled location). 4) If you do not want autonomous agent invocation, keep disable-model-invocation or other policy controls in mind at the platform level. If you want, provide the contents of src/state-store.ts and src/workflow-engine.ts for a deeper review of file I/O and any network behavior.
Capability Analysis
Type: OpenClaw Skill Name: agent-workflow Version: 1.0.0 The bundle is a comprehensive workflow management plugin for OpenClaw agents, providing a persistent state machine to guide complex tasks. The TypeScript code (index.ts, src/state-store.ts) implements standard filesystem-based state management and tool registration without any suspicious network calls or shell executions. The bundled SKILL.md files use authoritative language to enforce process discipline (e.g., requiring root cause analysis and verification), but these instructions are strictly aligned with the stated goal of improving agent reliability and do not contain malicious prompt injections or instructions to exfiltrate data.
Capability Assessment
Purpose & Capability
The name/description (Agent Workflow) matches the code and SKILL.md: it registers an agent_workflow tool, provides workflow steps, and bundles SKILLs for brainstorming → plan → execute → verify → deliver. The plugin stores state (persistent workflows) and loads bundled skills — these capabilities are expected for a workflow manager. There are no declared env vars or external credentials that don't belong to this purpose.
Instruction Scope
SKILL.md explicitly tells agents to "explore project context — check existing files, docs, prior work" and to save artifacts (e.g., docs/specs/...). That file- and state-oriented behavior is coherent for a workflow plugin, but it does mean the plugin/skills will read and write workspace files and may dispatch subagents. Verify that behavior is acceptable for your environment (e.g., private repos, secrets in project files).
Install Mechanism
The SKILL.md instructs installation via the OpenClaw plugin hub (openclaw plugins install clawhub:agent-workflow). The repository provides code files rather than requiring arbitrary remote downloads or unusual install scripts. No extract-from-URL downloads or shorteners were present in the provided metadata.
Credentials
No environment variables, credentials, or config paths are required by the skill. One minor oddity: the included package-lock.json lists many SDKs (Anthropic, AWS clients, etc.) that are not present in package.json dependencies; these entries appear as dev or incidental entries in the lockfile. This is not necessarily malicious, but you should confirm the final published package contents and dev/vendor dependencies before installing from an untrusted source.
Persistence & Privilege
The plugin stores state under a storageDir (defaults to ~/.openclaw/workspace) and is not marked always:true. It requests normal plugin permissions (enable in openclaw.json and allow the agent_workflow tool). This level of persistence is expected for a workflow engine; ensure the default storage location and permissions are acceptable for your environment.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install agent-workflow
  3. After installation, invoke the skill by name or use /agent-workflow
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Agent Workflow v1.0.0 — Initial release. A structured workflow plugin for OpenClaw agents. Migrated and adapted from the superpowers workflow system (originally designed for Claude Code) into a general-purpose, code-agnostic workflow engine. Features: full workflow state machine (brainstorm → plan → execute → verify → deliver), persistent state across sessions, multi-project concurrency, branch support, context-plugins for parallel forks, soft-guard goto, and 11 bundled Skills covering the full workflow lifecycle. Includes agent_workflow tool with actions: start, status, next, goto, complete, fork, join, getSkill, list, abandon.
Metadata
Slug agent-workflow
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Agent Workflow?

A structured workflow plugin for OpenClaw agents. Guides work through brainstorm → plan → execute → verify → deliver with persistent state, branching, parall... It is an AI Agent Skill for Claude Code / OpenClaw, with 237 downloads so far.

How do I install Agent Workflow?

Run "/install agent-workflow" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Agent Workflow free?

Yes, Agent Workflow is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Agent Workflow support?

Agent Workflow is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Agent Workflow?

It is built and maintained by nano (@kangyishuai); the current version is v1.0.0.

💬 Comments