tesserae-benchmarking

Measure Tesserae rendering cost and verify layout changes with Playwright-driven benchmarks.

53|8|Updated Oct 24, 2019
One-click install
npx skills add https://github.com/curiosity-ai/tesserae --skill tesserae-benchmarking-curiosity-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tesserae-benchmarking
Source: https://github.com/curiosity-ai/tesserae/tree/main/.claude/skills/tesserae-benchmarking
Command: npx skills add https://github.com/curiosity-ai/tesserae --skill tesserae-benchmarking-curiosity-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When optimizing the Tesserae UI toolkit or changing a layout container, component, or stylesheet, you need to prove two things: that the change actually reduced build or rendering cost, and that it did not alter what the user sees. Naive pixel or geometry diffs produce misleading results, and this Skill provides the correct measurement and comparison methodology. ## Core Features & Use Cases - CPU profiling and attribution: Capture CDP CPU profiles of the Tesserae.Bench harness app, analyze self and inclusive time by function and file, and walk the call tree to attribute hot frames to the responsible component. - A/B build comparison: Interleave benchmark runs of two builds, take best-of measurements, and honestly report build-cost wins versus session wall-clock noise. - Rendering verification gates: Choose the right comparison method per change type — geometry comparison, text-run diffing across 131 gallery samples, or pixel diffing with visual diff images — and establish a noise floor via self-comparison. - Use Case: After removing a wrapper element from Stack layout, run textdiff-samples.js against both builds to confirm text runs did not move horizontally, then use inspect.js to attribute any remaining differences to a specific CSS property. ## Quick Start Ask the AI to benchmark the current Tesserae build against the previous one and verify that the layout change did not alter rendering.

Frequently Asked Questions about tesserae-benchmarking

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

FAQPage Schema
How do I benchmark a Tesserae build for performance?▼

Run bench.js against the served Tesserae.Bench app to capture a CDP CPU profile, then use analyze.js to get self and inclusive time by function and file. For A/B comparisons, interleave runs of both builds and take best-of values rather than the mean.

How do I verify a CSS or layout change did not break rendering?▼

Use textdiff-samples.js to compare text-run positions across all 131 gallery samples between the two builds. Work the X/W differences to zero, review Y shifts, then confirm the worst pages visually with diffimg.js.

Which comparison method should I use for a DOM structure change?▼

Use textdiff-samples.js when a change adds, removes, or re-parents elements, because text content stays comparable regardless of tree shape. Geometry comparison breaks in this case, and pixel diffing only suits repaint-only changes like colors or shadows.

Why does the pixel diff report differences on an unchanged build?▼

Some samples generate random colors, print live clocks, or lay out asynchronously, so they always differ. Establish the noise floor by capturing the same build twice and diffing those captures before trusting any percentage.

Why is my benchmark serving stale files after a rebuild?▼

The build replaces the output directory, so an http-server started in the old one keeps serving deleted inodes. Restart the server and confirm with curl that tss.css contains your new styles before diffing.