A skill your agent uses when a repeated process lives in one person's head, breaks when they are away, gets re-explained to every new hire, or produces inconsistent results — and needs writing down…
Install the "sop-builder" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/sop-builder into .claude/skills/sop-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sop-builder", then confirm the skill loads.
Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
skills CLI
$ npx skills add ericrisco/rsc-harness --skill sop-builder -a codex
Project install goes to .agents/skills/; add -g for ~/.codex/skills/.
Install the "sop-builder" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/sop-builder into .agents/skills/sop-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sop-builder", then confirm the skill loads.
Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add ericrisco/rsc-harness --skill sop-builder -a cursor
Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.
Install the "sop-builder" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/sop-builder into .cursor/skills/sop-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sop-builder", then confirm the skill loads.
Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
skills CLI
$ npx skills add ericrisco/rsc-harness --skill sop-builder -a gemini-cli
Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.
Install the "sop-builder" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/sop-builder into .gemini/skills/sop-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sop-builder", then confirm the skill loads.
Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
skills CLI
$ npx skills add ericrisco/rsc-harness --skill sop-builder -a github-copilot
Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.
Install the "sop-builder" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/sop-builder into .github/skills/sop-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sop-builder", then confirm the skill loads.
GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add ericrisco/rsc-harness --skill sop-builder -a opencode
OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
Install the "sop-builder" agent skill from https://github.com/ericrisco/rsc-harness/tree/main/skills/sop-builder into .opencode/skills/sop-builder/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sop-builder", then confirm the skill loads.
OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
Skill name
sop-builder
GitHub stars
156
Token cost
~3.1k tokens
SKILL.md length
1,656 words
Files
4 (incl. references)
Skills in repo
229
Repo updated
First seen
Licence
MIT
At a glance
A skill your agent uses when a repeated process lives in one person's head, breaks when they are away, gets re-explained to every new hire, or produces inconsistent results — and needs writing down…
Works in 7 steps: Pick one process. One trigger in, one… → Capture the real flow — interview the… → Find the decisions and exceptions. Where… → …
A repeated process lives in one persons head
SKILL.md covers The capture-to-SOP loop, Scope the right altitude, Pick the format by flow shape and The capture step, plus 6 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Sop Builder is an agent skill from ericrisco/rsc-harness. Use when a repeated process lives in one person's head, breaks when they are away, gets re-explained to every new hire, or produces inconsistent results — and needs writing down once so anyone or any agent can run it the same way. Also for auditing and rewriting an SOP that is stale, ignored or missing its branches. NOT capturing a meeting's decisions and action items (that is meeting-notes), NOT running a one-time project plan with milestones (that is project-ops).
Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `evals/README.md`, `evals/cases.yaml` and `references/sop-skeleton.md`).
It sits in Business, Finance & HR, covering Operations and SOPs, Project management and Meeting notes and agendas. The repository describes itself as: Your agent invents things because it has no memory, and can't touch your database because it has no arms. rsc is the meta-harness that gives it both, plus the trade to know the… The licence is MIT.
When your agent uses it
A repeated process lives in one persons head
Breaks when they are away
Gets re-explained to every new hire
Produces inconsistent results — and needs writing down once so anyone
Example prompts
“/sop-builder”
Workflow steps
7 steps, taken from the first numbered list in SKILL.md.
1Pick one process. One trigger in, one defined output out. If you can't
2Capture the real flow — interview the owner or read their recording/
3Find the decisions and exceptions. Where does it fork? Where does it
4Choose the format by flow shape (next section). Linear ≠ branching ≠
5Draft at the right altitude — who does what and when, not every keystroke.
6Test it on someone who has never done the task. If they get stuck or ask
7Assign an accountable owner and a review date. Unowned, undated SOPs are
What it can do on your machine
Read from SKILL.md and the folder at commit 92fde8f. 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 (its code samples are markdown).
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
Sop Builder loads about 3.1k tokens when it runs, and up to ~4.8k if it reads all its reference files. Until then it costs about 122 tokens; SKILL.md has 1,656 words of instructions outside code blocks.
Always· name and description, kept in context so the agent knows when to use it
~122
When it runs· the whole SKILL.md, loaded when a task matches
~3.1k
With references· SKILL.md plus every file in references/, read only if the agent opens them
~4.8k
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.
Download SKILL.mdSave it as .claude/skills/sop-builder/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
sop-builder
description
Use when a repeated process lives in one person's head, breaks when they are away, gets re-explained to every new hire, or produces inconsistent results — and needs writing down once so anyone or any agent can run it the same way. Also for auditing and rewriting an SOP that is stale, ignored or missing its branches. NOT capturing a meeting's decisions and action items (that is `meeting-notes`), NOT running a one-time project plan with milestones (that is `project-ops`).
You keep re-explaining the same process. Write it down once, correctly, so it
runs without you. That is the whole job: take a workflow living in one person's
head, a Slack thread, or a screen recording, and turn it into a standard
operating procedure — a document another human or agent can follow to get the
same result every time.
An SOP is not a meeting note and not a project plan. Hold the line:
What was decided + who does what by when → meeting-notes. That records a moment; you record a recurring task.
Milestones, status, a thing with an end date → project-ops. A project finishes; an SOP repeats forever.
External help-center docs / product manuals → technical-writing. That writes for a customer; you write for the person inside the org who runs the routine.
Regulated GxP quality-system SOPs with formal approval + audit trail → compliance owns the regulatory gating. You write the operational document; defer the sign-off framework to them.
Turning the documented steps into a flow / webhook / script → automation-flows. You document; they automate.
One specific new hire's first-week checklist + accounts → people-ops. You write the reusable procedure they'll follow, not their personal tracker.
The payoff is real but conditional: standardizing a process can cut errors by
up to ~90% — only when the SOP is clear and easy to follow. A correct SOP
nobody can read changes nothing. Usability is the whole game.
The capture-to-SOP loop
This is the spine. Run it in order; do not skip the test step.
Pick one process. One trigger in, one defined output out. If you can't
name the trigger and the output, you're scoping a department, not an SOP.
Capture the real flow — interview the owner or read their recording/
transcript. Capture how it actually runs, not how it's supposed to.
Find the decisions and exceptions. Where does it fork? Where does it
break when the owner is out? These are what a linear draft will miss.
Choose the format by flow shape (next section). Linear ≠ branching ≠
parallel, and each wants a different shape.
Draft at the right altitude — who does what and when, not every keystroke.
Test it on someone who has never done the task. If they get stuck or ask
a question, the SOP has a gap — fix the document, not the person.
Assign an accountable owner and a review date. Unowned, undated SOPs are
dead on arrival.
Steps 3 and 6 are the ones teams skip and the reason most SOPs fail in the
wild — a happy-path document breaks the moment reality forks.
Scope the right altitude
An SOP and a work instruction are different documents. Per ISO 9001:2015 a
procedure is "a specified way to carry out an activity." Don't bloat an SOP with
keystroke detail — that's a separate work instruction, and one SOP links to
several of them.
Altitude
Answers
Example line
Belongs in
SOP
who does what and when (the roadmap)
"The editor approves the draft before it's scheduled."
The SOP body
Work instruction
how one operator does one task (the GPS)
"Click Settings → Schedule → pick 09:00, hit Confirm."
A linked WI, not inline
Rule of thumb: if removing a line wouldn't change who is accountable or what
the next decision is, it's probably a keystroke — link it out or cut it. A
reader who already knows the tool should not have to scroll past click-by-click
detail to find the one decision that matters.
Pick the format by flow shape
Match format to the shape of the work, not to preference. A mismatched format is
a top adoption killer — people abandon an SOP that fights how the task actually
moves.
Flow shape
Use
Why
Strictly linear, every time the same
Numbered step-by-step
The order is the procedure; numbers carry it.
Many parallel pieces, done by experienced people
Checklist
They know how; they need to not forget a piece, not be walked through it.
Has decision points / forks / "it depends"
Flowchart or decision table
A numbered list hides branches inside prose and readers miss them.
If the process has even one real "if X then Y" fork, do not force it into a
flat numbered list. The fork is exactly the part that breaks under pressure, and
a flat list buries it.
The capture step
Garbage in, garbage SOP. Capture how the work actually runs.
From a recording (the fast path). A team hand-writing one SOP spends ~3–5
hours; recording the task once (10–15 min) and extracting steps from the
video/transcript is reported 10–20x faster. Treat the recording as the single
source of truth, then prune to the SOP. Crucially: do not invent steps the
source never shows. If the transcript skips a step, flag the gap — don't
backfill it from imagination.
From an interview, surface the hidden branches with probes the owner won't
volunteer:
"Walk me through the last time you did this, start to finish."
"Where does this break when you're on holiday?" — the single best
branch-finder; it surfaces the tacit knowledge that lives only in their head.
"What's the most common thing that goes wrong, and what do you do then?"
"When do you have to ask someone else before continuing?" (→ an escalation).
"Is there a case where you skip a step or do it differently?" (→ a branch).
People who actually do the work must be in the capture loop. An SOP written
about people instead of with them is the classic reason it goes unfollowed.
The full 10–12 question interview script is in
references/sop-skeleton.md.
Show full SKILL.md (741 more words)Show less
The SOP skeleton
Four sections are load-bearing and appear in essentially every credible
template: purpose, scope, responsibilities, procedure. Everything else is
supporting structure. Mark sections mandatory vs optional-by-size:
Section
Status
Note
Title + ID/version
Mandatory
One process, one document.
Purpose
Mandatory
Why this exists, in one sentence.
Scope
Mandatory
What's in, what's out, when it triggers.
Owner (the "A" in RACI)
Mandatory
Exactly one accountable person.
Trigger
Mandatory
The event that starts the procedure.
Steps
Mandatory
The numbered/checklist/branched body.
Decision points
If it branches
The forks, written explicitly.
Quality check
Mandatory
How you know the output is correct.
Output
Mandatory
The defined thing produced.
Exceptions / escalation
If it can fail
What to do when it goes wrong.
RACI matrix
If >1 role
Only when the process spans roles.
Change log
Mandatory
Version, date, author, one-line what-changed.
Next-review date
Mandatory
See "Keep it alive".
A RACI clarifies ownership when more than one role touches the process:
Responsible does it, Accountable owns the outcome (exactly one), Consulted gives
input, Informed is kept in the loop. A solo task does not need a matrix —
don't add ceremony the process doesn't carry. The full copy-paste template with
per-field guidance lives in
references/sop-skeleton.md.
Write it so it's actually used
SOPs go unfollowed because of the document, not the people: lack of clarity,
cognitive overload from length and jargon, and staleness. Under pressure people
default to memory over a wall of text. So write short, active, and concrete.
One action per step. Two verbs in a step means a reader can do half and
think they're done.
Active voice, named actor. Who does it must be unambiguous.
No internal jargon the next hire won't know — or define it once.
Bad → Good:
markdown
Bad: The newsletter should be reviewed and then it gets scheduled, making
sure that everything is fine before it goes out.
Good: 1. Editor reviews the draft against the checklist in §4.
2. Editor schedules the approved draft for 09:00 Tuesday.
3. Editor confirms the send shows in the queue.
The bad version hides three actions, names no actor, and uses passive voice that
lets everyone assume someone else did the check.
Branches and exceptions — the section people skip
Branching logic, exceptions/escalations, and the change log are the three
sections SOPs most often omit, and the reason they fail in production. Write the
fork explicitly; don't bury it in prose.
markdown
Step 4 — Check the invoice total.
- If total ≤ €1,000 → approve and proceed to Step 5.
- If total > €1,000 → route to Finance lead for sign-off, then Step 5.
- If the PO number is missing → STOP. Escalate to <owner>; do not approve.
Every exception needs a named escalation target and a clear stop condition. "If
unsure, ask someone" is not an escalation — name the role and the trigger. You
don't need a sprawling flowchart for three forks; inline if X then Y lines are
enough until the branch count makes a decision table or flowchart clearer (see
"Pick the format").
Keep it alive
An SOP without an owner and a review date is already dead. Every SOP carries:
One accountable owner — the person who answers for the outcome.
A change log — version, date, author, one line on what changed. Without
it, nobody trusts which version is current.
A next-review date. Reviews are annual minimum plus trigger-based: after
a process or tool change, after an incident, or after an audit.
Treat an SOP unreviewed for 18+ months as unreliable — it likely describes a
process that no longer exists. When the review fires, re-run the capture loop on
the diff, not the whole document.
For regulated quality systems (GxP, formal approval workflows, audit-trail
sign-off), write the operational content here and hand the approval/gating
framework to compliance. Once the SOP is stable and
you want the steps executed automatically, hand it to
automation-flows.
Anti-patterns
Anti-pattern
Why it fails
Do instead
Keystroke-level SOP ("click Settings, then…")
Bloats the doc; rots the day the UI changes
Keep SOP at who/what/when; link work instructions
Flat numbered list for a branching process
Hides the forks that break under pressure
Use a decision table / flowchart for branches
Happy-path only, no exceptions
Breaks the first time reality forks
Write if X then Y + a named escalation
No owner, no review date
Goes stale silently, nobody trusts it
Name one accountable owner + a next-review date
Written about the doer, not with them
Misses tacit steps; gets ignored
Interview/record the person who runs it
Inventing steps the recording never showed
Ships a procedure that doesn't match reality
Flag gaps; capture the missing step, don't guess
Wall of passive-voice prose
Cognitive overload; people fall back to memory
One action per step, active voice, named actor
RACI on a solo task
Ceremony the process doesn't carry
Add a matrix only when >1 role touches it
Reference
Pull the full fill-in template, the 10–12 question capture interview script, the
format-selection decision table, and a complete worked Bad→Good example SOP from
references/sop-skeleton.md. Keep this body lean;
reach for the template when you're actually drafting.
Sop Builder 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.
Generate a complete onboarding package for a new marketing client — kickoff meeting agenda, 20-30 question discovery questionnaire, stakeholder map with RACI matrix, platform-by-platform access…
A skill your agent uses when the user is discussing daily research work, TODOs, plans, standups, meetings, milestones, or general project progress that should be reflected in Obsidian daily notes…
A skill your agent uses when coordinating project-delivery work across the 8 project-management sub-skills — sprint/velocity analytics, portfolio health, Jira/JQL, Confluence, Atlassian admin…
Program management for multi-project coordination, portfolio governance, dependency tracking, benefits realization, charters, and steering-committee reporting.
A skill your agent uses when designing or analyzing a controlled experiment — falsifiable hypothesis, sample size from an MDE, reading significance/CI/power, CUPED, or rescuing tests that won't go…
A skill your agent uses when making a web UI conform to WCAG 2.2 Level AA — axe-core or Lighthouse a11y violations, keyboard operability, focus management, ARIA roles/names/live regions, contrast…
A skill your agent uses when running or fixing paid acquisition on Google or Meta — campaign structure (Performance Max, Demand Gen, Search, Advantage+), platform-fit creative, budget/scaling rules…
A skill your agent uses when measuring whether an LLM or agent system actually got better and gating merges on it: golden sets, fixing an inflated LLM-as-judge, scoring RAG (faithfulness, contextual…
A skill your agent uses when a creative goal must become a finished media file: pick and order generative-media models per modality — AI voiceover, image-to-video clips, score — then glue them with…
A skill your agent uses when instrumenting product or web analytics — GA4/PostHog SDK wiring, event taxonomy, funnels, double-counted events, consent gating, PII scrubbing.
A skill your agent uses when a repeated process lives in one person's head, breaks when they are away, gets re-explained to every new hire, or produces inconsistent results — and needs writing down…. Sop Builder is an agent skill from ericrisco/rsc-harness. Use when a repeated process lives in one person's head, breaks when they are away, gets re-explained to every new hire, or produces inconsistent results — and needs writing down once so anyone or any agent can run it the same way.
When should I use Sop Builder?
Sop Builder fits situations like: A repeated process lives in one persons head; breaks when they are away; gets re-explained to every new hire; produces inconsistent results — and needs writing down once so anyone.
How do I install Sop Builder in Claude Code?
Run `npx skills add ericrisco/rsc-harness --skill sop-builder -a claude-code`. Or copy the skill folder (skills/sop-builder in ericrisco/rsc-harness) into .claude/skills/sop-builder in your project. Claude Code loads it when a task matches its description.
How do I install Sop Builder in Codex?
Run `npx skills add ericrisco/rsc-harness --skill sop-builder -a codex`. Or copy the skill folder (skills/sop-builder in ericrisco/rsc-harness) into .agents/skills/sop-builder in your project. Codex loads it when a task matches its description.
Can I use Sop Builder 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 ericrisco/rsc-harness --skill sop-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sop-builder, .gemini/skills/sop-builder, .github/skills/sop-builder and .opencode/skills/sop-builder in your project.
What does Sop Builder need to run?
SKILL.md names no scripts, command-line tools or credentials: Sop Builder is instructions for the agent only.
Does Sop Builder 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 Sop Builder 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 Sop Builder use?
Sop Builder 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 Sop Builder use?
About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.
What are the alternatives to Sop Builder?
Skills that share tags, products or a category with Sop Builder: Client Onboarding (indranilbanerjee/digital-marketing-pro, 854 stars), Marketing Project Manager (jeffstric/ZJT, 226 stars), Obsidian Research Log (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars) and Pm Skills (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Sop Builder?
ericrisco (a GitHub user) maintains it in ericrisco/rsc-harness, which has 156 GitHub stars. The repository holds 229 skills in this directory. The repository was last updated on October 6, 2026.
Source: ericrisco/rsc-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.