aiskilloftheweek/sop-writer
> Transforms any process description — however rough, incomplete, or disorganized — into a clear, delegatable Standard Operating Procedure (SOP). Use this skill every time the user wants to document a process, create a procedure for a team member or VA, build an operations manual, standardize a workflow, or says things like "write an SOP for this", "help me document this process", "I need to delegate this", "create a procedure for my VA", "turn this into a checklist someone else can follow", "document how I do X", or pastes any description of how they do something and wants it structured. Always trigger this skill when the goal is to make a process repeatable and delegatable — even if the user phrases it casually or informally.
npx skills add https://github.com/aiskilloftheweek/claude-ai-skill-of-the-week --skill sop-writer
Turns any process description — bullet points, voice transcripts, half-explained workflows,
or detailed outlines — into a structured, delegatable Standard Operating Procedure.
The output is always specific, tool-aware, edge-case-aware, and ends with a built-in
delegability test. It works for solopreneurs, ops managers, and founders alike.
Read the user's input carefully and classify it into one of these input types:
| Type | Signals | Action |
|---|---|---|
| Verbal / stream of consciousness | Informal, jumps around, missing sequence | Run full elicitation (3.2) |
| Disorganized bullets | Has structure but missing tool/trigger/output details | Run partial elicitation (3.3) |
| Semi-structured description | Steps in order, some tools mentioned | Fill gaps only, then produce |
| Loom transcript / audio dump | Long, repetitive, with digressions | Extract, then confirm before producing |
If the input is too vague to even classify, ask one question only:
*"Can you describe what happens from start to finish when you run this process — even roughly?"*
Before eliciting or producing anything, classify the process into one of these types.
The type determines the output format (see Section 4).
If unclear from input, infer from context. If still unclear, ask:
*"Who will be running this process — you, or someone else?"* and
*"Is this something that happens on a schedule, or when something specific occurs?"*
Before writing the SOP, you need these. Extract them from input if present.
If missing, ask for them using the decision logic below.
Count missing mandatory fields:
3 or more missing → Ask in one block, max 3 questions at a time
1–2 missing → Ask 1 question, then proceed
0 missing → Produce the SOP directly
Never ask more than 3 questions per turn. Never run a questionnaire.
Behave like an ops consultant extracting information in conversation, not a form.
For trigger and output (highest priority):
For tools and executor:
For edge cases (this is the differentiator — always ask if not mentioned):
For frequency and variants:
If the user doesn't provide all fields, never invent steps or details.
[TO COMPLETE]Ask (or infer from context) where this SOP will live:
| Destination | Output format |
|---|---|
| Notion / Obsidian | Markdown with section emoji |
| Google Docs / Word | Clean Markdown, no emoji |
| ClickUp / Asana | Flat numbered steps, no nesting |
| Email to VA | Flowing text, steps in bold |
| Not specified | Default: Markdown with emoji |
Also determine detail level based on executor:
Use the Universal Base Structure below, then apply the Type Variant on top.
# [PROCESS NAME]
**Version:** 1.0 | **Created:** [date] | **Review by:** [date + 6 months]
---
## 📋 Process overview
- **Executed by:** [role]
- **Trigger:** [what starts this process]
- **Frequency:** [how often]
- **Estimated time:** [X minutes / hours]
- **Expected output:** [what is objectively true when done]
---
## 🛠️ Tools required
- [Tool name] — [what it's used for]
- [Tool name] — [what it's used for]
---
## 📝 Steps
1. **[Action verb] [what]** — [where / in which tool]
2. **[Action verb] [what]** — [where / in which tool]
3. ...
---
## ⚠️ Edge cases & exceptions
- If [situation X occurs] → [do Y instead]
- If [something is missing] → [escalate to / default to]
- If unsure → [decision rule or who to contact]
---
## ✅ Completion checklist
- [ ] [Verifiable output 1]
- [ ] [Verifiable output 2]
- [ ] [Verifiable output 3]
---
## ❓ FAQs
**Q:** [Question someone running this for the first time would ask]
**A:** [Answer]
---
## 🧪 Delegability test
Before handing this SOP to someone else, verify:
- [ ] Someone with zero context on this process could complete it using only this document
- [ ] Every tool mentioned is accessible to whoever will run this
- [ ] The edge cases section covers situations that have actually occurred
- [ ] The expected output is verifiable — not subjective
→ If any answer is NO, note which section needs revision before delegating.
Type A — Delegation to VA/contractor
Type B — Editorial / content process
(e.g., "Title must be under 60 characters", "Cover image must be 1600×840px")
Type C — Onboarding
Type D — Recurring operational
Type E — Crisis / exception handling
IF [condition A] → Go to Step 3
IF [condition B] → Go to Step 7
IF [condition C] → Escalate immediately (see Step 11)
[CRITICAL] / [STANDARD] / [OPTIONAL]Before delivering, verify:
User input:
*"When I get a new client inquiry from the contact form, I check if they fit, schedule a call, and send them the onboarding doc after."*
What the skill does:
Take aiskilloftheweek/sop-writer from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.