korchasa/run
claude-plugin/plugins/flowai-workflow/skills/run/SKILL.md
Execute a bundled or project-local flowai-workflow DAG. Use to launch a workflow run from inside Claude Code without installing the CLI separately.
tools
Updated May 25, 2026
$ install --global
skillsauthnpx skillsauth add korchasa/flowai-workflow runInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 25, 2026, 4:58 AM122.6s1 file scanned
SKILL.md
- name:
- run
- description:
- Execute a bundled or project-local flowai-workflow DAG. Use to launch a workflow run from inside Claude Code without installing the CLI separately.
- argument-hint:
- workflow name or path (e.g. github-inbox or .flowai-workflow/<name>)
- effort:
- low
Run flowai-workflow
Execute a flowai-workflow DAG via the plugin-bundled engine. The plugin
ships the engine TypeScript source under $CLAUDE_PLUGIN_ROOT/engine/
and the canonical bundled workflows under
$CLAUDE_PLUGIN_ROOT/.flowai-workflow/<name>/. Runs use the host's
locally-installed Deno 2.x.
Preflight
Before launching, verify Deno is on PATH:
command -v deno >/dev/null 2>&1 || { echo "Error: Deno 2.x is required — install from https://deno.com/ then retry." >&2; exit 127; }
If Deno is missing, stop and report the install link. Do not silently fall back to a different runtime or skip the run.
Resolve the workflow
The first positional argument names the workflow. Resolve it in this order:
- If the argument is an existing directory containing
workflow.yaml, use it as-is. - If the argument matches a sibling under
$CLAUDE_PLUGIN_ROOT/.flowai-workflow/, use that bundled folder. - If the argument matches a sibling under
<project-root>/.flowai-workflow/, use the project-local copy. - Otherwise, list available workflows and ask the user which one to run.
Launch
FLOWAI_SUPPRESS_DEPRECATION=1 \
deno run -A "$CLAUDE_PLUGIN_ROOT/engine/cli.ts" run "<resolved-workflow-path>" [extra args]
FLOWAI_SUPPRESS_DEPRECATION=1 silences the legacy JSR/binary
deprecation banner — irrelevant inside the plugin install.
Forward any additional CLI flags the user provides (e.g. --prompt,
--dry-run, --cycles). Stream output back to the user in normal
verbosity unless they asked for -v / -q.
Common flags
--prompt "<text>"— extra context for the PM agent--resume <run-id>— resume a previous run--dry-run— print the execution plan without running-v/-s/-q— verbose / semi-verbose / quiet--cycles <N>— repeat the run N times sequentially
Errors
- "Missing workflow.yaml" → the resolved path is wrong; list candidates again and re-prompt.
- "Workflow validation failed" → surface the engine's error verbatim;
point the user at
scaffoldto adapt the config. - "Permission denied: …" — the engine writes under
<workflow>/runs/<run-id>/and the per-run worktree; if the workflow lives under$CLAUDE_PLUGIN_ROOT/.flowai-workflow/(which is read-only by convention), instruct the user to firstflowai-workflow:initinto their project so runs can write into the project-local copy.
Related Skills
korchasa/supervisor
development
VerifiedTrustedCommunity
Supervisor for one flowai-workflow run (Codex). Starts or resumes a single workflow, diagnoses failures from run artifacts, patches root causes, resumes the same run. Run inside an isolated Codex worker subagent spawned by the `supervise`/`orchestrate` skill.
SKILL.mdUpdated Jun 4, 2026
korchasa/orchestrator
development
VerifiedTrustedCommunity
Long-cycle flowai-workflow orchestrator (Codex). Reads project orchestration policy, selects the next workflow, and returns a structured supervisor delegation request. Run inside an isolated Codex worker subagent spawned by the `orchestrate` skill.
SKILL.mdUpdated Jun 4, 2026
korchasa/supervise
data-ai
VerifiedTrustedCommunity
Live flowai-workflow run supervisor. Use only for requests to run, monitor, continue, or resume a current workflow now. Exclude last-night, finished, post-mortem, root-cause-report, and conceptual questions.
SKILL.mdUpdated May 31, 2026
korchasa/scaffold
data-ai
VerifiedTrustedCommunity
Scaffold or adapt flowai-workflow DAGs in a project. Use for adding flowai-workflow, adapting an existing .flowai-workflow/<name>, validating workflow.yaml, or wiring agent prompts/scripts.
SKILL.mdUpdated May 31, 2026