mikeyobrien/create-sop

Create SOP Skill

Overview

Create a new workflow skill where SOPs are implemented as skills.

Canonical artifact:

• skills/<skill-name>/SKILL.md

A valid SOP skill must include:

• YAML frontmatter with name, description, and kind: sop
• ## Parameters
• ## Steps

Parameters

• sop_topic (required): What the SOP skill should do
• skill_name (optional): Kebab-case skill name. If omitted, generate from topic.
• output_dir (optional, default: skills): Parent directory for the skill
• include_examples (optional, default: true): Include ## Examples
• include_troubleshooting (optional, default: true): Include ## Troubleshooting

Steps

1. Gather requirements

Constraints:

• You MUST ask for all required inputs up front.
• You MUST clarify intended outcomes, required tools, and failure boundaries.
• You MUST identify what must be interactive vs autonomous.

2. Define the skill contract

Constraints:

• You MUST create/confirm a kebab-case skill_name.
• You MUST define parameters in a machine-readable bullet format.
• You MUST separate required vs optional params and defaults.

3. Draft SOP skill content

Constraints:

• You MUST generate frontmatter:

---
name: <skill_name>
description: <one-line purpose>
kind: sop
---

• You MUST include these sections in order:
  1. # <Title>
  2. ## Overview
  3. ## Parameters
  4. ## Steps
• You MUST use RFC-2119 constraints (MUST, SHOULD, MAY).
• You MUST include explicit negative constraints with reasons when relevant.

4. Write the artifact

Constraints:

• You MUST write to: {output_dir}/{skill_name}/SKILL.md
• You MUST create parent directories when missing.
• You MUST use the skill artifact convention only: skills/<skill_name>/SKILL.md.

5. Validate

Constraints:

• You MUST verify frontmatter includes kind: sop.
• You MUST verify ## Parameters and ## Steps are present.
• You SHOULD suggest running via: /skill run {skill_name}.

Output

When done, report:

• Created path
• Parameter list
• Short execution example

Example

Input:

• sop_topic: "Automated code review with lint/test gates"
• skill_name: code-review

Output path:

• skills/code-review/SKILL.md

Run with:

• /skill run code-review