sk-create-diff

Create Diff

create-diff is the sk-doc workflow packet for reviewing what changed in a locally edited document — outside Git and without a hosted service. It captures a baseline before an edit, then compares the before and after versions and renders a single self-contained, accessible HTML report. The comparison engine ships with this packet as scripts/create_diff.py; everything runs on the machine with no network, no upload, and no telemetry, and source files are never modified.

Supported formats and fidelity tiers: plain text and Markdown (full text fidelity), HTML and DOCX (visible/structural text), and text-layer PDF (conditional on a local extractor). Each report states its fidelity tier so a comparison is never trusted beyond what the extractor can actually see.

This packet owns diff authoring and its two scripts. It uses shared sk-doc standards from ../shared/ for surrounding-document quality. It must not add packet-local advisor metadata such as graph-metadata.json or description.json.

---

1. WHEN TO USE

Activation Triggers

Use this packet when the request asks to:

• Review what an AI (or anyone) changed in a locally edited document.
• Produce a before/after report for a Markdown, text, HTML, DOCX, or PDF file that is not in Git.
• Capture a baseline of a document before editing it, so the change can be reviewed afterward.
• Compare two explicit versions of a document (an old file and a new file).

Keyword triggers: create diff report, document before/after review, before/after document diff, document change report, review document edits, docx diff, pdf diff.

When NOT to Use

Route elsewhere when:

• The files are code or already tracked in Git — use git/sk-git for source diffs.
• The comparison is visual or design-oriented (layout, pixels, screenshots) — out of scope; create-diff compares extracted text only.
• The task is auditing, scoring, or validating a single existing document rather than comparing two states — use create-quality-control.
• The deliverable is a README, skill, command, agent, changelog, or flowchart — use the matching create-* packet.