retro

Installation
SKILL.md

Review the session

Suggest changes that prevent recurring friction in future runs. Default to the current session; when the user names another, read its available logs, artifacts, commits, and verification results. Distinguish observed events from inference and missing evidence.

Load writing-for-agents, plain-english, and deslop-written through the Skill tool when available; otherwise read their SKILL.md files. Apply them to the report.

Find improvements

Trace each candidate to session evidence and inspect repository configuration before proposing a fix:

  • Navigation: time spent finding files, hidden dependencies, and missing context pointers. Prefer a precise pointer to a duplicate document.
  • Automated checks: a mistake that a deterministic check can catch, or an unwired or broken check. Read build scripts, CI, and hooks first. An absent hook warrants a proposal when the session shows a failure it would prevent or the repository requires one.
  • Review guidance: judgment calls the review missed, such as cross-file consistency or domain meaning. Put mechanical rules in the repository's checker; reserve review prose for decisions a checker cannot make.
  • Steering files: duplicated instructions, instructions that do not change behavior, or large always-loaded files that could point to focused references.
  • Tool use: repeated expensive reads, avoidable output, unavailable capabilities, or scripts whose input or output causes recurring mistakes.
  • Information access: missing logs or read access that blocked a decision. Name the specific information and the smallest access change that would expose it.

Keep implementation facts, review facts, and environment causes separate. A reviewer still needs the spec, standards, and relevant context; a diff alone does not establish intended behavior.

Installs
2
GitHub Stars
2
First Seen
Oct 11, 2026