# sop-creator

The sop-creator skill turns repeatable technical work into usable SOPs, runbooks, and playbooks. Use it when a team needs clear operational documentation.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 849 repo stars
- Author: coleam00
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/coleam00/second-brain-skills/tree/HEAD/.claude/skills/sop-creator/SKILL.md
- Updated: 2026-01-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/coleam00-sop-creator

## What it does

sop-creator selects a documentation format based on the work: a runbook for incidents, a playbook for multi-phase changes, a troubleshooting guide for diagnosis, a checklist for verification, or an ADR for an architecture decision. It organizes each document around the outcome, trigger, prerequisites, numbered actions, completion checks, and recovery steps.

The skill favors short sections, tables, checklists, concrete thresholds, and action-led instructions. Its templates also cover ownership, update dates, review schedules, and a contact path for blocked work. The files are stored under `references/`. A process without a testable done state is still a description, so the completion checklist belongs near the start of the document.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add coleam00/second-brain-skills --skill sop-creator -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sop-creator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sop-creator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add coleam00/second-brain-skills --skill sop-creator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sop-creator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add coleam00/second-brain-skills --skill sop-creator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sop-creator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install coleam00/second-brain-skills .claude/skills/sop-creator
```

2. **Manually: put the files in place**
- File: `.github/skills/sop-creator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add coleam00/second-brain-skills --skill sop-creator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/coleam00/second-brain-skills --path .claude/skills/sop-creator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sop-creator/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/coleam00/second-brain-skills/tree/HEAD/.claude/skills/sop-creator/SKILL.md

## When to use it
- write an incident response runbook
- document a deployment process
- build a troubleshooting guide
- create a verification checklist
- record an architecture decision in an ADR

## Example prompts
- Create a runbook for recovering the service after an incident.
- Turn our release process into a playbook with completion checks and common failure fixes.
- Build a publishing checklist with an owner, review schedule, and escalation contact.

## Similar
- [sop-maintenance](https://affpapa.org/en/nevibecode/skills/sop-maintenance.md) — skill · 159 installs
- [sop-writer](https://affpapa.org/en/nevibecode/skills/sop-writer.md) — skill · ★ 12746 repo stars
- [sop-forge](https://affpapa.org/en/nevibecode/skills/sop-forge.md) — skill · ★ 96 repo stars
- [knowledge-ops](https://affpapa.org/en/nevibecode/skills/knowledge-ops.md) — skill · 297 installs
- [deepstream-sop](https://affpapa.org/en/nevibecode/skills/deepstream-sop.md) — skill · 705 installs
- [writing-runbooks](https://affpapa.org/en/nevibecode/skills/writing-runbooks.md) — skill · 26700 installs

## Other versions with the same name
- [sop-creator · ognjengt](https://affpapa.org/en/nevibecode/skills/sop-creator.md) — 1600 installs

From the same set: [coleam00/second-brain-skills](https://affpapa.org/en/nevibecode/by/coleam00/second-brain-skills.md) — 33 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
