Report back to the user in a well-formatted markdown file for readability. Use this skill PROACTIVELY when the output is lengthy or refers to figures/tables/or latex math, or when users request a markdown report.
Agents should use this skill proactively when output would be lengthy, especially if it involves figures or LaTeX math. Long responses with math/figures render poorly in the terminal. Saving to markdown and providing a clickable link is a better UX.
Check project guidance (AGENTS.md, CLAUDE.md, project README, .claude/ docs) for a documentation path.
./scratch/ (create if needed). Use scratch/ for transient agent output.Define:
REPORT_DIR = resolved directoryREPORT_ATTACHMENTS_DIR = ${REPORT_DIR}/attachmentsCollect the following:
# Git state
git log -1 --pretty=format:"%H" # HEAD commit
git diff --quiet; echo $? # 0 = clean, 1 = dirty
# Timestamp
date -u +"%Y-%m-%dT%H:%M:%S"
Session ID: use context if available, otherwise generate session-YYYYMMDD-HHMMSS.
Filename: YYYY-MM-DD-report-[description].md
Frontmatter:
---