# Knowledge Ops

Use when writing, checking or cleaning up SOPs and runbooks.

- Repository: https://github.com/alirezarezvani/claude-skills (29114 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add alirezarezvani/claude-skills --skill knowledge-ops -g -a claude-code -y`
Codex: `npx skills add alirezarezvani/claude-skills --skill knowledge-ops -g -a codex -y`
Cursor: `npx skills add alirezarezvani/claude-skills --skill knowledge-ops -g -a cursor -y`
Gemini CLI: `npx skills add alirezarezvani/claude-skills --skill knowledge-ops -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add alirezarezvani/claude-skills`

## Description

Use when writing, checking or cleaning up SOPs and runbooks. Generates them with sop_generator.py, checks 5W2H completeness and links with runbook_validator.py and ingests an existing knowledge base with kb_ingester.py.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# knowledge-ops

Company SOP + internal runbook authoring, 5W2H completeness validation, and KB hygiene reporting for Head-of-Ops / Knowledge-Manager / TPM-Internal personas.

## Purpose

An ops organization three years in accumulates a sprawl: 600 Notion pages, 200 Confluence runbooks, three Obsidian vaults, a `Drive/SOPs/` folder, and a `Slack #ops-questions` channel that exists because nobody can find the canonical doc. Predictable failure modes:

1. **No owner**, 40% of SOPs name "the team" instead of a person. When the doc rots, nobody is accountable.
2. **No last-reviewed date**, a years-old vendor-offboarding SOP still references a procurement tool that was sunset over a year ago.
3. **Vague success signals**, runbook step 4 says "verify the service is up". A new operator can't tell what that means.
4. **No rollback path**, incident-comms cascade runbook tells you how to send the alert. It doesn't tell you how to retract it when the alert was wrong.
5. **Orphan pages**, half the KB has no inbound links. Nobody finds them via navigation; they only exist because somebody knew the URL.
6. **Glossary drift**, "CSM" means Customer Success Manager in three docs and Customer Solutions Manager in five. New hires guess wrong for six months.
7. **Happy-path-only SOPs**, the doc covers what happens when everything works. It doesn't cover the 30% case where it doesn't.

This skill answers the operator's actual question: **"Which 20 docs do I fix first, and what specifically is wrong with each?"**, with deterministic logic, not intuition.

## When to use

The rest: https://github.com/alirezarezvani/claude-skills/blob/HEAD/business-operations/skills/knowledge-ops/SKILL.md