diff-artifact

Publishes annotated git diffs as self-contained claude.ai artifact pages with per-hunk reviewer notes.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/shawn-sandy/agentics-kit --skill diff-artifact-shawn-sandy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diff-artifact
Source: https://github.com/shawn-sandy/agentics-kit/tree/main/kit/plugins/artifact-tools/skills/diff-artifact
Command: npx skills add https://github.com/shawn-sandy/agentics-kit --skill diff-artifact-shawn-sandy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Raw git diffs show what changed but not why it matters, forcing reviewers to interpret every hunk themselves. This Skill annotates each meaningful hunk with reviewer notes and publishes the result as a shareable claude.ai artifact page, while scrubbing for secrets before anything leaves the local environment. ## Core Features & Use Cases - Annotated diff walkthroughs: Writes a note against each meaningful hunk and renders a self-contained page with a sticky file sidebar and severity labels. - Blocking security gate: Runs a secret-scanning scrub on the diff before publishing and rescans the rendered page, with a BLOCKED verdict acting as a hard stop. - Flexible diff sources: Resolves branch diffs by default, commit ranges like abc123..def456, or PR references such as #42, degrading gracefully to a branch diff when PR mode fails. - Durable publishing workflow: Saves a local copy under .claude/artifacts/, reuses recorded URLs so pages update in place, and verifies the published page actually rendered. - Use Case: Before requesting review on a feature branch, publish an annotated diff walkthrough so reviewers see per-hunk context and severity labels instead of a raw diff. ## Quick Start Ask the assistant to publish an annotated diff walkthrough of the current branch to a claude.ai artifact.

Frequently Asked Questions about diff-artifact

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

FAQPage Schema
How do I publish an annotated git diff for code review?▼

Invoke the diff-artifact skill with a branch, commit range like abc123..def456, or PR reference such as #42. It annotates each meaningful hunk, scrubs for secrets, and publishes a self-contained claude.ai artifact page with a file sidebar and severity labels.

How does the skill prevent secrets from leaking in published diffs?▼

It runs the social-media-tools security-scrub gate on the diff before any publishing, then rescans the fully rendered HTML page to cover annotations and quoted context. A BLOCKED verdict is a hard stop with no override option.

What diff sources does the skill support?▼

It resolves a branch diff by default, a commit range for inputs like abc123..def456, and PR mode for references like #42 or a PR URL. PR mode degrades to a branch diff rather than failing, and an empty diff stops the workflow.

What happens if the security-scrub skill is not installed?▼

The gate is never skipped silently. The skill reports that the scan could not run and asks via AskUserQuestion whether to continue publishing unscanned, leaving the decision explicitly to the user.

Does publishing the same diff twice create duplicate artifacts?▼

No. The skill records the published URL keyed by what the diff is, never by date, and reuses that URL on subsequent publishes so the page updates in place. It also verifies the page rendered by fetching the URL and checking for the first changed filename.