Imported from maxgio92/dotfiles (assistants/skills/review-reports/SKILL.md). Install upstream with npx skills add maxgio92/dotfiles --skill review-reports. Copyright stays with the author.

Review Reports

Write reports to durable per-user storage, never into the repository under review. Reports are data the user reads and acts on later, so they live under the XDG data home, not state, cache, or runtime:

${XDG_DATA_HOME:-$HOME/.local/share}/agent-reports/<repo>/<YYYY-MM-DD>-<agent>-<slug>.md

• <repo>: the repository directory name (e.g. dotfiles, mono).
• <agent>: who produced it (blast, dastardly, penry, ...).
• <slug>: two to four kebab-case words naming the scope (e.g. webhook-auth-audit).

Create the directory if missing. Two runs on the same day get distinct slugs; append -2 only on a true collision. Start every report with the scope, the commit sha reviewed, and the date, so the file stands alone. Reports are read-only history: append a dated follow-up section instead of rewriting past findings.