agent-sop-creator
Guide for creating Agent SOPs (Standard Operating Procedures). Use this skill when the user wants to create a new SOP workflow for AI agents, write an agent procedure, or needs help with SOP format and best practices. Triggers on requests like "create an SOP", "new agent workflow", "help me write an SOP", "create a procedure for agents", or "SOP template".
When & Why to Use This Skill
The Agent SOP Creator is a specialized tool designed to help users build structured, markdown-based Standard Operating Procedures (SOPs) for AI agents. It ensures high reliability and consistency by providing a standardized framework that includes parameterized inputs, step-by-step instructions, and constraint-based execution using RFC 2119 keywords (MUST, SHOULD, MAY). This skill is essential for developers and operations teams looking to scale complex agentic workflows with clear logic and safety guardrails.
Use Cases
- Standardizing complex business workflows: Create detailed markdown procedures that guide AI agents through multi-step tasks like customer onboarding or data processing.
- Defining strict operational constraints: Use RFC 2119 terminology to set absolute requirements and prohibitions, ensuring agents never skip critical safety or compliance steps.
- Parameter acquisition and validation: Design SOPs that force agents to collect all necessary user inputs upfront before executing a task, reducing back-and-forth errors.
- Developing troubleshooting playbooks: Build structured guides that help agents identify and resolve common issues autonomously using predefined resolution paths.
- Scaling agentic automation: Use the standardized .sop.md format to maintain a consistent library of procedures that can be easily shared across different AI agents and teams.
| name | agent-sop-creator |
|---|---|
| description | Guide for creating Agent SOPs (Standard Operating Procedures). Use this skill when the user wants to create a new SOP workflow for AI agents, write an agent procedure, or needs help with SOP format and best practices. Triggers on requests like "create an SOP", "new agent workflow", "help me write an SOP", "create a procedure for agents", or "SOP template". |
Agent SOP Creator
Create Agent SOPs - markdown workflows that guide AI agents through complex tasks with parameterized inputs and constraint-based execution.
SOP Template
# [SOP Name]
## Overview
[1-2 sentences: what this SOP does and when to use it]
## Parameters
- **required_param** (required): Description of required input
- **optional_param** (optional, default: "value"): Description with default
**Constraints for parameter acquisition:**
- You MUST ask for all parameters upfront in a single prompt
- You MUST confirm successful acquisition before proceeding
## Steps
### 1. [Step Name]
[Natural language description of what happens]
**Constraints:**
- You MUST [absolute requirement]
- You SHOULD [recommended action]
- You MAY [optional action]
- You MUST NOT [prohibition] because [reason why]
### 2. [Next Step Name]
[Description]
**Constraints:**
- [List constraints using RFC 2119 keywords]
## Examples
### Example Input
[Show realistic input]
### Example Output
[Show expected result]
## Troubleshooting
### [Common Issue]
If [condition], you should [resolution].
Writing Steps
Step 1: Define Overview
Start with a clear 1-2 sentence explanation of what the SOP accomplishes and when to use it.
Step 2: Define Parameters
List all inputs the workflow needs:
- Use snake_case for parameter names
- List required parameters before optional ones
- Include defaults for optional parameters
- Add parameter acquisition constraints if multiple input methods supported
Step 3: Write Steps
For each step:
- Give it a numbered name (### 1. Step Name)
- Write natural language description
- Add Constraints: section with RFC 2119 keywords
Step 4: Add Examples and Troubleshooting
Include concrete examples showing input/output pairs and common issues with resolutions.
RFC 2119 Keywords
| Keyword | Meaning | Use When |
|---|---|---|
| MUST | Absolute requirement | Action is critical for success |
| MUST NOT | Absolute prohibition | Action would cause failure |
| SHOULD | Recommended | Best practice but exceptions exist |
| SHOULD NOT | Not recommended | Generally avoid but sometimes acceptable |
| MAY | Optional | Truly optional enhancement |
Writing Constraints
Negative constraints MUST include reasons:
Good:
- You MUST NOT push changes because this could publish unreviewed code
- You MUST NOT delete history because this corrupts the repository
Bad:
- You MUST NOT push changes
- You MUST NOT delete history
Checklist
Before finalizing an SOP, verify:
- File uses
.sop.mdextension - Overview clearly explains purpose and when to use
- Parameters use snake_case naming
- Required parameters listed before optional
- Steps are numbered sequentially
- Each step has a Constraints: section
- All constraints use RFC 2119 keywords
- All negative constraints include "because [reason]"
- Examples show realistic input/output
- Troubleshooting covers likely issues
Resources
For detailed format specification, see references/sop-format-spec.md.