wheel-run

Resolve and validate local or plugin workflows, then activate wheel hooks.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill wheel-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wheel-run
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-wheel/skills/wheel-run
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill wheel-run

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Start a named workflow by resolving either a local workflow file or a plugin-provided workflow, validate the workflow JSON, and prepare per-agent state so wheel hooks can intercept and drive events.

Core Features & Use Cases

  • Resolve and validate workflow references (local and plugin-based).
  • Create per-agent state and activate wheel hook interception.
  • Confirm activation and provide progress checks via wheel-status and wheel-stop.

Quick Start

Provide the workflow name or plugin:workflow to start and activate the wheel-run workflow.

Frequently Asked Questions about wheel-run

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

FAQPage Schema
How do I automate starting a named workflow via hook activation?

You can start a workflow by providing the workflow name or plugin:workflow identifier, which resolves the reference and creates per-agent state to enable hook interception for driving automation events.

What is the mechanism behind wheel hooks for interactive event automation?

Wheel hooks intercept and drive Claude Code events by using per-agent state created during workflow activation, enabling validation, state preparation, and automated execution of interactive automation sequences.

Do I need a validation script before activating a workflow hook?

Yes, activating a workflow requires a validate-workflow script to validate the workflow JSON, along with per-agent state creation and hook-based activation to properly intercept and drive events.

How do I resolve a plugin-provided workflow versus a local workflow file?

Resolving a plugin-provided workflow uses the plugin:workflow naming convention, while local workflows are resolved by name, with both types requiring JSON validation before per-agent state creation and hook activation.

Can I check the progress of an activated workflow or stop it?

Once a workflow is activated, you can confirm activation and check progress via wheel-status, or halt execution using wheel-stop to manage the interactive automation lifecycle.

Why does my workflow activation fail during JSON validation?

Workflow activation fails when the validate-workflow script encounters invalid JSON structure in the local or plugin-provided workflow file, preventing per-agent state creation and hook-based interception.