Work Order Writeup

Renders one fixed-layout cited Markdown work-order draft for technician/planner review. Use for "draft technician notes", "write up this work order", "give the planner summary", or "show the proposed next action". No audience-switching or document-conversion feature. Do NOT use for intake — use wo-intake; retrieval — use knowledge-retrieve; ranking — use similar-work-rank; stock checks — use parts-readiness. No CMMS write-back, closure, scheduling or purchasing, even when approved.

110 stars 122 forksWriting & ContentOfficial

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add microsoft/cat-agent-skills --skill work-order-writeup
Manual install
git 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/work-order-writeup ~/.claude/skills/work-order-writeup

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Work-Order Write-up

## Purpose
Produce one fixed-layout Markdown work-order draft using `scripts/render_writeup.py`.
The renderer recomputes source evidence and owns every section and value. The
`templates/work-order-writeup-template.md` document is a structure reference only,
not a model-fill path. The same draft supports technician/planner review; no audience
flag, alternate voice, model-authored section or cost/priority framing is implemented.

## When to use
- After parts-readiness, to close the loop.
- "Draft the technician notes" / "give me the planner summary" / "what's the next best action?".

## Inputs
- `work-order-packet.json` (contract `mfg.work-order-assist.v1`, the `{parts_readiness}` hop with
  `similar_work[]`, `parts_readiness{}`, `superseding_fix{}`, `next_best_action`, `escalations[]`).

## Steps
1. Validate input against the contract, then use scripts/render_writeup.py to recompute derived ranking/readiness from upstream evidence; schema validity alone does not authenticate derived values.
2. Render only with `scripts/render_writeup.py`: asset & work-order identification, issue
   summary, the applicable SOP, the top similar past work with citations, the parts-readiness table,
   the recommended next-best action, an "Open escalations" block, and the contract payload appendix.
3. The supported output is Markdown (.md) only, with an optional separate recomputed JSON packet.
Read the full skill on GitHub

Details

Skill name
work-order-writeup
Path
submissions/work-order-assist/work-order-writeup/SKILL.md
License
MIT
Repo updated
15 November 2026

FAQ

What does the Work Order Writeup skill do?

Renders one fixed-layout cited Markdown work-order draft for technician/planner review. Use for "draft technician notes", "write up this work order", "give the planner summary", or "show the proposed next action". No audience-switching or document-conversion feature. Do NOT use for intake — use wo-intake; retrieval — use knowledge-retrieve; ranking — use similar-work-rank; stock checks — use parts-readiness. No CMMS write-back, closure, scheduling or purchasing, even when approved.

How do I install the Work Order Writeup skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add microsoft/cat-agent-skills --skill work-order-writeup. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Work Order Writeup popular?

It lives in microsoft/cat-agent-skills, which has 110 GitHub stars and 122 forks.

Related skills

3 Statements

110

microsoft/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).

AI, LLMs & Agents122

Accessibility Pass

110

microsoft/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.

Frontend & Design122

Accessible Learning Materials

110

microsoft/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

Learning & Education122

AI Readme

201

swyxio/skills

Create or substantially revise repository README files that help a specific reader understand a technical project, reach a verified first result, and progress into realistic use, evaluation, debugging, or contribution. Use for project landing READMEs, CLI and library quickstarts, experimental or research repositories, executable engineering notebooks, and contributor-facing repository guides when an agent should reconstruct behavior from code, tests, commands, examples, and history rather than write generic documentation.

Writing & Content12

Wikipedia Human Style Writing

110

microsoft/cat-agent-skills

Use this skill whenever the user asks to write, rewrite, humanise, de-AI, or polish prose so it doesn't read as AI-generated — or to review a draft for signs of AI writing. Apply it before returning any substantial prose the user will publish.

Writing & Content122

AI Storyboard 2x2

150

guia-matthieu/clawfu-skills

Créez des storyboards visuellement cohérents en utilisant la technique des 2x2 Grid Shots de PJ Ace, garantissant éclairage, personnages et décors uniformes entre les plans. Use when: **Après avoir finalisé un script vidéo** - Transformer le concept en visuels; **Besoin de cohérence visuelle** - Personnages et éclairage constants entre les plans; **Préparer des assets pour animation** - Frames prêtes pour Veo, Runway, Kling; **Présenter un storyboard client** - Visualisation avant production;...

Writing & ContentIn 1 list32

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.