Can I mix shell scripts and AI prompts in one runbook?

Yes, the skill can execute 'shell' actions via Bash and 'prompt' actions by following natural language instructions or invoking other Claude skills.

How do I define a new runbook for this skill?

Runbooks are defined in a `.claude/runbooks.json` file within your project directory, where you can specify names, descriptions, and a sequence of actions.

What happens if a specific step in the runbook fails?

The Runbook Runner uses a fail-fast approach; it will stop execution immediately, report the error, and suggest a fix before you re-run the command.

Which dynamic variables are supported in runbook actions?

The skill currently supports `{{task_description}}`, `{{date}}` (YYYY-MM-DD), and `{{branch}}` (current git branch) for automatic interpolation.

Runbook Runner

Name: Runbook Runner
Author: jason-hchsieh

byjason-hchsieh

0•

Productivity & Workflow

Automates the sequential execution of predefined operational procedures and multi-step commands directly within Claude Code.

The Runbook Runner skill allows you to transform static documentation into executable workflows by managing and running automated 'runbooks' defined in your project. It enables the sequential execution of both shell commands and natural language prompts, complete with dynamic variable interpolation for dates, git branches, and task descriptions. This skill is ideal for teams looking to standardize complex procedures like deployments, versioning, or environment setups, ensuring consistency and reducing manual errors through a controlled, step-by-step execution engine.

Key Features

01Sequential execution of shell commands and prompt-based actions

02Fail-fast error handling to prevent cascading issues during complex workflows

03Real-time execution feedback with clear success and failure reporting

04Interactive runbook selection from local .claude/runbooks.json files

05Dynamic template variable resolution for context-aware automation

060 GitHub stars

Use Cases

01Automating routine environment maintenance and system health checks

02Streamlining complex git workflows that require specific command sequences

03Standardizing multi-step versioning and deployment cycles (e.g., bump, commit, push)

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jason-hchsieh/marketplace runbook-run

For use in Claude.ai and ChatGPT

Download Skill