# Agent Runbook Skill

> agent-runbook-skill

- Skill: `rogerchappel/agent-runbook-skill` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add rogerchappel/agent-runbook-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rogerchappel/agent-runbook-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: rogerchappel (https://skillmd.com/u/rogerchappel)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/rogerchappel/agent-runbook-skill

---

# agent-runbook-skill

## When to Use

Use this skill when an agent receives a human Markdown runbook and needs a dry-run action plan before touching files, tools, or external systems. It may read local runbook files only. It must not execute the runbook. External writes, deploys, publishes, messages, destructive commands, and approvals remain outside the skill boundary and require explicit user approval. Imperative destructive actions are classified as `approval-required`; command-shaped `git push`, `npm publish`, `gh pr create`, `gh issue create`, `gh release create`, and `gh pr merge` actions are classified as `external-write`, including after `Run` / `Execute` and supported `sudo`, `doas`, `command`, or assignment-bearing `env` prefixes. Command-shaped `git commit`, package test/build commands (`npm`, `pnpm`, `yarn`, and `bun`), the allowlisted `npm run lint`, `npm run check`, `npm run smoke`, `npm run release:check`, `npm run release:readiness`, and `npm run package:smoke` verification scripts, and `cp`, `mv`, `touch`, and `mkdir` actions are classified as `local-change`, including explicit `Run` / `Execute` wrappers and `then` / `and then` sequences. Other package scripts are not inferred to be local changes. Inspection and documentation wording that only discusses these operations remains read-only. Validate by running the fixture smoke command and reviewing the action classes before acting.

## Required Inputs

Local files supplied by the user or repository fixtures.

## Side Effects

Read-only. The CLI writes results to stdout only.

## Validation

Run `npm test`, `npm run check`, and `npm run smoke`.