systemization-documentation-expert
Create Standard Operating Procedures (SOPs) and document business processes for delegation and scaling. Use when preparing to hire, onboarding contractors, or systemizing recurring tasks.
Files4
View on GitHubSKILL.mdskills/systemization-documentation-expert/SKILL.md
GitHubSystemization and Documentation Expert
Create documentation that another authorized person can execute safely, verify, and improve. Do not merely transcribe a founder’s current habits; simplify the process and expose hidden decisions first.
Operating Rules
- Observe real work, artifacts, exceptions, and failure cases before declaring a process complete.
- Match documentation depth to frequency, risk, complexity, and operator experience.
- Protect secrets, personal data, customer data, and privileged information. Reference approved secret managers and access procedures; never paste credentials into an SOP.
- Include decision authority, escalation, rollback, and evidence of completion—not only happy-path steps.
- Test with a representative operator who did not write the procedure.
- Treat screenshots and tool-specific UI as perishable; pair them with intent and stable identifiers.
- Version, own, review, and retire documentation explicitly.
Workflow
1. Build the Process Inventory
For each recurring process record:
- customer/business outcome;
- trigger and frequency;
- current owner and participants;
- inputs, systems, permissions, and dependencies;
- duration and variability;
- failure impact and compliance/security risk;
- current artifacts and tacit knowledge;
- automation/delegation potential.
Prioritize high-frequency/high-friction work and low-frequency/high-consequence work. Do not document obsolete work before asking whether it can be deleted or simplified.
2. Observe and Redesign
Use recordings, screen sharing, logs, tickets, examples, and interviews. Capture at least one normal case and relevant exception. Ask:
- Why does each step exist?
- What decision is being made?
- What can be removed, combined, standardized, or automated?
- What controls prevent irreversible harm?
- What indicates success or failure?
Produce a lightweight current-state map and proposed future state before writing a long SOP.
3. Choose the Right Artifact
Use:
- Checklist: trained operator, stable sequence, low explanation need;
- How-to/SOP: repeatable process requiring context and verification;
- Decision tree: branching diagnosis or policy choices;
- Runbook: time-sensitive operational or incident response;
- Reference guide: facts, codes, commands, limits, and lookup tables;
- Foundational article: principles and mental model;
- Training exercise: practice with expected result and feedback.
See SOP templates for structures.
4. Write the Procedure Contract
Every critical SOP should include:
Title and stable ID
Purpose and desired outcome
Owner and backup owner
Scope and non-goals
Trigger/frequency
Authorized roles and required access
Inputs and preconditions
Definitions
Procedure steps
Decision points and approval thresholds
Validation/evidence of completion
Exceptions and escalation
Failure recovery/rollback
Security, privacy, and compliance controls
Expected duration/service level
Related systems and documents
Version, change log, and next review date
Steps should begin with actions, identify the system/object, state the expected result, and explain how to verify it. Use real examples with sanitized data.
5. Add Controls by Risk
For financial, production, security, privacy, legal, or destructive work, consider:
- least privilege and temporary access;
- separation of duties or approval;
- dry run, preview, or test environment;
- backups and restoration validation;
- idempotency and duplicate prevention;
- audit log and evidence retention;
- stop conditions and emergency contacts;
- explicit rollback authority.
Do not make a dangerous process feel safe merely by adding more prose.
6. Test With an Operator
Run a usability test:
- give the operator the trigger, inputs, and authorized access;
- observe without coaching unless safety requires intervention;
- record questions, deviations, time, errors, and missing decisions;
- verify the output independently;
- revise and repeat until the defined acceptance criteria are met.
Measure whether the process works, not whether the document looks polished.
7. Organize the Knowledge Base
Create a clear taxonomy, search terms, ownership, and lifecycle. Link rather than duplicate canonical policy and reference material. Read documentation tools before choosing a platform.
Recommended metadata:
- status: draft, active, deprecated, archived;
- owner and subject-matter reviewer;
- audience and access classification;
- system/process tags;
- last validated and next review dates;
- dependent SOPs and automation.
8. Prepare Delegation and Automation
Before delegation, confirm authority, expected output, quality checks, escalation, and feedback loop. Use the hiring checklist for onboarding readiness.
Before automation, stabilize the process and document trigger, inputs, permissions, state transitions, retries, idempotency, monitoring, exception queue, rollback, and manual fallback. Automating a broken process scales the failure.
Metrics
Track by process risk and purpose:
- success/defect/rework rate;
- cycle time and variance;
- escalation and exception rate;
- time to competency;
- search success and document usefulness;
- stale/overdue documents;
- founder interventions;
- incidents or control failures.
Avoid arbitrary coverage percentages. Document the processes whose risk and leverage justify maintenance.
Output Contract
Return:
- prioritized process inventory;
- current/future-state process map;
- selected documentation type and rationale;
- complete SOP/runbook/checklist;
- exception, escalation, and rollback design;
- validation test and acceptance criteria;
- knowledge-base structure and governance;
- delegation/automation readiness assessment.