{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/runbook",
  "version": "1.0.0",
  "name": "runbook",
  "description": "Create or update an operational runbook for a recurring task or procedure. Use when documenting a task that on-call or ops needs to run repeatably, turning tribal knowledge into exact step-by-step commands, adding troubleshooting and rollback steps to an existing procedure, or writing escalation paths for when things go wrong.",
  "system_prompt_fragment": "# /runbook\n\n> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../../CONNECTORS.md).\n\nCreate a step-by-step operational runbook for a recurring task or procedure.\n\n## Usage\n\n```\n/runbook $ARGUMENTS\n```\n\n## Output\n\n```markdown\n## Runbook: [Task Name]\n**Owner:** [Team/Person] | **Frequency:** [Daily/Weekly/Monthly/As Needed]\n**Last Updated:** [Date] | **Last Run:** [Date]\n\n### Purpose\n[What this runbook accomplishes and when to use it]\n\n### Prerequisites\n- [ ] [Access or permission needed]\n- [ ] [Tool or system required]\n- [ ] [Data or input needed]\n\n### Procedure\n\n#### Step 1: [Name]\n```\n[Exact command, action, or instruction]\n```\n**Expected result:** [What should happen]\n**If it fails:** [What to do]\n\n#### Step 2: [Name]\n```\n[Exact command, action, or instruction]\n```\n**Expected result:** [What should happen]\n**If it fails:** [What to do]\n\n### Verification\n- [ ] [How to confirm the task completed successfully]\n- [ ] [What to check]\n\n### Troubleshooting\n| Symptom | Likely Cause | Fix |\n|---------|-------------|-----|\n| [What you see] | [Why] | [What to do] |\n\n### Rollback\n[How to undo this if something goes wrong]\n\n### Escalation\n| Situation | Contact | Method |\n|-----------|---------|--------|\n| [When to escalate] | [Who] | [How to reach them] |\n\n### History\n| Date | Run By | Notes |\n|------|--------|-------|\n| [Date] | [Person] | [Any issues or observations] |\n```\n\n## If Connectors Available\n\nIf **~~knowledge base** is connected:\n- Search for existing runbooks to update rather than create from scratch\n- Publish the completed runbook to your ops wiki\n\nIf **~~ITSM** is connected:\n- Link the runbook to related incident types and change requests\n- Auto-populate escalation contacts from on-call schedules\n\n## Tips\n\n1. **Be painfully specific** — \"Run the script\" is not a step. \"Run `python sync.py --prod --dry-run` from the ops server\" is.\n2. **Include failure modes** — What can go wrong at each step and what to do about it.\n3. **Test the runbook** — Have someone unfamiliar with the process follow it. Fix where they get stuck.",
  "applicable_domains": [
    "operations",
    "process"
  ],
  "invocation": [
    "/runbook",
    "/runbook <process or task name>"
  ],
  "tags": [
    "operations",
    "anthropics",
    "knowledge-work"
  ],
  "authored_by": "anthropics",
  "source_url": "https://github.com/anthropics/knowledge-work-plugins/blob/main/operations/skills/runbook/SKILL.md",
  "lifecycle": "stable",
  "category": "operations",
  "provenance": {
    "source": "anthropics/knowledge-work-plugins",
    "source_url": "https://github.com/anthropics/knowledge-work-plugins/blob/main/operations/skills/runbook/SKILL.md",
    "author": "Anthropic",
    "license": "Apache-2.0",
    "notes": "Imported by scripts/import-anthropic-skills.py."
  }
}