sop-conversionlisted
Install: claude install-skill wiatrek-kevin-s/columbus
# SOP conversion
The goal: an agent with only the converted entry does the task exactly as the original procedure says. That includes every step, number, unit, exception and "do not". Shorter is not better. Faithful is better. A conversion is not finished until it passes both fidelity checks (section 6) and a person has signed it off.
## 1. Read the original completely
Get all the text out, including the parts that hide:
| Source | Extract with | Easy to miss |
| --- | --- | --- |
| Word (.docx) | `pandoc -t markdown file.docx`, or python-docx | Tracked changes and comments (ask which version is current), text boxes, headers and footers, footnotes, numbered-list continuations, tables |
| PDF | `pdftotext -layout file.pdf`; check for scanned pages (no text layer) and OCR them | Values that appear only in screenshots, two-column layouts read out of order, appendices |
| Excel (.xlsx) | Every sheet, including hidden sheets, rows and columns; cell comments | Units in column headers, colours or conditional formatting that mean something ("red = fail"), formulas that are the actual rule, merged cells, data validation lists (they are coded domains) |
Then make an **inventory** of the original, numbered as it is numbered:
- every **step**, in order;
- every **number with its unit**: thresholds, tolerances, counts, dates, frequencies;
- every **condition and exception**: "if", "unless", "except", "only", "when", "after a recalibration";
- every **prohibition**: "do not", "never"