Agent skill

Support Runbook

by mohitagw15856 in mohitagw15856/pm-claude-skills

Write a support runbook for handling a recurring issue type consistently.

MITAuto-check passedDevOps & Cloud

Install Support Runbook

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill support-runbook -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills support-runbook --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/support-runbook .claude/skills/support-runbook && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
support-runbook
GitHub stars
1.4k
Token cost
~984 tokens
SKILL.md length
497 words
Files
1
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Write a support runbook for handling a recurring issue type consistently.

  • Asked to write a support runbook
  • SKILL.md covers Required Inputs, Output Format, Quality Checks and Anti-Patterns, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • A troubleshooting playbook for agents

What it does

Support Runbook is an agent skill from mohitagw15856/pm-claude-skills. Write a support runbook for handling a recurring issue type consistently. Use when asked to write a support runbook, a troubleshooting playbook for agents, a handling guide for a common issue, or a tier-1 response procedure. Produces a runbook — issue identification, triage/severity, step-by-step diagnosis & resolution, decision tree, when/how to escalate, and the customer-comms templates — so any agent resolves it the same way.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Runbooks and postmortems. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked to write a support runbook
  • A troubleshooting playbook for agents
  • A handling guide for a common issue
  • A tier-1 response procedure

Example prompts

  • “/support-runbook”

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Support Runbook loads about 984 tokens when it runs. Until then it costs about 112 tokens; SKILL.md has 497 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~112
When it runs · the whole SKILL.md, loaded when a task matches
~984

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 497 words, ~984 tokens.

