Similar Work Rank
Computes deterministic similarity and recurring-failure evidence from supplied history. Use for "rank similar past work", "have we repaired this before", "find the closest prior fix", or "explain similarity scores". Do NOT use for intake — use wo-intake instead; retrieval — use knowledge-retrieve instead; stock checks — use parts-readiness instead; terminal notes — use work-order-writeup instead. Local draft evidence only.
Install
npx skills add microsoft/cat-agent-skills --skill similar-work-rankgit clone --depth 1 https://github.com/microsoft/cat-agent-skills.git /tmp/cat-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/cat-agent-skills/submissions/work-order-assist/similar-work-rank ~/.claude/skills/similar-work-rankPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Similar-Work Rank
## Purpose
Deterministically rank the asset's prior work orders by similarity to the current work order,
detect a recurring SOP-default fix, and surface a superseding-fix recommendation from a prior fix
note.
## When to use
- When ranking is requested, or within an explicitly requested full packet.
- "What's the closest prior fix?" / "have we done this before?" / "is this a repeat failure?".
## Inputs
- The contract payload with `issue_keywords[]`, `required_parts[]`, `retrieved.prior_fixes[]` and
`history.prior_work_orders[]` (contract `mfg.work-order-assist.v1`).
## Steps
1. Validate the payload against the contract.
2. Run `scripts/similar_work.py --intake wo-intake.json --out similar-work.json`.
3. Do not recompute any similarity score in prose; quote the engine output and its score_calculation fields verbatim. A similarity score is a relative share of the retrieved set, not repair-success probability.
4. Emit the `{similar_work}` and `{superseding_fix}` contract payload plus the preliminary
`next_best_action`.
## Output
Contract `mfg.work-order-assist.v1` with populated `similar_work[]` (rank, wo_id, similarity_score,
shared_signals, outcome, recommended_fix, repeat_failure, confidence, source=engine:similar_work,
citation), `superseding_fix{}`, and `history.repeat_promotion` — the `{similar_work}` hop.
## Grounding requirements
Every similar match carries its CMMS record citation; a recurring-failure promotion citesDetails
- Skill name
similar-work-rank- Repository
- microsoft/cat-agent-skills
- Path
submissions/work-order-assist/similar-work-rank/SKILL.md- License
- MIT
- Repo updated
- 15 November 2026
FAQ
What does the Similar Work Rank skill do?
Computes deterministic similarity and recurring-failure evidence from supplied history. Use for "rank similar past work", "have we repaired this before", "find the closest prior fix", or "explain similarity scores". Do NOT use for intake — use wo-intake instead; retrieval — use knowledge-retrieve instead; stock checks — use parts-readiness instead; terminal notes — use work-order-writeup instead. Local draft evidence only.
How do I install the Similar Work Rank skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add microsoft/cat-agent-skills --skill similar-work-rank. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Similar Work Rank popular?
It lives in microsoft/cat-agent-skills, which has 110 GitHub stars and 122 forks.
Related skills
3 Statements
110microsoft/cat-agent-skills
Completes existing income statement, balance sheet and cash flow templates while preserving layout, grounding historical inputs and linking forecast formulas with reconciliation checks. Use for "fill in a 3-statement template", "complete an IS/BS/CF framework", "populate my integrated financial model", "link statements in this template", or "finish the forecasts in my three-statement workbook". Do NOT use for blank-slate models or general workbook edits (use xlsx), DCF valuation (use dcf-valuation), or buyout modeling (use lbo-model).
Accessibility Pass
110microsoft/cat-agent-skills
Use this skill whenever the user asks to check, review, or fix the accessibility of a PowerPoint deck, Word document, HTML page, or Markdown file, and before handing over any deck or document this agent just generated, so it does not ship with missing alt text, untitled slides, or unreadable colour contrast.
Accessible Learning Materials
110microsoft/cat-agent-skills
Maintains instructionally equivalent, accessible variants of a set of learning materials — lessons, readings, slides, and handouts — with parity checks against the original learning goals and recorded approvals. Use when the user asks to "make these materials accessible", "audit this lesson set for accessibility", "create an accessible version of this reading", "check reading level and alt text", or "keep my accessible variants in sync". Do NOT use for individual student accommodation or support-plan decisions (IEP, EHCP, or local equivalent), and do NOT use for generic document formatting (us
Source Ingest
110microsoft/cat-agent-skills
Pull every number, date and population definition out of a study's protocol, SAP, TLF tables, investigator brochure and prior approved text into one cited fact map, keyed per config/field-dictionary.json, before any CSR or 510(k) section is written. Use when the user asks "here's the locked TLF set and SAP, set up the CSR", "load the protocol and tables before we start drafting", "what figures do we have from the database lock?", "pull the disposition counts out of Table 14.1.1" or "ingest the IB for the 510(k)". Do NOT use for drafting or assembling submission sections - use section-draft or
Routing Notify
110microsoft/cat-agent-skills
Computes proposed investigators and unsent recipients from validated local classification, history and governance. Use for "propose unsent incident recipients", "who investigates this", "route this incident", "who do we notify", or "start the OSHA clock" (only to explain the blocked clock). Do NOT use for classification or terminal drafting — use severity-recordability or incident-writeup. Never sends, files or starts a clock; EHS REVIEW REQUIRED.
Wo Intake
110microsoft/cat-agent-skills
Extracts cited work-order identity and asset context into draft inputs. Use for "intake this work order", "pull WO-4507", "extract the asset context", or "start the work-order packet". Do NOT use for evidence retrieval — use knowledge-retrieve instead; ranking — use similar-work-rank instead; stock checks — use parts-readiness instead; terminal notes — use work-order-writeup instead. Offline synthetic evidence only; no operational actions.
Browse the most popular Claude skills, all finance & crypto skills, or write your own with the skills generator.