Skill843 repo starsupdated 4d ago

diffs

The diffs tool generates shareable unified diffs in multiple formats: interactive viewer URLs, file artifacts (PNG or PDF), or both combined. Use this skill when presenting code changes, edits, or comparisons that require visual clarity beyond written summaries, particularly for code reviews, documentation of changes, or delivery to users through message or canvas tools.

View source Repository: ScienceClaw

Install in Claude Code

Copy

git clone --depth 1 https://github.com/beita6969/ScienceClaw /tmp/diffs && cp -r /tmp/diffs/extensions/diffs/skills/diffs ~/.claude/skills/diffs

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

When you need to show edits as a real diff, prefer the `diffs` tool instead of writing a manual summary.

The `diffs` tool accepts either `before` + `after` text, or a unified `patch` string.

Use `mode=view` when you want an interactive gateway-hosted viewer. After the tool returns, use `details.viewerUrl` with the canvas tool via `canvas present` or `canvas navigate`.

Use `mode=file` when you need a rendered file artifact. Set `fileFormat=png` (default) or `fileFormat=pdf`. The tool result includes `details.filePath`.

For large or high-fidelity files, use `fileQuality` (`standard`|`hq`|`print`) and optionally override `fileScale`/`fileMaxWidth`.

When you need to deliver the rendered file to a user or channel, do not rely on the raw tool-result renderer. Instead, call the `message` tool and pass `details.filePath` through `path` or `filePath`.

Use `mode=both` when you want both the gateway viewer URL and the rendered artifact.

If the user has configured diffs plugin defaults, prefer omitting `mode`, `theme`, `layout`, and related presentation options unless you need to override them for this specific diff.

Include `path` for before/after text when you know the file name.