How does the skill determine the new version number?

The skill follows Semantic Versioning (SemVer) principles: Major for breaking process changes, Minor for new features or optional steps, and Patch for clarifications or typo fixes.

What is the purpose of the RFC 2119 verification feature?

It ensures that the SOP uses standardized requirement keywords like MUST, SHOULD, and MAY correctly to avoid ambiguity in professional documentation.

Can this skill generate migration guides for the team?

Yes, for any breaking changes (Major updates), the skill provides a structured template that outlines old vs. new behavior and specific action items required for migration.

Does it check for consistency across multiple documents?

Yes, the skill includes a consistency check to identify related SOPs that may also need updates when a primary process or tool changes.

Standard Operating Procedure Updater

Name: Standard Operating Procedure Updater
Author: TheBushidoCollective

byTheBushidoCollective

•

Learning & Documentation

Updates existing Standard Operating Procedures to reflect changes in tools, processes, and best practices using semantic versioning and structured changelogs.

This skill automates the maintenance of Standard Operating Procedures (SOPs) by guiding users through versioning, impact analysis, and documentation updates. It ensures that organizational knowledge remains current by identifying necessary changes triggered by tool migrations or process improvements, automatically generating changelogs, and providing migration guides for breaking changes. By enforcing RFC 2119 standards and semantic versioning (SemVer), it helps engineering and operations teams maintain high-quality, actionable documentation that reflects the latest production realities and compliance requirements.

Key Features

0195 GitHub stars

02Automated semantic versioning (SemVer) management for documentation

03Structured changelog generation with specific change details and reasoning

04Cross-SOP consistency checks to maintain documentation ecosystems

05RFC 2119 keyword verification to ensure procedural clarity and compliance

06Comprehensive migration guide templates for breaking process changes

Use Cases

01Integrating new error handling and troubleshooting steps following a post-mortem analysis of a production incident

02Updating deployment procedures after migrating from legacy tools to modern CI/CD pipelines

03Refining internal security protocols to comply with updated industry standards or regulatory requirements

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han update-sop

For use in Claude.ai and ChatGPT

Download Skill