convez.ai
SkillDesign & UIIntermediário
geo-mena

Distill — Sistema de Design para Artigos Técnicos

geo-mena/distill

Design system Distill.pub para artigos ML: diagramas, voz editorial, componentes

Ver no GitHub
BomPluginScore · de 0 a 100

Skill Claude que codifica as convenções visuais e editoriais do Distill.pub, journal web-native de pesquisa em ML. Fornece primitivos reutilizáveis para diagramas técnicos (atenção, CNN, grafos, RL), reescrita editorial em voz Distill e componentes de artigo (TOC, citações hover, footer). Validado contra 10 artigos e 131 figuras do corpus original.

Instalação

$npx convez-ai geo-mena/distill

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
3
Forks
1
Acompanhando
0
Saúde
57%
Último commit
há 5 meses
Versão
v0.4.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar diagramas técnicos em estilo Distill (atenção, CNN, grafos, RL, Feynman)
  • Reescrever conteúdo técnico na voz editorial Distill (plural, sem marketing)
  • Gerar artigos long-form com TOC, citações e footer canônico
  • Visualizar arquitetura cloud e modelos de ML com componentes SVG

Veredito

Skill especializado e bem documentado para quem produz conteúdo técnico visual. A validação contra corpus real (não fictício) e cobertura de 8+ tipos de diagrama o tornam robusto. Ótimo para pesquisadores e técnicos que querem artigos com identidade visual forte.

README

A tradução para o português deste README ainda está na fila.

Distill Design System cover

A Claude Skill that codifies the visual and editorial conventions of Distill.pub, the now-archived web-native ML research journal.

The system targets the modern article template. Tokens, component sizes, link styling, and stroke palette were validated against live distill.pub via a 10-article DOM audit. The earlier outlier — Georgia serif body, custom <dt-article> element — is out of scope.

Capabilities

Coverage spans the full Distill corpus — 10 articles, 131 source figures audited and distilled into reusable primitives.

CategoryPromptOutput
Editorial in Distill voice"Write a long-form on [topic] in Distill style"Article with TOC, hover citations, math, 7-section canonical footer
Editorial in Distill voice"Rewrite this paragraph in Distill voice"First-person plural, no marketing superlatives, no exclamation points, math-verbs verbed
Diagrams — core"Diagram an attention mechanism over memory"Composed primitives: TensorVector, Arrow, OperatorNode, SubNetBlock, PointerGlyph, on the salmon/blue/lavender palette
Diagrams — FiLM"Visualize this model FiLM-style"Pre-built scenes — concat, bias, scaling, FiLM-network, interactive scrubber
Diagrams — RL"Show a cliffworld with the optimal policy and value function"GridWorld for cells, paths, agents, goal and penalty cells; ValueHeatmap for opacity-encoded V(s) and Q(s,a); PolicyArrows for 4-direction stochastic policy
Diagrams — graphs and trees"Beam search lattice for CTC" / "Argumentation tree"GraphNode, GraphEdge; BeamSearchTree with active, pruned and neutral states; DebateTree with claim and counter sides; HMMState with subscript labels
Diagrams — sequence and attention"Attention heatmap over tokens" / "CTC alignment matrix"AttentionHeatmap — 1D, opacity-modulated; CellGrid for CTC DP and Game of Life; RecurrentArrow for LSTM/GRU feedback; VariableTensor with per-cell width
Diagrams — CNN"Receptive field with stride 2 padding 1"ConvGrid — input grid, kernel overlay, padding ring, output cell linkage; output size auto-computed
Diagrams — specialized"Benzene molecule" / "e+ e− → q q̄ Feynman diagram" / "Game of Life evolution" / "GNN validation accuracy boxplot"MoleculeViewer, FeynmanDiagram, AutomataGrid, DistillBoxplot, ImageWithAnnotations for raster overlays with categorical circles
Cloud architecture"Multi-region observability diagram"Hand-drawn vendor-agnostic SVG using the service-<slug> line-art icon library — 29 symbols across edge, compute, data, messaging, observability, networking, storage, identity
Slide decks"8-slide deck on [paper]"Paper-warm background, system sans, one idea per slide, figure breakouts, citations at the foot
Product styling"Style my dashboard like Distill"Drop-in tokens/colors_and_type.css tokens; TSX components copy-paste-ready
Product styling"Convert this brand to a scholarly-editorial system"Brand-to-token mapping with diagram primitives
Mockups"Quick mockup of [feature]"Standalone HTML artifact
Mockups"Lay out 6 variants side-by-side"Uses templates/design-canvas.tsx — pan, zoom, drag-reorder, focus mode
Mockups"Add a live tweaks panel for primary color and font size"Uses templates/tweaks-panel.tsx — floating panel, postMessage-persisted
Visual reference"Show me how Distill diagrams [concept]"131 source figures from 10 articles in sources/

Commands

Seven slash commands wrap the most common workflows. Each one loads the skill and adds focused instructions plus the project's hard constraints — no emoji, no marketing superlatives, no year literals, English-only, palette and stroke rules.

