visualize-littleman-run

Render Littleman .man executions as SVG/PNG snapshots with movement and stall heatmaps.

1|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/d-experts/public-icfpc-2026 --skill visualize-littleman-run-d-experts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: visualize-littleman-run
Source: https://github.com/d-experts/public-icfpc-2026/tree/main/.agents/skills/visualize-littleman-run
Command: npx skills add https://github.com/d-experts/public-icfpc-2026 --skill visualize-littleman-run-d-experts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Littleman programs are spatial, tick-driven boards where performance problems hide in blank-cell commutes, FIFO pipe latency, and stalled runners; reading raw source or numeric logs makes it hard to see where ticks are actually spent. This Skill renders an execution snapshot as an image with exact movement and stall heatmaps so optimization decisions are grounded in observed behavior. ## Core Features & Use Cases - Exact heatmap rendering: Replays a chosen tick window one step at a time to produce precise movement and stall heatmaps, plus runner trails, pipe token positions, and per-room activity counts. - Watched-cell diagnostics: Records before/after runner state (position, direction, A, B, backpack) when runners cross selected cells, supporting decisions about conditional turns on shared lanes. - Use Case: While optimizing an LLLM candidate, render the baseline and the modified program at the same case, tick, and window, then compare the images and JSON hot-cell counts to confirm that a layout change removed a cross-bank commute before submitting through the team judge. ## Quick Start Ask the agent to render the current best .man file for the little-little-little-man case "one tick at a time" at tick 100000 with a 512-tick window and inspect the generated heatmap image for optimization opportunities.

Frequently Asked Questions about visualize-littleman-run

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

FAQPage Schema
How do I visualize a Littleman program execution as an image?▼

Run the bundled render-run.mjs script from the repository root with the .man file, a --problem and --case (or --input), a --tick for the snapshot, and a --window for the exact replay range. It writes an SVG, a PNG when a converter is available, and a JSON report.

How do I find performance hotspots in a Littleman program?▼

Render a checkpoint with a window of 256-1024 ticks and inspect the heatmap: yellow-to-red cells are useful movement, magenta strips are blank-cell commutes, and purple outlines mark stalls. The JSON report also lists per-room activity, pipe occupancy, and the hottest exact cells.

What do the heatmap colors mean in the rendered snapshot?▼

Yellow-to-red cells indicate executed movement hotspots, magenta marks movement across blank cells, purple outlines mark stalls, cyan squares are tokens in pipe cells, and colored circles with trails show final runner positions and recent paths.

Does the renderer work without the LLLM public cases?▼

Yes. Omit --case and pass --input with raw input text, plus --frames-json for expected display frames when needed. The --case option only works with the little-little-man and little-little-little-man public-case adapters.

Why is the exact replay window limited to small tick ranges?▼

Jumping to the window start is batched, but the window itself is replayed one tick at a time to keep movement and stall counts exact, which is slow for large ranges. Use --window 0 for a fast state-only image or keep windows around 256-1024 ticks.

Can I track runner state when it crosses specific board cells?▼

Yes, pass --watch with semicolon-separated x,y coordinates. The JSON watchEvents field records each crossing with the runner's position, direction, A, B, and backpack before and after the tick, which helps decide whether a conditional turn can distinguish flows on a shared lane.