New to Claude Skills? Learn how to install them →

nexu-io on GitHub

Diff Review

Free

Streamline code migration with human-reviewable diffs.

Get this skill

Free · Opens the source repo

What Diff Review does

The Diff Review skill is designed to facilitate the review process of code changes during migration or collaboration. It presents a unified diff of the accumulated changes made since the last review, allowing users to assess modifications in a clear and structured manner. By utilizing a GenUI interface, the skill captures user decisions regarding the acceptance or rejection of these changes, ensuring that every review is documented and actionable.

When the Diff Review skill is executed, it generates a series of outputs including a unified diff file, a human-readable summary of changes, and a decision log that records the user's choices. This structured output not only helps in understanding the changes made but also aids in maintaining a clear audit trail of decisions made during the review process. The skill is particularly useful in scenarios where multiple contributors are involved, and a consensus on changes is necessary before finalizing the code.

The skill operates by taking the current working directory's accumulated edits and contextual information from a specified JSON file. It then presents the user with three options—accept, reject, or partially accept the changes—allowing for granular control over the review process. In cases of partial acceptance, users can further refine their decisions on a per-file basis, ensuring that the final outcome reflects their precise intentions.

Overall, Diff Review is an essential tool for developers and teams engaged in code migration or collaborative projects, providing a systematic approach to reviewing changes and making informed decisions about code integration.

When to use it

Use this skill when you need to review and approve code changes during migration or collaborative development.

When not to use it

This skill is not suitable for automated processes where human review is unnecessary or when changes do not require explicit acceptance.

What you can build with it

Collaborative Code Review

When multiple developers contribute to a project, use Diff Review to ensure all changes are reviewed and accepted collectively.

Code Migration Projects

During code migration, utilize this skill to present changes clearly, allowing for informed decisions on what to integrate.

Granular Change Management

If only certain files in a patch need approval, use the partial acceptance feature to selectively review and accept changes.

How to install Diff Review

View source

1. Install with the skills CLI

npx skills add nexu-io/open-design/diff-review --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by nexu-io

Diff review

Spec §20.3 / §21.3.2: a code-migration / tune-collab handoff is worthless without a human-reviewable diff. This atom is the "present the patch, capture the decision" stage.

Inputs

  • The project cwd's accumulated edits since the run started (or since the previous diff-review iteration).
  • plan/steps.json for context per file.

Output

project-cwd/
└── review/
    ├── diff.patch        # unified diff (git apply-shaped)
    ├── summary.md        # human-friendly per-file walkthrough
    ├── decision.json     # { decision: 'accept' | 'reject' | 'partial', accepted_files: [...], rejected_files: [...], reviewer: 'user' | 'agent' }
    └── meta.json         # { generatedAt, atomDigest, planRevision }

The atom raises a choice GenUI surface with the three top-level decisions (accept / reject / partial). On partial the user flips per-file decisions through follow-up surfaces.

Convergence

The atom completes when decision.json has a non-empty decision. Acceptance writes handoffKind: 'patch' (or 'deployable-app' when a successful build-test is on file) into the eventual artifact manifest; rejection rolls back the patch via git restore or the equivalent in the code-import-bound repo path.

Anti-patterns the prompt fragment forbids

  • Skipping the surface and assuming acceptance.
  • Generating a decision.json that lacks accepted_files / rejected_files on partial decisions.
  • Rolling back files outside plan/steps.json's union of files[] — the patch boundary is a contract.

Status

Implemented by the daemon runner in apps/daemon/src/plugins/atoms/diff-review.ts, with GenUI decisions persisted by apps/daemon/src/plugins/atoms/diff-review-genui-bridge.ts.

Frequently asked questions about Diff Review

Similar skills