What are template variables?

Template variables are placeholders like {{branch}}, {{date}}, or {{task_description}} that are automatically replaced with real-time data when the runbook runs.

Where are the runbooks stored?

Runbooks are saved locally in the .claude/runbooks.json file within your project root, making them easy to track in version control.

How do I trigger a runbook manually?

You can define a runbook with the manual trigger and then invoke it using the /runbook-run command whenever you need it.

What is the difference between auto and ask modes?

Auto executes actions immediately upon the trigger, while ask mode shows the user what will run and waits for confirmation before execution.

Can I use my own shell commands?

Yes, the skill supports a shell action type for deterministic Bash commands like git or npm operations that don't require AI reasoning.

Runbook Automation

Name: Runbook Automation
Author: jason-hchsieh

byjason-hchsieh

0•

Productivity & Workflow

Automates repetitive task sequences by registering custom runbooks with specific triggers and action types.

Runbook Automation allows developers to define and persist complex workflows within Claude Code, ensuring consistency across repetitive tasks. By registering runbooks in a local configuration file, users can automate post-task activities like version bumping, committing code, or running test suites whenever specific conditions are met. The skill supports both interactive 'ask' modes for safety and 'auto' modes for speed, utilizing both direct shell commands and intelligent natural language prompts to guide Claude through multi-step operations.

Key Features

01Register automated sequences of shell commands and Claude instructions

020 GitHub stars

03Intelligent action classification between shell commands and prompts

04Use template variables for dynamic data like branch names and dates

05Define triggers like task completion or manual invocation

06Choose between automatic execution or user-confirmed ask mode

Use Cases

01Running a specific suite of linting and test commands before manual deployment

02Creating custom multi-step workflows that guide Claude through complex architectural reviews

03Automating version bumps and git pushes after every completed task

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jason-hchsieh/marketplace runbook-register

For use in Claude.ai and ChatGPT

Download Skill