Shellflow Playbook Authoring

Overview

Shellflow playbooks are normal shell scripts with comment markers. The script remains valid shell for humans, while Shellflow uses markers to split execution into isolated local and remote blocks, pass explicit context between blocks, and emit structured results for agents.

Generate ordinary shell first. Then apply Shellflow rules for block boundaries, prelude freezing, remote host resolution, dynamic options, task selection, lifecycle hooks, and agent-safe output.

When to Use

Use this skill when:

• Writing a new Shellflow playbook.
• Refactoring a shell script into # @LOCAL and # @REMOTE blocks.
• Reviewing Shellflow parser compatibility.
• Explaining block isolation, prelude behavior, exports, tasks, hooks, or parallel execution.
• Preparing a script for shellflow run --json, --jsonl, or agent-run.

Do not use this skill for: