agentleFS
Dokkabei97Dokkabei97/forged-claude-code/skills/coo/sop-writer/SKILL.md

sop-writer

Skill2 starsChanged 8 months agoMITView on GitHub

Creates Standard Operating Procedures for repetitive tasks. Generates step-by-step documentation with checklists, decision trees, and responsibility assignments to eliminate single points of failure.

We split this skill into the rules it gives an agent

2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 9 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    One action per step: Don't combine multiple actions

    line 136
  2. Distinctive:

    Follow consistent formatting across SOPs

    line 158

“Common” is measured: kept by at least 6 in 10 of the 9 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

SOP Writer - Standard Operating Procedure Generator

Overview

Documents "how we do things" so processes don't live in one person's head. If someone is on vacation and work stops, you need an SOP.


1. When to Apply

TriggerBehavior
Repetitive task needs documentingFull SOP creation
"SOP", "process document"Interactive SOP builder
New team member asks "how do I..."SOP generation prompt

2. SOP Template

# SOP: [Process Name]

| Field | Value |
|-------|-------|
| **Version** | 1.0 |
| **Last Updated** | YYYY-MM-DD |
| **Owner** | [Name/Role] |
| **Frequency** | [Daily/Weekly/Monthly/As needed] |
| **Estimated Time** | [N] minutes |

---

## Purpose
[1-2 sentences: why this process exists and what it achieves]

## Scope
- **Applies to**: [Who performs this]
- **When**: [What triggers this process]
- **Not covered**: [What this SOP doesn't address]

## Prerequisites
- [ ] [Access/tool/permission needed]
- [ ] [Knowledge/training required]

---

## Procedure

### Step 1: [Action Name]
**Who**: [Role]
**How**:
1. [Specific action with exact details]
2. [Include screenshots/links where helpful]
3. [Include expected result]

> ⚠️ **Caution**: [Common mistake to avoid]

### Step 2: [Action Name]
**Who**: [Role]
**How**:
1. [Specific action]
2. [Specific action]

**Decision Point:**
- If [condition A] → Go to Step 3
- If [condition B] → Go to Step 4
- If [unclear] → Escalate to [person/role]

### Step 3: [Action Name]
...

---

## Checklist Summary
- [ ] Step 1: [Brief description]
- [ ] Step 2: [Brief description]
- [ ] Step 3: [Brief description]
- [ ] Final verification: [What to check]

## Troubleshooting

| Problem | Likely Cause | Solution |
|---------|-------------|----------|
| [Problem 1] | [Cause] | [Fix] |
| [Problem 2] | [Cause] | [Fix] |

## Escalation
- **Level 1**: [Person/Role] — [contact method]
- **Level 2**: [Person/Role] — [contact method]

## Revision History
| Date | Version | Change | Author |
|------|---------|--------|--------|
| YYYY-MM-DD | 1.0 | Initial creation | [Name] |

3. Common Startup SOPs

SOPFrequencyPriority
Production deploymentPer release★★★
Incident responseAs needed★★★
Customer onboardingPer customer★★★
Bug triageDaily★★☆
Sprint ceremoniesBi-weekly★★☆
Expense reportingMonthly★☆☆
New vendor setupAs needed★☆☆

4. Writing Tips

  1. Write for the new hire: Assume zero context
  2. Be specific: "Click the blue Submit button" not "Submit the form"
  3. One action per step: Don't combine multiple actions
  4. Include decision points: What if something goes wrong?
  5. Add screenshots: For complex UIs or dashboards
  6. Test it: Have someone else follow it without help

5. Tool Coordination

ToolPurpose
WriteGenerate SOP documents
ReadReference existing processes

6. Boundaries

Will:

  • Generate structured SOP documents with checklists
  • Include troubleshooting and escalation sections
  • Provide templates for common startup processes
  • Follow consistent formatting across SOPs

Will Not:

  • Observe actual processes (you describe, AI documents)
  • Automate the processes themselves
  • Replace training (SOPs supplement, not replace)
  • Guarantee process compliance

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.