run-workflow

Execute saved workflow JSON files through a project-specific runner.

19|14|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/X-School-Academy/skill-pilot --skill run-workflow-x-school-academy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-workflow
Source: https://github.com/X-School-Academy/skill-pilot/tree/main/core/skills/system/run-workflow
Command: npx skills add https://github.com/X-School-Academy/skill-pilot --skill run-workflow-x-school-academy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows users to execute pre-defined workflow configurations stored as JSON files, automating complex sequences of tasks without manual intervention.

Core Features & Use Cases

  • Workflow Execution: Runs saved workflow JSON files using a dedicated project runner.
  • Prompt Integration: Allows execution of workflows with specific user prompts to guide the process.
  • Use Case: If you have a workflow named customer-onboarding-flow.json designed to set up new clients, you can use this Skill to run it with the prompt "Onboard new client: Acme Corp".

Quick Start

Run the workflow file located at core/workflows/customer-support-flow.json with the prompt to create a new support ticket.

Frequently Asked Questions about run-workflow

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

FAQPage Schema
How do I execute a saved workflow JSON file from the command line?

You can execute a workflow by providing its name, a relative path under core/workflows/, or any project root relative path. The runner validates both the workflow file and the entry point before execution begins.

Can I pass custom prompts when running an automated workflow?

Yes, you can pass user-provided prompts when running an automated workflow to guide the execution process. This enables dynamic parameterization of tasks, such as specifying client details during onboarding sequences.

What happens if a workflow file or runner entry point is missing?

If a workflow file or runner entry point is missing, the workflow execution fails. The runner explicitly validates the existence of both the JSON file and the entry point before attempting to run the workflow.

Does workflow automation require specific file paths for execution?

Workflow automation does not require a single rigid file path. You can execute workflows by their name, via a relative path under core/workflows/, or by specifying any path relative to the project root.

What is the best way to automate complex task sequences without manual intervention?

Automating complex task sequences is best handled by defining pre-defined configurations as JSON files and executing them through a dedicated project runner. This approach eliminates manual intervention by validating and processing tasks sequentially.