CommandArgsWhat it does
/distill-design:articletopic / paper / briefLong-form article scaffold — TOC, hover citations, math, 7-section canonical footer
/distill-design:diagramone-line topicSingle SVG diagram, with primitive-file selection guidance baked in
/distill-design:cloud-archarchitecture briefVendor-agnostic cloud architecture SVG using the service-<slug> icon library
/distill-design:coverproject name + pitch1600×500 README cover banner in the article-hero pattern
/distill-design:rewritetext to rewriteText in Distill voice — first-person plural, no superlatives, sentence case
/distill-design:slidestopic / paper16:9 slide deck — one idea per slide, paper background, system sans
/distill-design:brand-mapbrand briefMap a product brand onto Distill tokens — override CSS, component adapter notes, voice translation table

Source files live under plugins/distill-design/commands/ — each is a Markdown prompt template with a description frontmatter and a body that loads the skill before doing the task.

Examples

Reference architecture diagrams in the system's visual language — vendor-agnostic, hand-drawn line art, paper-warm palette, dashed arrows for failover, replication, and observability.

Multi-region observability

Multi-region observability architecture

Multi-tier app with RDS

Multi-tier app with RDS Multi-AZ and read replica

Install

Claude Code marketplace

/plugin marketplace add geo-mena/distill
/plugin install distill-design@distill-design-marketplace

Restart Claude Code. Invoke with /distill-design, or describe an editorial or diagrammatic task — the skill activates by description match.

Claude Code local symlink

./scripts/install-claude.sh

Symlinks plugins/distill-design/ to ~/.claude/skills/distill-design. For iteration on the skill itself.

Other agents

Per-tool adapters under configs/: Codex, Cursor, OpenCode, OpenClaw, Pi. Each adapter points the target agent to the canonical skill at plugins/distill-design/.

Repository map

.
├── README.md, CHANGELOG.md, LICENSE
├── package.json                            # Pi package metadata
├── .claude-plugin/                         # marketplace.json + plugin.json
├── configs/                                # per-agent adapters
│   ├── codex/AGENTS.md
│   ├── cursor/distill-design.mdc
│   ├── opencode/AGENTS.md
│   ├── openclaw/AGENTS.md
│   └── pi/AGENTS.md
├── scripts/
│   ├── install-claude.sh                   # symlink to ~/.claude/skills/distill-design
│   └── bump-version.sh                     # release helper, sync version across manifests
└── plugins/distill-design/                 # canonical Skill
    ├── SKILL.md                            # manifest, read by Claude on invocation
    ├── DESIGN-SYSTEM.md                    # voice, color, typography, iconography, caveats
    ├── tokens/colors_and_type.css          # three palettes, type scale, spacing, radii, motion
    ├── fonts/                              # Geist Pixel Square, mono only
    ├── assets/                             # pointer-glyph, wordmark, ICONOGRAPHY.md
    ├── ui_kits/article/                    # 7 .tsx files + assembled index.html
    │   ├── Primitives.tsx                  # TensorVector, Arrow, OperatorNode, SubNetBlock, ...
    │   ├── Chrome.tsx                      # ArticleNav, ArticleHeader, TOCDrawer, ArticleFooter
    │   ├── Diagrams.tsx                    # FiLM scenes — concat, bias, scaling, network, scrubber
    │   ├── RL.tsx                          # GridWorld, ValueHeatmap, PolicyArrows
    │   ├── Graph.tsx                       # GraphNode, GraphEdge, BeamSearchTree, DebateTree, HMMState
    │   ├── Heatmap.tsx                     # AttentionHeatmap, CellGrid, RecurrentArrow, VariableTensor, ConvGrid
    │   ├── Specialized.tsx                 # MoleculeViewer, AutomataGrid, FeynmanDiagram, ImageWithAnnotations, DistillBoxplot
    │   └── index.html                      # serve via HTTP — Babel standalone fetches .tsx via XHR
    ├── templates/                          # author tools
    │   ├── design-canvas.tsx               # Figma-style canvas wrapper
    │   └── tweaks-panel.tsx                # floating live-tweak panel
    ├── preview/                            # 48 reference cards, one per token or component
    ├── sources/                            # 131 source figures from 10 articles
    └── resources/diagrams/                 # output diagrams + _service-icons.svg (29 symbols)

Out of scope

  • Emoji.
  • Marketing superlatives — "revolutionary", "powerful", "game-changing".
  • Exclamation points in body text.
  • Gradients, glassmorphism, fixed or sticky elements in articles.
  • Simplification of math notation. Density is part of the identity.
  • Multi-color or filled icons.
  • Earlier Distill template, predating the current <d-article> reader.

Community

See CONTRIBUTING.md for guidelines and how to submit PRs.

AI / vibe-coded PRs welcome.

Thanks to all contributors:

Contributors

Ver o original no GitHub

Bom para

Relacionados