One-click install
npx skills add https://github.com/markerikson/opencode-config-example --skill diffloupe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diffloupe
Source: https://github.com/markerikson/opencode-config-example/tree/main/config/skill/diffloupe
Command: npx skills add https://github.com/markerikson/opencode-config-example --skill diffloupe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DiffLoupe helps you understand what a code diff changes, why it changed, and what risks it introduces so reviews don’t miss breaking, security, or intent mismatches.

Core Features & Use Cases

  • Intent derivation and alignment: Determines the likely purpose of the change and compares stated intent (from a commit message or provided text) against what actually changed.
  • Risk assessment: Evaluates bugs, security issues, breaking changes, and other hazards, including evidence tied to specific files.
  • Diff review support: Helps with pre-merge PR review, staged pre-commit checks, and understanding unfamiliar changes by producing structured review output.

Quick Start

Use diffloupe.ts analyze staged --json to review the intent, risks, and alignment of your currently staged changes in machine-readable form.

Frequently Asked Questions about diffloupe

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze code diffs for breaking risks and intent alignment?

DiffLoupe analyzes code diffs to derive change intent and assess review risk across staged changes or PRs. It produces structured JSON output including intent, risk severity with evidence, and alignment matches or mismatches.

What is semantic diff analysis for pull requests?

Semantic diff analysis for pull requests determines the likely purpose of code changes and evaluates hazards like bugs or security issues. It validates that actual modifications align with the stated intent from commit messages.

How do I validate stated commit intent against actual code modifications?

You validate stated commit intent by comparing provided text or commit messages against actual code modifications. DiffLoupe identifies intent alignment matches, mismatches, missing items, and unstated changes in structured JSON output.

Can I review staged pre-commit changes for security issues and breaking changes?

Yes, you can review staged pre-commit changes by analyzing them for bugs, security issues, and breaking changes. DiffLoupe evaluates these hazards and provides risk severity with evidence tied to specific files.

Does DiffLoupe work with commit ranges or only staged changes?

DiffLoupe works with staged changes, pull requests, and commit ranges. It targets pre-commit review, PR understanding before merge, and validation that modifications align with stated intent across these input types.

What is the best way to assess review risk in unfamiliar code changes?

The best way to assess review risk in unfamiliar code changes is deriving change intent and evaluating hazards. DiffLoupe produces structured output including risk severity with evidence, helping you understand breaking or security risks.