VasanthandClaude Opus 5.5
f4c42f2956
New last step: templates/to_docx.py turns the finished HANDOVER.md into a Word document (python-docx), the skill checks it and gives that path to the user as the deliverable. --selfcheck converts the Tebra example and is run by tests/test_templates.py. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
rpa-bot-handoff
A Claude skill that writes the ops guide for an RPA bot that is being handed over to an ops team.
What you get
HANDOVER.md: the ops guide, in plain words, for operators who don't read code:
- What this bot does
- Where is what: which tab, screen, file or folder shows what
- How to run: checklist and steps with the real button names
- How long to wait at each step, in seconds or minutes, and when to step in
- After the run: what each ending means, where the report is
- How to see an exception
- Exception list: message → where → meaning → what you do → wait or call us
- How you will know something went wrong
- How to tell the dev team, with a ready message template
- Don'ts, and the right way to stop the bot
- Issues seen before
HANDOVER.docx: the same ops guide as a Word document. This is what you give the ops team at the end.
HANDOVER-DEV.md: for developers. The check against 12 failure classes learned from Tebra Auto Post, the gaps to fix before handover (file:line), and the incident list.
Install
Copy this folder to ~/.claude/skills/rpa-bot-handoff/.
Use
In your bot project, ask Claude: "write the ops guide for this bot" or "document this bot for handover". The skill:
- Scans the code and history with subagents. It never runs the bot.
- Asks up to three things: how ops reaches the dev team, what ops can open, and any unclear statuses.
- Writes both files and checks them.
- Turns the ops guide into
HANDOVER.docxand gives you that document to hand to ops.
Files
| File | What it is |
|---|---|
SKILL.md |
Steps Claude follows |
templates/HANDOVER.md |
The ops guide skeleton |
templates/HANDOVER-DEV.md |
The dev notes skeleton |
templates/failure-classes.md |
12 failure classes from Tebra's first months with ops |
templates/reference/tebra-auto-post.md |
Both files filled in for Tebra, scrubbed |
templates/to_docx.py |
Turns HANDOVER.md into HANDOVER.docx (--selfcheck tests it) |