Folio — Explainer HTML Visual Consistente
jtotty/folio
Explainers HTML calmos e consistentes para documentação técnica densa
Ver no GitHubFamily de skills Claude Code que transforma documentação densa (specs, RFCs, ADRs, tours de codebase) em páginas HTML auto-contidas com design visual consistente. Combina linguagem natural com diagramas Mermaid, código sintaxe-destaque e narrativa clara em um único arquivo.
Instalação
npx convez-ai jtotty/folio1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Transformar especificações técnicas em visualizadores narrativos
- Criar comparações lado-a-lado de opções de design/implementação
- Documentar reviews de PRs e brainstorms com diagramas e código real
- Gerar tours de codebase autodescritivos para onboarding
Veredito

Folio resolve um problema real: explainers visuais mudam de aparência a cada geração, quebrando consistência cognitiva. Sua abordagem de tema visual único e auto-contido (sem build, sem dependências) é pragmática e bem-executada. Ideal para times que produzem muita documentação técnica.
README
A tradução para o português deste README ainda está na fila.
folio
Calm, consistent, self-contained HTML explainers for dense docs.
folio is a small family of Claude Code skills that turn
dense source material — design specs, RFCs, ADRs, codebase tours, API designs, option comparisons —
into a single self-contained HTML page that mixes plain-language framing with technical detail,
diagrams, and syntax-highlighted code.
Why another explainer?
Most AI "visual explainer" tools pick a different look on every run — new fonts, new gradients, new color scheme each time. That novelty is the enemy of comprehension: every page makes the reader re-learn where to look.
folio does the opposite. It has one locked visual system — warm paper, a forest-green accent, a serif body, monospace labels, no gradients, no emoji — applied identically to every explainer it produces. You recognize a folio page on sight, and you spend your attention on the content, not the chrome. The goal is simple: a page you'll actually read once, all the way through.
Skills
| Skill | What it makes |
|---|---|
software-visual-explainer | A narrative explainer for one software topic — a feature, spec, migration, PR, or codebase area. Plain-language framing + Mermaid diagrams + real, syntax-highlighted code. Has dedicated PR-review and brainstorm modes. |
code-option-comparison | A scannable side-by-side grid comparing 3–6 design or implementation options against the same axes, with a recommendation. |
Software topics today. The shared design system is built to grow — finance (tax, investing, business analysis) and long-form article explainers are on the roadmap.
Install
In Claude Code (marketplace):
/plugin marketplace add jtotty/folio
/plugin install folio@jtotty
Or via the skills CLI:
npx skills@latest add jtotty/folio
Then ask Claude things like "create an explainer for this spec", "turn this brainstorm into a visual walkthrough", or "compare these 4 approaches side by side."
Design principles
- One locked theme, every time. Consistency over novelty. The whole design system lives once in
skills/visual-explainer-core/and every skill inherits it. - Stay in the loop. Optimize every choice for the human actually reading it once — a 60% explanation they finish beats a 100% one they don't open.
- Real code, not pseudocode. Snippets are verified against the source so the reader sees the exact symbols they'll find in the codebase.
- Single-file output, no build. One HTML file you just open in a browser — it embeds the shared theme and renders Mermaid diagrams + syntax-highlighted code from a CDN. Nothing to install.
Shipped
- Shared design system in
skills/visual-explainer-core/(canonicalcore.css+core.js) — every skill embeds the same theme, so they can't drift. - Self-contained CDN templates: copy, fill in, open. Mermaid + Prism render in the browser with the locked theme — no build step, no Node.
- Accessibility (WCAG-AA contrast, focus, keyboard), a print/Save-as-PDF stylesheet, and reading-first comprehension aids (scroll-spy, sidenotes, details-on-demand).
Roadmap
- New domains:
finance-visual-explainer,article-visual-explainer.
License
MIT © 2026 jtotty