Skip to content

Releases

v2.0.0

Choose a tag to compare

@malav2110 malav2110 released this 31 Oct 01:06
d79e742

This is 2.0.0 because the skill now checks every finished page with Node 22.18 or later. Before, only pages with a Mermaid diagram needed Node. Without Node, the skill still writes the page, but it runs the checks by hand from references/validation.md and says so in its report.

The checks moved from scripts/validate-output.sh to scripts/validate-output.js, which reads the page the way a browser does instead of with grep and sed. That fixes checks that passed broken pages or failed good ones, like the cases in #21. A few results change on purpose: an unlinked-reference failure lists each reference, a Markdown heading anchor such as #license no longer fails, and the quiz checks read only the quiz's visible text.

The script is one bundled file, with its packages' license notices in scripts/THIRD-PARTY-LICENSES.txt, so there's nothing to install. If you call the shell script yourself, run node scripts/validate-output.js <page> <short commit> instead. It takes the same arguments and uses the same exit codes. If you install by hand, copy the whole skills/explain-diff-html folder again.

Also since v1.3.0: a page that couldn't verify something now names the public artifacts to check, and leaves out unconfirmed claims about who wrote what (#32). The uPortal PR 2945 sample was regenerated under those rules (#34), and CI now runs ShellCheck (#35).

Thanks to @ChristianMurphy for the new validator, @Aaqibhafeezkhan for the verification rules, and @Shachi95 for the ShellCheck step.

v1.3.0

Choose a tag to compare

@malav2110 malav2110 released this 14 Oct 00:57
e77b230

The checks the skill runs on a finished page are now a script, scripts/validate-output.sh. CI runs it on every sample. The script fails a page with an unlinked reference, a link with a short commit sha, or a Markdown line link without ?plain=1.

Links are safer too: a token in your remote URL no longer ends up in them. There are also fixes for choosing what to diff when gh or the network isn't available, and for the quiz checks.

If you install by hand, copy the whole skills/explain-diff-html folder, since the skill now reads files from references/ and scripts/. And mark any reference you leave unlinked on purpose with data-bare="outside-repo".

Thanks to @andyhorn for most of the fixes here, and to @ChristianMurphy for the validator cases in #21.

v1.2.0

Choose a tag to compare

@malav2110 malav2110 released this 26 Sep 00:36
714537c

Every file:line reference on a generated page now links to that line on
GitHub, pinned to the full commit sha. The nine samples were retrofitted with a
script rather than regenerated; all 104 links resolve.

Also since v1.1.0: installable as a Claude Code plugin, the skill moved under
skills/, both sub-agent passes made visible, and a ninth sample covering a
whole release rather than one pull request.

The skills/ move changes where SKILL.md lives. Plugin installs resolve it
through the manifest and are unaffected. A direct symlink to the repository root
needs repointing at skills/explain-diff-html.

v1.1.0

Choose a tag to compare

@malav2110 malav2110 released this 13 Sep 17:27
Quiz fairness, dark-mode diagrams, and an eighth sample

v1.0.0

Choose a tag to compare

@malav2110 malav2110 released this 12 Sep 23:35

First public release.