Skip to content

Explain v0.2.0

Latest

Choose a tag to compare

@asunchu asunchu released this 18 Oct 14:44

Explain v0.2.0 adds clearer writing defaults and local diagram rendering with Pele.

Changes

  • Share one writing contract across Codex, Claude Code, and OpenCode.
  • Prefer local evidence and relevant primary sources when research is needed.
  • Render editable Mermaid source with pinned Pele 1.6.0 through a bounded worker.
  • Deliver a compact Home HQ example with explicit colors, readable fonts, and a PNG preview.
  • Check fonts before replacing exports, and document phone-width and remote-client checks.
  • Update the 2:17 Explain film and add paired evaluation tooling.

Verification and limits

The paired evaluation report records 90 trials across three harnesses.
Sampled results improve, but failures remain. These trials do not establish universal compatibility.
The dated security review covers Pele 1.6.0 and this local integration.
It finds no confirmed critical or high vulnerability in the tested runtime path. It does not guarantee future versions or public-service safety.

Package validation, renderer tests, font-failure tests, and dependency audits pass.
Desktop and phone-width browser checks confirm readable labels and working links.
The clean Linux run verified public installation for three harnesses and checked a rendered video sample.
These installation checks do not run AI agents or test fresh speech synthesis.
No independent listening audition was performed for the film.

Release checks pass: Validate and clean Linux installation/render.

Install or update

npx skills add asunchu/explain --skill explain -g -a codex -a claude-code -a opencode

Restart or reload your harness if needed.
For always-on writing, update the copied shared core in your harness instructions.
Preserve unrelated instructions.

Downloads

  • explain-skill.zip: the complete skill and license notices; no installed dependencies or fonts.
  • explain-pele-example.zip: editable diagram source, exports, and the skill wrapper needed to reproduce it.
  • home-hq.png: the approved diagram preview.
  • explain.mp4: the current narrated film.
  • software-factory.html: the standalone interactive example.
  • SHA256SUMS: checksums for all five downloads.

Live examples · Changelog · Full changes