Skip to content

ythx-101/live-panel-skill

live-panel

Verified

Build a terminal-style, always-running animated architecture diagram (a "live panel") from a JSON config and render it to an mp4. Use when the user wants a system, agent or org architecture diagram that looks like a monitoring dashboard in a terminal window - fixed layout, glowing packets on the wires, scrolling log, counters, bars that flip state - as a screen-recording-style video or a live web page, instead of a static picture or a step-by-step reveal. 中文:当用户要做"活的"架构图、agent 树或系统监控面板风格的动画(mp4 视频或循环网页)时使用——终端里一直在跑的监控面板外观,固定布局、线上流动的数据包、滚动日志、翻转的计数器和状态条;不是静态图,也不是分步演示。

FileKindSize
SKILL.mdskill md11.2 KB
assets/fonts/Excalifont-OFL.txtmarkdown5.1 KB
assets/fonts/Excalifont-Regular-Latin.woff2binary24.4 KB
assets/fonts/SmileySans-OFL.txtmarkdown4.3 KB
assets/fonts/SmileySans-Oblique.woff2binary1.1 MB
assets/fonts/Xiaolai-OFL.txtmarkdown4.3 KB
assets/template.htmlother35.9 KB
assets/views/LUCIDE-LICENSE.txtmarkdown3.1 KB
assets/views/ROUGH-LICENSE.txtmarkdown1.0 KB
assets/views/excalidraw.jsscript50.0 KB
assets/views/funnel.jsscript15.5 KB
assets/views/loop.jsscript74.3 KB
assets/views/ring.jsscript15.2 KB
assets/views/sketchboard.jsscript18.7 KB
examples/agent-architecture/agent-architecture.mp4binary1.4 MB
examples/agent-architecture/config.jsonconfig37.1 KB
examples/agent-architecture/preview.webpbinary1.2 MB
examples/airbnb/airbnb.mp4binary1.9 MB
examples/airbnb/config.jsonconfig20.3 KB
examples/airbnb/preview.webpbinary1.4 MB
examples/codex-agents/codex-agents.mp4binary1.8 MB
examples/codex-agents/config.jsonconfig19.1 KB
examples/codex-agents/preview.webpbinary1.6 MB
examples/excalidraw-aqua/README.mdmarkdown760 B
examples/excalidraw-aqua/build_config.pyscript6.6 KB
examples/excalidraw-aqua/config-3x4.jsonconfig8.3 KB
examples/excalidraw-aqua/config-4x5.jsonconfig8.3 KB
examples/excalidraw-aqua/preview.webpbinary2.3 MB
examples/excalidraw-gardener/README.mdmarkdown671 B
examples/excalidraw-gardener/build_config.pyscript6.4 KB
examples/excalidraw-gardener/config-3x4.jsonconfig7.6 KB
examples/excalidraw-gardener/config-4x5.jsonconfig7.6 KB
examples/excalidraw-gardener/preview.webpbinary1.2 MB
examples/excalidraw-import/agent-loop.excalidrawother6.7 KB
examples/excalidraw-import/agent-loop.mp4binary1.6 MB
examples/excalidraw-import/config.jsonconfig3.9 KB
examples/funnel-karpathy/config.jsonconfig1.2 KB
examples/funnel/config.jsonconfig1.2 KB
examples/funnel/funnel.mp4binary1.1 MB
examples/funnel/preview.webpbinary475.3 KB
examples/hybrid-agent/README.mdmarkdown729 B
examples/hybrid-agent/config.jsonconfig6.2 KB
examples/loop-poteto/config.jsonconfig6.6 KB
examples/loop-poteto/loop-poteto.mp4binary2.1 MB
examples/loop-poteto/preview-dark.webpbinary638.3 KB
examples/loop-poteto/preview-light.webpbinary627.2 KB
examples/minimal/config.jsonconfig1.9 KB
examples/minimal/preview.webpbinary146.3 KB
examples/ring/config.jsonconfig940 B
examples/ring/preview.webpbinary150.9 KB
examples/ring/ring.mp4binary593.1 KB
references/config-schema.mdmarkdown4.9 KB
references/motion-grammar.mdmarkdown6.4 KB
references/verify-view.mdmarkdown3.3 KB
references/view-rules.mdmarkdown4.3 KB
references/views.mdmarkdown24.7 KB
scripts/check_frames.pyexecutablescript4.6 KB
scripts/excalidraw_import.pyscript14.7 KB
scripts/fetch_fonts.shexecutablescript528 B
scripts/livepanel.pyexecutablescript10.2 KB
scripts/render.pyexecutablescript3.8 KB
scripts/scaffold.pyexecutablescript25.0 KB
scripts/verify_view.pyscript28.5 KB

references/config-schema.md

View on GitHub
# Config schema

One JSON object. All coordinates are canvas pixels (default 1200x1500, y grows downward). Colour names refer to `theme.colors`. Text is monospace; Latin glyphs are 0.6 em wide, CJK glyphs two cells.

## Top level

