← Explore all skills

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.

Upstream setup instructions ↗
  1. 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.
  2. Open `/plugin menu` and install the review-walkthrough plugin, which holds this one skill.
  3. 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.

  1. 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

  2. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/skills/review-walkthrough/scripts/render_walkthrough.py

    Supports: access, review.findings

  3. Renderer pyproject.toml ↗Checked

    https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/skills/review-walkthrough/scripts/pyproject.toml

    Supports: install.prerequisites

  4. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/skills/review-walkthrough/template.html

    Supports: review.findings

  5. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/skills/review-walkthrough/agents/openai.yaml

    Supports: review.findings

  6. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/README.md

    Supports: compatibility, install.steps, install.prerequisites, limitations, access

  7. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/review-walkthrough/.claude-plugin/plugin.json

    Supports: whySelected

  8. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md

    Supports: install, license, compatibility

  9. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE

    Supports: license

Evidence & Ask