Claude Report Skill — Development skill for Claude Code

/report — HTML reports for agent sessions

A Claude Code skill (usable by any agent that can run shell commands) that produces **self-contained, dark-themed HTML reports** instead of dumping long output into your terminal — plus a **standalone viewer** that makes those reports interactive: reply boxes, live task lists, one-click next-step cards, and archive/restore.


What you get

• /report skill — auto-triggers on long output; 5 report types (task-completion, research, audit, error-blocker, comparison) with a strict, accessible Aurora theme.
• bin/report CLI — paths, indexing, archive/restore, the tiny task store, and the marker-wrapped blocks the viewer splices live.
• viewer/serve.py — a stdlib-only viewer (python3, no deps): report index, themed serving, per-task reply forms, a report-level reply box, "Do it" prompt cards, .md linkification, archive with unbreakable links.
• Reply relay — replies are composed into self-describing messages and appended to replies.jsonl (+ stdout), or piped to any command you choose.

Zero dependencies beyond Python 3.9+.

Quick start (demo in one command)

./examples/make-demo.sh

That seeds a throwaway `REPORT_DIR` with a fictional **acme-widgets** report, three fake tasks, and starts the viewer on [http://127.0.0.1:8765](http://127.0.0.1:8765). Open the report and try the reply box, the per-task forms, and the **Do it** cards — everything lands in `$REPORT_DIR/replies.jsonl`.

Install

git clone  && cd claude-report-skill

# 1. the skill (Claude Code)
mkdir -p ~/.claude/skills/report
ln -s "$PWD/SKILL.md" ~/.claude/skills/report/SKILL.md

# 2. the CLI + its shared module (keep them together)
mkdir -p ~/.local/bin
ln -s "$PWD/bin/report" "$PWD/bin/report_common.py" ~/.local/bin/

# 3. the viewer — run it from the repo, or copy viewer/ + bin/ somewhere
python3 viewer/serve.py

Make sure `~/.