| key | meaning |
| --- | --- |
| `meta` | `{title, lang}` page title and language |
| `canvas` | `{preset:"4:5"|"3:4"|"1:1", width, height, duration, fps, preroll}` (explicit width/height win over the preset); `preroll` (s) is added to packet phases so delivery counters start above zero |
| `theme` | `{preset:"terminal-dark"|"light-pastel", font, fontSize, lineHeight, boxMode:"segmented"|"solid", radius, borderWidth, wireWidth, packetSize, glow, colors:{name:"#rrggbb"}}`. A preset supplies every field; your values override it, `colors` are merged name by name. Colour names used by the engine: `bg bar line dim fg wh` (+ `line2` log frame, `dots` bar track); add any others |
| `clock` | `{start:"HH:MM:SS", rate}`: log time at t=0 and how many log-seconds pass per second |
| `titlebar` | `{text, height?, size?}` terminal title bar with three dots |
| `credit` | text element for the source/credit line: `{text, y, size?, c?}` (default 12 px, centred, dim) |
| `machines` | named state machines, see below |
| `elements` | drawn in order (later = on top) |

## Elements

- `text` `{x, y, w?, align, runs | t | text, size?, lh?, c?, b?, ls?, font?, inside?}`; `y` is the vertical centre of the line. `inside:true` = intentionally drawn on top of a box (icons).
- `box` `{x, y, w, h, color (border), fill?, radius?, border? (px), dash?, container?, pad:[top,left,right?], align, sides:"solid"?, lines:[...], when?, then?:{fill,color,border,glow}}`. Lines flow at `lineHeight`. `container:true` marks a box that holds other boxes (skipped by the overlap check). `when/then` restyle the whole box while a condition holds (`glow` = colour name).
- `path` `{points:[[x,y],...], color, width?, r? (corner radius), dash?, arrow?:false, head?, opacity?, when?, then?:{color,width,opacity}, flow?:{period, offsets, color, tail, when}}` SVG polyline with arrow head; `flow` adds packets along it.
- `line` `{from:[x,y], to:[x,y], dash?, color?, width?}` axis-aligned wire.
- `glyph` `{x, y, ch, c, size}` e.g. an arrow head.
- `rule` `{x, y, w}` double rule.
- `flow` `{path:[[x,y],...], period, offsets:[...], color, gap?:[y0,y1], tail?, when?}` packets looping along a polyline. Delivery count of all flows is `{packets}`.
- `tarrow` `{machine, i, from:[x,y], to:[x,y]}` dashed arrow for trigger `i` of a `triggers` machine; coloured and carrying a packet while that trigger is lit.
- `log` `{x, y, w, rows, padTop, padBottom, padLeft, title, titleX, titleW, cols:[{key:"time|who|m|g", x}]}`.

### Lines inside a box

A line is a string, or an object:
`{runs | t, c, b, align, indent, size, h, items, when, then, trigger}`
- `runs`: list of strings or run objects `{t | v | sw | cursor, c, b, size, when, then}`. `t` is text (may contain `{var}`), `v` a variable name, `sw` a colour swatch, `cursor` a blinking block. A run `v` that returns a coloured value uses its colour unless `c` is set.
- `items`: flex row `[{w?, grow?, ml?, align?, runs | bar}]`. `bar` is `{w, h, gauge: id}` (bound to a gauge machine) or `{w, h, segments:[{from,to,c}], mark?}` (fractions 0-1).
- `when` / `then`: condition `{var, eq|ne|in:[...]}` (a list of conditions = AND) and override `{c, b, bg}`. On a line the override applies to the whole row (e.g. highlight background); on a run it changes colour/weight.
- `trigger: [machineId, index]`: shortcut for a side-rail row bound to a triggers machine (`◇`/`◆` label, highlight).

## Machines (all pure functions of t)

| type | fields | variables |
| --- | --- | --- |
| `counter` | `start, rate, format:"comma"?, prefix?, suffix?` | `id` |
| `cycle` | `values:[string \| {t,m,g,...}], period, t0, order?, log?:{who,c}` | `id`, `id.i` (index), `id.<field>` |
| `gauge` | `values:[numbers], period, t0, seed, threshold, decimals?, high:{label,dest}, low:{label,dest}, log?:{who,c,msgs:[...],tail:"p={value} {label}"}` | `id`, `id.num`, `id.low` ("1"), `id.label`, `id.dest` |
| `any_low` | `of:[gaugeIds]` | `id` = "low" / "high" |
| `lane` | `period, run, off, busy, done:[...], phase?, spin?, log?:{who,c,msgs:[[text,tag]]}` | `id` (spinner + text, coloured), `id.state` |
| `triggers` | `period, on, t0, items:[{name, adv:[l1,l2], to?}], color, callsStart?, tokens?:{start,step,unit}, cps?, onText, offText, log?:{who,c,start:{m,g},end:{m,g}}` | `id.active` (index or -1), `id.label<i>`, `id.adv0`, `id.adv1` (typed), `id.calls`, `id.tokens`, `id.status`, `id.<item field>` |

Built-in variables: `{packets}` (deliveries so far), `{clock}`. Log templates may use item/gauge fields, e.g. `{name}`, `{value}`, `{label}`, `{dest}`.

## Replay hook

`window.seek(t)` draws the frame at second `t`. `window.__ready` becomes true when the config is loaded and fonts are ready; `window.__check()` returns a list of layout problems (used by `check_frames.py`). `?manual` in the URL disables the live loop.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall