fireworks-open-eli5

Generate evidence-aware interactive visual explainers as deterministic offline HTML from JSON specs.

190|12|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/yizhiyanhua-ai/fireworks-open-eli5 --skill fireworks-open-eli5-yizhiyanhua-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fireworks-open-eli5
Source: https://github.com/yizhiyanhua-ai/fireworks-open-eli5
Command: npx skills add https://github.com/yizhiyanhua-ai/fireworks-open-eli5 --skill fireworks-open-eli5-yizhiyanhua-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Explaining complex systems, codebases, or incidents usually produces either oversimplified analogies or dense technical prose. This Skill turns a difficult system into a truthful, interactive visual story where every claim is labeled as verified, inferred, or analogy, and compiles it into a single self-contained HTML file that works fully offline. ## Core Features & Use Cases - Four story grammars: concept, repository module, engineering tradeoff, and incident, each with a dedicated summary view and semantic validator. - Evidence at the claim: every scene shows source status, core text, support scope, and a URL or explicit no-locator boundary, with a truth ladder separating analogy, mechanism, and caveats. - Interactive playback and reader workspace: global or scene-local traces animate real nodes and edges, with failure lens, teach-back questions, opt-in local history, favorites, and annotations. - Local export: PDF, scene PNG, all-scene PPTX, Pages-compatible DOCX, and optional verified native .pages conversion via a loopback helper. - Use Case: Ask your agent to explain how one queued job moves through a repository, citing real files, playing the request path, and showing what breaks when a lease expires; the result is a validated offline HTML explainer. ## Quick Start Ask your agent to explain how a request flows through this repository as an interactive visual story with cited evidence and a failure view, then open the generated HTML file in a browser.

Frequently Asked Questions about fireworks-open-eli5

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

FAQPage Schema
How do I create an interactive visual explainer for a codebase or concept?▼

Write a version 1 JSON story spec with scenes, nodes, edges, a trace, and an evidence map, then run node scripts/validate.mjs and node scripts/render.mjs to produce a self-contained offline HTML explainer. The Skill supports concept, module, tradeoff, and incident story modes.

What formats can the generated explainer be exported to?▼

The explainer exports locally to PDF via the browser print dialog, a 1600x900 PNG per scene, one-slide-per-scene PPTX, and Pages-compatible DOCX. Native .pages conversion is optionally available on macOS through a loopback helper that verifies the package reopens in Apple Pages.

Does the explainer require network access or npm dependencies?▼

No. Rendering requires only Node.js 18 or newer with local file access and zero npm dependencies. The generated HTML embeds no remote resources, fonts, XHR, or eval, and works fully offline under a hash-whitelisted Content Security Policy.

How does the explainer handle evidence and source citations?▼

Every evidence item is labeled verified, inferred, or analogy, and each scene evidence card shows status, core basis, support scope, and a URL or explicit no-locator boundary. Analogies can never support implementation or causal claims, and the validator rejects unsafe source URLs.

When should I not use this visual explainer approach?▼

Do not use it for plain short answers, ordinary prose rewrites, generic website implementation, or claims that lack defensible evidence. If evidence is incomplete, the workflow stops and reports the gap rather than decorating unsupported claims.