The skill itself read as too detailed. SKILL.md is now a short checklist (460 words, was 1,321): 5 steps, 5 rules, and 6 one-line "don't miss" checks that replace the 12 Tebra failure classes (failure-classes.md removed). The MEK Charge Reconciliation SOP - the 3-page PDF ops liked - replaces the Tebra example as the model (emails swapped for examples). New test keeps SKILL.md under 500 words with 6 checks. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
# rpa-bot-handoff
|
|
|
|
A Claude skill that writes a short **Handover SOP** for an RPA bot that is being handed over to an ops team.
|
|
|
|
## What you get
|
|
**`<Project Name> Handover SOP.pdf`** (plus the `.docx` and `HANDOVER-SOP.md`): at most 4 pages, in plain words, for operators who don't read code:
|
|
1. How to run: the URL or shortcut, what to click, and what a new click does to the previous results
|
|
2. What you see while it runs: what shows where, a normal run, how long each step may take
|
|
3. Result: how a good run ends, where the report is, what each status means
|
|
4. When something goes wrong: how it shows, each message (E01, E02...) with what to do, the don'ts, how to stop it
|
|
5. Email us: To the developer, CC their manager, when to email, and the email to copy
|
|
|
|
Problems the scan finds for the dev team are listed in the chat, not in the SOP.
|
|
|
|
## Install
|
|
Copy this folder to `~/.claude/skills/rpa-bot-handoff/`.
|
|
|
|
## Use
|
|
In your bot project, ask Claude: *"write the handover SOP for this bot"* or *"document this bot for handover"*. The skill:
|
|
1. Scans the code with a subagent. It never runs the bot.
|
|
2. Asks up to two things: the developer's and the manager's email (To and CC), and where ops runs the bot.
|
|
3. Writes the SOP, checks every quoted message and label against the code, and keeps it under 1,400 words.
|
|
4. Turns it into Word and PDF; you give the PDF to ops.
|
|
|
|
## Files
|
|
| File | What it is |
|
|
|---|---|
|
|
| `SKILL.md` | Steps Claude follows |
|
|
| `templates/HANDOVER-SOP.md` | The SOP skeleton |
|
|
| `templates/reference/mek-charge-reconciliation.md` | The model SOP (MEK Charge Reconciliation, 3 pages) |
|
|
| `templates/to_docx.py` | Turns the SOP into Word, and with `--pdf` into PDF; prints word and page counts (`--selfcheck` tests it) |
|