Establish guidelines for writing Standard Operating Procedures that support governance processes.
Scope
This skill applies to SOPs within analytics governance, including:
report build procedures
data validation procedures
issue escalation procedures
maintenance procedures
Before drafting governance documentation, check and apply:
.github/skills/finance-documentation-lifecycle
Use it as the source of truth for ISO 9001-inspired terminology, process/procedure/SOP distinctions, documentation lifecycle, and evidence/record expectations.
Writing rules
State the objective clearly.
List steps in the exact order they should be executed.
Identify responsible roles for each step.
Specify evidence generated by each step.
Keep steps actionable and repeatable.
Structure
Objective
Scope
Roles
Prerequisites
Procedure steps
Artifacts / evidence
Exceptions
Output expectations
Each step must produce evidence.
Steps must map to control points and processes.
Use numbering and clear directives (e.g., "Run", "Verify", "Record").
Avoid ambiguity and optional language in core steps.
1---2name: sop-writing-23description: SOP Writing4---5# SOP Writing67## Purpose8Establish guidelines for writing Standard Operating Procedures that support governance processes.910## Scope11This skill applies to SOPs within analytics governance, including:12- report build procedures13- data validation procedures14- issue escalation procedures15- maintenance procedures1617Before drafting governance documentation, check and apply:18.github/skills/finance-documentation-lifecycle1920Use it as the source of truth for ISO 9001-inspired terminology, process/procedure/SOP distinctions, documentation lifecycle, and evidence/record expectations.2122## Writing rules23- State the objective clearly.24- List steps in the exact order they should be executed.25- Identify responsible roles for each step.26- Specify evidence generated by each step.27- Keep steps actionable and repeatable.2829## Structure301. Objective312. Scope323. Roles334. Prerequisites345. Procedure steps356. Artifacts / evidence367. Exceptions3738## Output expectations39- Each step must produce evidence.40- Steps must map to control points and processes.41- Use numbering and clear directives (e.g., "Run", "Verify", "Record").42- Avoid ambiguity and optional language in core steps.
Run npx skillmds@latest add bkjohn2018/sop-writing-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
SOP Writing It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
bkjohn2018 (@bkjohn2018) published this skill. Their other Agent Skills are listed on their SkillMD profile.