convez.ai
SkillDesenvolvimento WebIntermediário
jtotty

Folio — Explainer HTML Visual Consistente

jtotty/folio

Explainers HTML calmos e consistentes para documentação técnica densa

Ver no GitHub
InicialPluginScore · de 0 a 100

Family 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/folio

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
1

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

SkillWhat it makes
software-visual-explainerA 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-comparisonA 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/ (canonical core.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

Ver o original no GitHub

Bom para

Relacionados