CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

knowledge-ops

Use when a Head of Ops, Knowledge Manager, or TPM-Internal needs to author, validate, or clean up company SOPs and internal runbooks (procurement intake, vendor offboarding, incident-comms cascade, employee onboarding) — including 5W2H completeness checks (Who-What-When-Where-Why-How-HowMuch), cross-link and orphan-page validation across a sprawling Notion/Confluence/Obsidian wiki, KB ingestion + hygiene reporting, and runbook step verification (named owner, expected duration, observable success signal, rollback path, escalation contact). Pairs Ishikawa's 5W2H method, Gawande's *The Checklist Manifesto*, ISO 9001, ITIL v4, and Google SRE Workbook runbook discipline with deterministic stdlib-only Python tools that score completeness, detect anti-patterns, and emit prioritized cleanup lists (e.g., "validate this runbook before it goes into rotation", "audit our Confluence wiki for stale and orphaned SOPs").

71

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable body with an excellent validated workflow loop and accurate, executable script documentation. The weaknesses are token efficiency — a padded Purpose narrative and an inline canon-citation question library that re-teach what Claude already knows — and two asset template files in the bundle that the body never surfaces.

Suggestions

Reference `assets/sop_template.md` and `assets/runbook_template.md` in the body (e.g., in the Scripts or a short Templates section) — both files exist in the bundle but are currently undiscoverable from SKILL.md.

Move the forcing-question library's "Canon:" citations into the existing `references/5w2h_sop_canon.md` and `references/runbook_canon.md` files, keeping only the questions and recommended answers inline to cut ~a third of the body's tokens.

Tighten the Purpose section: drop the three-years-in sprawl storytelling and keep the numbered failure-mode list, which already carries the information.

DimensionReasoningScore

Conciseness

Mostly efficient (the Scripts and Workflow sections are dense and useful), but the Purpose narrative ("An ops organization three years in accumulates a sprawl: 600 Notion pages...") and the 33-line forcing-question library re-explain canon material Claude already knows (Gawande's Checklist Manifesto points, ISO 9001 §7.5.3, AWS Well-Architected quotes). Not 4: the storytelling padding and inline canon citations are more than minor instances of over-explanation.

3 / 5

Actionability

Fully executable guidance throughout: concrete commands with flags (`kb_ingester.py --input <vault-dir>`, `sop_generator.py --input <metadata.json> --profile <ops|support|finance|hr|it|regulated>`, `--stale-days`), explicit verdict thresholds (≥ 80 SAFE-TO-USE, 60-79 USE-WITH-CAUTION, < 60 NOT-SAFE), and a copy-paste Quick example. Specific examples cover the common cases.

5 / 5

Workflow Clarity

The four-step flow is clearly sequenced with explicit commands and an embedded validation feedback loop (step 4: "Re-run `kb_ingester.py` after the cleanup sprint to verify orphan-page count is down and glossary drift is resolved"), plus safety cautions for the batch cleanup ("The cleanup list is a *priority queue*, not a delete list"). This matches the anchor for clear sequence with explicit validation steps.

5 / 5

Progressive Disclosure

Good structure overall: three references are clearly signaled, one level deep, and verified to exist with substantive content; the Scripts section accurately describes the three scripts on disk. Not 5: `assets/sop_template.md` and `assets/runbook_template.md` are never mentioned anywhere in the body (a discovery failure verified against the bundle), and the 33-line forcing-question library is inline content that could live in a references file.

4 / 5

Total

17

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person voice, concrete capabilities, explicit persona-scoped "Use when" triggers, and quoted example utterances users would actually say. The only weakness is minor conflict risk on the generic word "runbook" against an engineering/production runbook skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "author, validate, or clean up company SOPs and internal runbooks", "5W2H completeness checks (Who-What-When-Where-Why-How-HowMuch)", "cross-link and orphan-page validation across a sprawling Notion/Confluence/Obsidian wiki", and "runbook step verification (named owner, expected duration, observable success signal, rollback path, escalation contact)" — with comprehensive coverage and no vague filler. Not 4: the coverage spans every capability with concrete detail rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both: what ("score completeness, detect anti-patterns, and emit prioritized cleanup lists" plus the full capability list) and when ("Use when a Head of Ops, Knowledge Manager, or TPM-Internal needs to author, validate, or clean up company SOPs and internal runbooks"). Both are concrete and explicit with trigger phrases.

5 / 5

Trigger Term Quality

Natural user vocabulary is comprehensively covered: "SOP", "runbook", "procurement intake", "vendor offboarding", "employee onboarding", platform names (Notion/Confluence/Obsidian), and quoted example utterances ("validate this runbook before it goes into rotation", "audit our Confluence wiki for stale and orphaned SOPs"). Not 4: synonyms, platform names, and example phrasings are all present, not just good coverage with a few missing.

5 / 5

Distinctiveness Conflict Risk

A clear organizational-knowledge niche scoped to Head of Ops / Knowledge Manager / TPM-Internal personas with distinct triggers, but the generic term "runbook" carries overlap risk with a production/system-ops runbook skill, and the description itself offers no disambiguation for that. Not 5: the runbook overlap is a real, if minor, conflict risk.

4 / 5

Total

19

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

business-operations/skills/knowledge-ops/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.