What triggers the SOP generation process?

The skill triggers on natural language requests such as 'write an SOP', 'document this workflow', or 'create operating instructions'.

Can I integrate this with my Notion workflow tracker?

Yes, the skill can optionally fetch context from and update properties within Notion, Airtable, and other tracking tools to keep your documentation and registry in sync.

Where are the SOP files saved?

By default, SOPs are saved as Markdown files in the 'sops/' directory of your repository, though you can specify a custom location to match your project's conventions.

What is the difference between a Full and Lightweight SOP?

Full SOPs are used for deterministic processes where every step is fixed. Lightweight SOPs are designed for autonomous agents where the AI determines the path, focusing documentation on human checkpoints and interfaces instead of internal logic.

Workflow SOP Architect

Name: Workflow SOP Architect
Author: jamesgray-ai

byjamesgray-ai

•

Productivity & Workflow

Generates structured Markdown Standard Operating Procedures (SOPs) tailored to workflow automation levels and autonomy.

This skill automates the creation of professional SOP documentation by analyzing your workflow's execution mode—manual, augmented, or automated—and its autonomy level. It intelligently selects between full-detail templates for deterministic processes and lightweight templates for AI-guided autonomous agents, ensuring documentation remains accurate without redundant technical debt. By integrating with existing project artifacts or external trackers like Notion, it helps teams maintain a standardized, searchable source of truth for all operational procedures.

Key Features

013 GitHub stars

02Markdown file generation with standardized YAML frontmatter

03Optional syncing with external trackers like Notion and Airtable

04Automatic selection between Full and Lightweight SOP templates

05Dual-axis classification based on execution mode and autonomy level

06Direct integration with Workflow Definition and Building Block Spec artifacts

Use Cases

01Defining human-in-the-loop checkpoints for AI-augmented workflows

02Documenting manual business processes for team onboarding and training

03Creating technical monitoring handbooks for fully automated system pipelines

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamesgray-ai/handsonai writing-workflow-sops

For use in Claude.ai and ChatGPT

Download Skill