CODE REVIEW / Trail of Bits
Review Walkthrough
Turns the committed diff of the current branch into a standalone HTML page of ordered review steps, each with an explanation and severity-tagged findings anchored to diff lines.
“Generates an interactive HTML walkthrough for reviewing code changes. Use only when explicitly called.”
01 / THE REASONING
Why this made the selection.
- Its bundled renderer compares every step with the complete captured patch, so a step whose per-file diff was split, rewritten, omitted or invented is refused rather than shown.
- The skill keeps the checkout untouched: it says not to change branches, reset, edit source files, run the project's tests or install its dependencies in order to build the walkthrough.
- It ships in trailofbits/skills; the plugin README names Facundo Tuesca of Trail of Bits as author.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/review-walkthrough/skills/review-walkthrough/SKILL.md
- plugins/review-walkthrough/skills/review-walkthrough/scripts/render_walkthrough.py
- plugins/review-walkthrough/skills/review-walkthrough/scripts/pyproject.toml
- plugins/review-walkthrough/skills/review-walkthrough/template.html (searched for scripts, links and URLs)
- plugins/review-walkthrough/skills/review-walkthrough/agents/openai.yaml
- plugins/review-walkthrough/README.md
- plugins/review-walkthrough/.claude-plugin/plugin.json
- README.md (installation and licence sections)
- LICENSE
Our findings
- The base is the user's, else the open PR's, else the remote default branch; the skill says not to assume main and to ask when the base is missing or ambiguous.
- The patch is captured with git diff --no-ext-diff --no-textconv between the merge base and HEAD, saved to a temporary file outside the checkout.
- render_walkthrough.py has no third-party dependencies; it reads --input and --diff, refuses an --output equal to either or to the template, and writes one HTML file.
- The renderer runs git apply --numstat -z from the system temp directory to parse patch paths; the code comment says this does not apply the patch.
- template.html has one inline <script> and no external script, stylesheet or fetch; its only URL strings are an XHTML namespace check and a SAFE_HREF pattern that lets fragment links point at http(s), mailto, # or / targets.
- agents/openai.yaml sets allow_implicit_invocation: false, matching the explicit-only frontmatter.
Not established by this review
- Not executed: it was not installed or run.
- The renderer, the page and its gh api export were not run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- In Claude Code, add the marketplace with `/plugin marketplace add trailofbits/skills` (repository README). This adds the whole Trail of Bits marketplace, not review-walkthrough alone.
- Open `/plugin menu` and install the review-walkthrough plugin, which holds this one skill.
- Invoke it explicitly with `/review-walkthrough:review-walkthrough`, optionally naming a base such as "compare this branch against origin/develop" (plugin README).
Before you start
- Git
- `uv` and Python 3.11 or later for the bundled renderer
- GitHub CLI (`gh`), optional, for PR metadata and for running a copied review command
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/skills/review-walkthrough/SKILL.md
Supports: upstreamDescription, summary, whySelected, bestFor, limitations, compatibility, access, review.findings
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/skills/review-walkthrough/scripts/render_walkthrough.py
Supports: access, review.findings
- Renderer pyproject.toml ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/skills/review-walkthrough/scripts/pyproject.toml
Supports: install.prerequisites
- Walkthrough page template ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/skills/review-walkthrough/template.html
Supports: review.findings
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/skills/review-walkthrough/agents/openai.yaml
Supports: review.findings
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/README.md
Supports: compatibility, install.steps, install.prerequisites, limitations, access
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/.claude-plugin/plugin.json
Supports: whySelected
- trailofbits/skills README ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: install, license, compatibility
- trailofbits/skills LICENSE ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: license