Agent skill

Sop Builder

by ericrisco in ericrisco/rsc-harness

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…

MITAuto-check passedBusiness, Finance & HR

Install Sop Builder

skills CLI
$ npx skills add ericrisco/rsc-harness --skill sop-builder -a claude-code

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

GitHub CLI
$ gh skill install ericrisco/rsc-harness sop-builder --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/ericrisco/rsc-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sop-builder .claude/skills/sop-builder && 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
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.

  1. Pick one process. One trigger in, one defined output out. If you can't
  2. Capture the real flow — interview the owner or read their recording/
  3. Find the decisions and exceptions. Where does it fork? Where does it
  4. Choose the format by flow shape (next section). Linear ≠ branching ≠
  5. Draft at the right altitude — who does what and when, not every keystroke.
  6. Test it on someone who has never done the task. If they get stuck or ask
  7. Assign 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.

SKILL.md

The full file from ericrisco/rsc-harness at commit 92fde8f, republished under its MIT licence (© ericrisco). 1,656 words, ~3,103 tokens.

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`).
tags
sop, process-documentation, standard-operating-procedure, runbook, process, business-ops
recommends
meeting-notes, project-ops, compliance, technical-writing, automation-flows, people-ops
origin
risco

SOP builder

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.

  1. 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.
  2. Capture the real flow — interview the owner or read their recording/ transcript. Capture how it actually runs, not how it's supposed to.
  3. 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.
  4. Choose the format by flow shape (next section). Linear ≠ branching ≠ parallel, and each wants a different shape.
  5. Draft at the right altitude — who does what and when, not every keystroke.
  6. 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.
  7. 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.

AltitudeAnswersExample lineBelongs in
SOPwho does what and when (the roadmap)"The editor approves the draft before it's scheduled."The SOP body
Work instructionhow 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 shapeUseWhy
Strictly linear, every time the sameNumbered step-by-stepThe order is the procedure; numbers carry it.
Many parallel pieces, done by experienced peopleChecklistThey know how; they need to not forget a piece, not be walked through it.
Has decision points / forks / "it depends"Flowchart or decision tableA 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:

SectionStatusNote
Title + ID/versionMandatoryOne process, one document.
PurposeMandatoryWhy this exists, in one sentence.
ScopeMandatoryWhat's in, what's out, when it triggers.
Owner (the "A" in RACI)MandatoryExactly one accountable person.
TriggerMandatoryThe event that starts the procedure.
StepsMandatoryThe numbered/checklist/branched body.
Decision pointsIf it branchesThe forks, written explicitly.
Quality checkMandatoryHow you know the output is correct.
OutputMandatoryThe defined thing produced.
Exceptions / escalationIf it can failWhat to do when it goes wrong.
RACI matrixIf >1 roleOnly when the process spans roles.
Change logMandatoryVersion, date, author, one-line what-changed.
Next-review dateMandatorySee "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-patternWhy it failsDo instead
Keystroke-level SOP ("click Settings, then…")Bloats the doc; rots the day the UI changesKeep SOP at who/what/when; link work instructions
Flat numbered list for a branching processHides the forks that break under pressureUse a decision table / flowchart for branches
Happy-path only, no exceptionsBreaks the first time reality forksWrite if X then Y + a named escalation
No owner, no review dateGoes stale silently, nobody trusts itName one accountable owner + a next-review date
Written about the doer, not with themMisses tacit steps; gets ignoredInterview/record the person who runs it
Inventing steps the recording never showedShips a procedure that doesn't match realityFlag gaps; capture the missing step, don't guess
Wall of passive-voice proseCognitive overload; people fall back to memoryOne action per step, active voice, named actor
RACI on a solo taskCeremony the process doesn't carryAdd 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.

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

Files

SKILL.md and 3 other files (references) in skills/sop-builder of ericrisco/rsc-harness.

  • SKILL.md
  • evals/README.md
  • evals/cases.yaml
  • references/sop-skeleton.md

Open the folder on GitHubat commit 92fde8f

Compare with similar skills

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.

Sop Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sop Builder this skillericrisco/rsc-harness156—~3.1kAutomated safety check: PassMIT
Client Onboardingindranilbanerjee/digital-marketing-pro8541 repos~1.8kAutomated safety check: PassMIT
Marketing Project Managerjeffstric/ZJT226—~875Automated safety check: PassCustom licence
Obsidian Research Logbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~378Automated safety check: PassCustom licence
Pm Skillsalirezarezvani/claude-skills28k—~2.6kAutomated safety check: PassMIT
Meeting Analyzerborghei/Claude-Skills874—~3.3kAutomated safety check: PassMIT

Similar skills

  • Client Onboarding

    indranilbanerjee/digital-marketing-pro

    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…

    854 GitHub starsUsed in 1 repo~1.8k tokens
    Productivity & AutomationAuto-check passed
  • 营销项目经理智能体,负责统筹营销创作流程,根据用户需求选择并加载对应的SOP,协调其他智能体完成营销内容创作. An agent skill from jeffstric/ZJT.

    226 GitHub stars~875 tokensUpdated 15 days ago
    Business, Finance & HRAuto-check passed
  • Obsidian Research Log

    brycewang-stanford/Auto-Empirical-Research-Skills

    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…

    4.5k GitHub stars~378 tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Pm Skills

    alirezarezvani/claude-skills

    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…

    28k GitHub stars~2.6k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Meeting Analyzer

    borghei/Claude-Skills

    Turn meeting notes into an accountable register — extract decisions, actions and open questions, flag ownerless items, track follow-through.

    874 GitHub stars~3.3k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Program Manager

    borghei/Claude-Skills

    Program management for multi-project coordination, portfolio governance, dependency tracking, benefits realization, charters, and steering-committee reporting.

    874 GitHub stars~1.3k tokensUpdated today
    Writing & ContentAuto-check passed

More from ericrisco/rsc-harness

All 229 skills in this repo
  • Ab Testing

    ericrisco/rsc-harness

    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…

    156 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Accessibility

    ericrisco/rsc-harness

    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…

    156 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed
  • Ads

    ericrisco/rsc-harness

    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…

    156 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Agent Eval

    ericrisco/rsc-harness

    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…

    156 GitHub stars~3.2k tokensUpdated yesterday
    Auto-check passed
  • AI Media

    ericrisco/rsc-harness

    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…

    156 GitHub stars~3.3k tokensUpdated yesterday
    Auto-check passed
  • Analytics

    ericrisco/rsc-harness

    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.

    156 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed

Questions about Sop Builder

What does Sop Builder do?

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.