Download SKILL.mdSave it as .claude/skills/support-runbook/SKILL.md (or your agent's skills folder).
name
support-runbook
description
Write a support runbook for handling a recurring issue type consistently. Use when asked to write a support runbook, a troubleshooting playbook for agents, a handling guide for a common issue, or a tier-1 response procedure. Produces a runbook — issue identification, triage/severity, step-by-step diagnosis & resolution, decision tree, when/how to escalate, and the customer-comms templates — so any agent resolves it the same way.

Support Runbook Skill

When the same issue hits support repeatedly, every agent shouldn't reinvent the fix. A support runbook makes the resolution consistent and fast: how to recognise it, how urgent it is, the diagnostic steps, the decision tree, and exactly when to escalate (with what info). This skill writes that — turning tribal knowledge into a procedure tier-1 can follow.

Required Inputs

Ask for these only if they aren't already provided:

  • The issue type — the recurring problem this runbook covers (e.g. "sync failures," "login loops," "billing discrepancy").
  • How to recognise it — symptoms and how it's reported.
  • The resolution path(s) — diagnostic steps and fixes (including the branches — "if X then…").
  • Escalation — when it exceeds tier-1, who it goes to, and with what diagnostics.

Output Format

Support Runbook: [issue type]

1. Identify — the symptoms and how customers describe it (so agents recognise it from a vague ticket). What it's often confused with.

2. Severity / triage — how to rate urgency (is it down vs. degraded vs. cosmetic? affecting one user or many?) and the response-time expectation per level.

3. Diagnose — ordered steps to pinpoint the cause; what to check and what each result means. A decision tree where the path branches:

If [symptom A] → likely [cause] → go to Fix 1. If [symptom B] → check [thing] → if yes, Fix 2; if no, escalate.

4. Resolve — the fix per branch, step by step, including what to tell the customer to do (and what not to touch).

5. Escalate — the exact trigger to escalate (time-boxed: "if unresolved in N min" or "if it affects >X users"), who to (team/tier), and the diagnostics to attach so the next tier doesn't start cold.

6. Customer comms — ready snippets for the key moments: acknowledging, mid-resolution update, resolved, and "escalating, here's what's next" (pair with support-macro).

7. Prevention note — if this issue recurs a lot, the upstream fix/feature to flag to product/eng.

Show full SKILL.md (185 more words)Show less

Quality Checks

  • Identification covers how customers actually describe it (not just the internal name)
  • Severity/triage guidance sets response expectations
  • Diagnosis is a clear ordered path / decision tree, not a wall of tips
  • Escalation has an explicit trigger, target, and the diagnostics to attach
  • Customer-comms snippets cover acknowledge / update / resolve / escalate
  • Flags the upstream fix if the issue is frequent (so support feeds product)

Anti-Patterns

  • Do not write a tip list instead of an ordered path — agents need "do this, then this," with branches
  • Do not leave escalation vague — "escalate if needed" means everyone escalates differently; time-box and specify the target + attachments
  • Do not omit the customer comms — resolution + silence still feels like bad support
  • Do not ignore severity — treating a full outage like a how-to question loses trust fast
  • Do not let a high-frequency issue stay a runbook forever — flag the root-cause fix to product

Based On

Support-operations practice — issue triage, decision-tree diagnosis, time-boxed escalation, and consistent agent procedures.

Example Trigger Phrases

  • "Write a support runbook."
  • "Write a troubleshooting playbook for agents."
  • "Write a handling guide for this common issue."
  • "Write the tier-1 response procedure."

© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/support-runbook of mohitagw15856/pm-claude-skills.

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Support Runbook next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Support Runbook compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Support Runbook this skillmohitagw15856/pm-claude-skills1.4k—~984Automated safety check: PassMIT
Trader Memory Coretradermonty/claude-trading-skills3k2 repos~4.3kAutomated safety check: PassMIT
Author Migrationnrwl/nx29k—~12kAutomated safety check: NotesMIT
Write Notes Like Deepseekczm15053/write-notes-like-deepseek508—~2kAutomated safety check: PassNone
OpenRig Upgrade Proceduremvschwarz/openrig6.8k—~2.9kAutomated safety check: PassApache-2.0
GreptimeDB Release RunbookGreptimeTeam/greptimedb6.7k—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Trader Memory Core

    tradermonty/claude-trading-skills

    Track investment theses across their lifecycle — from screening idea to closed position with postmortem.

    3k GitHub starsUsed in 2 repos~4.3k tokens
    DevOps & CloudAuto-check passed
  • Author or scope a first-party Nx migration. An agent skill from nrwl/nx.

    29k GitHub stars~12k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Write Notes Like Deepseek

    czm15053/write-notes-like-deepseek

    A skill your agent uses when a change is non-trivial by DSH standards (behavior, architecture, cross-file contracts, process/tooling, testing strategy, or on-disk/wire/config formats), when choosing…

    508 GitHub stars~2k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • OpenRig Upgrade Procedure

    mvschwarz/openrig

    Walks an agent through upgrading the OpenRig CLI and daemon one observed step at a time, keeping live seats alive and reconciling managed plugin files.

    6.8k GitHub stars~2.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • GreptimeDB Release Runbook

    GreptimeTeam/greptimedb

    Runbook for publishing a GreptimeDB version: pick the release branch, verify the Cargo version, then tag, create the GitHub release and open the docs note PR.

    6.7k GitHub stars~1.4k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Statem

    henryqin1997/statem

    A skill your agent uses when a long coding or research task should be managed with statem state-machine runbooks, including creating specs, starting or resuming runs, checking current state…

    1.3k GitHub stars~1.2k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Support Runbook

What does Support Runbook do?

Write a support runbook for handling a recurring issue type consistently. Support Runbook is an agent skill from mohitagw15856/pm-claude-skills. Write a support runbook for handling a recurring issue type consistently.

When should I use Support Runbook?

Support Runbook fits situations like: asked to write a support runbook; A troubleshooting playbook for agents; A handling guide for a common issue; A tier-1 response procedure.

How do I install Support Runbook in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill support-runbook -a claude-code`. Or copy the skill folder (skills/support-runbook in mohitagw15856/pm-claude-skills) into .claude/skills/support-runbook in your project. Claude Code loads it when a task matches its description.

How do I install Support Runbook in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill support-runbook -a codex`. Or copy the skill folder (skills/support-runbook in mohitagw15856/pm-claude-skills) into .agents/skills/support-runbook in your project. Codex loads it when a task matches its description.

Can I use Support Runbook in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill support-runbook -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/support-runbook, .gemini/skills/support-runbook, .github/skills/support-runbook and .opencode/skills/support-runbook in your project.

What does Support Runbook need to run?

SKILL.md names no scripts, command-line tools or credentials: Support Runbook is instructions for the agent only.

Does Support Runbook access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Support Runbook safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Support Runbook use?

Support Runbook is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Support Runbook use?

About 984 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Support Runbook?

Skills that share tags, products or a category with Support Runbook: Trader Memory Core (tradermonty/claude-trading-skills, 3k stars), Author Migration (nrwl/nx, 29k stars), Write Notes Like Deepseek (czm15053/write-notes-like-deepseek, 508 stars) and OpenRig Upgrade Procedure (mvschwarz/openrig, 6.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Support Runbook?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,434 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 9, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.