sop-runner-v2

Execute TOML and Markdown SOPs with conditional steps and approval gates.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/winsorllc/upgraded-carnival --skill sop-runner-v2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sop-runner-v2
Source: https://github.com/winsorllc/upgraded-carnival/tree/main/.pi/skills/sop-runner-v2
Command: npx skills add https://github.com/winsorllc/upgraded-carnival --skill sop-runner-v2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the execution of Standard Operating Procedures (SOPs), managing complex multi-step workflows, conditional logic, and manual approval gates to ensure reliable and auditable process execution.

Core Features & Use Cases

  • Workflow Automation: Execute defined SOPs with deterministic steps.
  • Conditional Logic: Dynamically control workflow paths based on runtime conditions.
  • Approval Gates: Integrate human oversight at critical stages of a process.
  • Audit Logging: Maintain a comprehensive record of all SOP executions, including steps, timings, and outcomes.
  • Use Case: Automate a software deployment process that includes running tests, building a release, deploying to staging, verifying staging, and finally deploying to production, requiring manual approval before the production deployment.

Quick Start

Use the sop-runner-v2 skill to execute the 'deploy-production' SOP with the variable 'version' set to '1.2.3'.

Frequently Asked Questions about sop-runner-v2

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

FAQPage Schema
How do I automate a multi-step workflow with manual approval gates?

You can automate a multi-step workflow with manual approval gates by defining Standard Operating Procedures (SOPs) in TOML and Markdown formats. The system orchestrates these workflows by executing scripts via child_process and pausing for human oversight at critical stages.

How do I execute conditional workflow paths based on runtime conditions?

Conditional workflow paths are executed by defining dynamic logic within your SOP definitions. The orchestration engine evaluates runtime conditions to determine whether to execute, skip, or branch specific steps in the workflow.

Can I trigger SOP execution using file watches and schedules?

Yes, you can trigger SOP execution using multiple methods including file watches, schedules, and commands. The system supports these multiple trigger types to automatically initiate workflows based on your operational requirements.

What is the best way to maintain an audit log for automated process execution?

The best way to maintain an audit log for automated process execution is using an SOP orchestration engine with detailed logging. It records comprehensive execution details, including steps, timings, and outcomes, ensuring reliable and verifiable process tracking.

How do I manage Standard Operating Procedures via API endpoints?

You manage Standard Operating Procedures via provided API endpoints designed for creating, updating, and executing SOPs. These endpoints interface with the orchestration engine to control your TOML and Markdown defined workflows programmatically.

Do I need to define SOPs in TOML and Markdown to automate deployment workflows?

Yes, you need to define SOPs in TOML and Markdown to automate deployment workflows. The orchestration engine parses these structured definitions to execute deterministic steps, manage conditional logic, and enforce manual approval gates.