CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rerun-blueprint

Change how the Rerun viewer looks by writing a blueprint, for a recording or for a table. Read this whenever asked to change the look of the viewer, such as laying out a recording or dataset, designing a default blueprint, deciding which views show which entities, or making a segment or catalog table look nice by hiding columns, changing column order or filtering rows. Covers archetype-to-view mapping, layout reasoning, the rrb construction API, the contents grammar, table blueprints, and the screenshot loop.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A high-quality, information-dense skill body: a five-step workflow with real validation and retry loops, runnable code for the main paths, and disciplined avoidance of padding. The two gaps are minor: undefined variables in the table example, and reference-grade table/frame detail inlined in the main file rather than split out.

Suggestions

In the TableBlueprint example, show how `path` and `dataset` are obtained (e.g., a temp file path and the dataset handle) so the snippet is copy-paste ready.

Consider moving the table-blueprint path-escaping rules and the named-coordinate-frame troubleshooting into a references/ file, keeping SKILL.md as a leaner overview with clearly signaled one-level-deep links.

Add a short code or command example for component overrides (colors/colormaps) since the section currently points only to the external MCP docs.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — 'The constructors are discoverable (dir(rrb), help(rrb.Spatial3DView)); this skill covers what you can't guess' — with no padding or explanation of concepts Claude already knows. Nearly every line carries non-obvious, project-specific detail (mode semantics, reference-integrity rules, store-identity binding), matching the 'every token earns its place' anchor.

5 / 5

Actionability

Mostly executable: complete, runnable examples for blueprint construction, the ViewerClient screenshot loop, dataset schema enumeration, and concrete MCP call shapes ('rerun_set_blueprint with {"table": {}, "mode": "partial"}'). It falls short of 5 because the TableBlueprint snippet references undefined variables ('blueprint.save("my_app", path)', 'dataset.register_blueprint(path.as_uri(), ...)') without showing how path or dataset are obtained — a minor but real copy-paste gap.

4 / 5

Workflow Clarity

A clear numbered sequence (1. Read the data → 5. Iterate from screenshots) with explicit validation checkpoints — 'verify state before assessing screenshots', 'After each write, check the views and their reports in rerun_get_state, plus logs' — and an error-recovery feedback loop ('If the structure differs, inspect rerun_get_blueprint before retrying') plus a final screenshot check before reporting completion. This matches the top anchor including the retry loop.

5 / 5

Progressive Disclosure

Good structure with clearly signaled one-level external references (MCP docs for component overrides and table blueprints, the table-layout howto, and a 'See also' section for sibling skills), and no bundle files exist so nothing is misfiled. It is not 5 because a single ~240-line file inlines fairly deep reference-grade material — table column path-escaping rules and the named-coordinate-frame troubleshooting — that would fit a reference file under a leaner overview.

4 / 5

Total

18

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete actions on both recording layouts and table columns, an explicit 'Read this whenever' trigger clause with varied natural phrasings, and a tightly scoped niche. The only gap is that some capabilities covered in the body (color/colormap overrides, component overrides) lack corresponding trigger phrases.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Change how the Rerun viewer looks by writing a blueprint', 'laying out a recording or dataset', 'hiding columns, changing column order or filtering rows' — and enumerates topic coverage (archetype-to-view mapping, rrb construction API, contents grammar, table blueprints, screenshot loop). This matches the anchor for comprehensive coverage of specific concrete actions; it is not 4 because both recording-layout and table-column use cases are covered with actionable verbs.

5 / 5

Completeness

It explicitly answers both questions: what ('Change how the Rerun viewer looks by writing a blueprint, for a recording or for a table') and when ('Read this whenever asked to change the look of the viewer, such as...') with concrete trigger phrases. This is a direct match for the top anchor; the 4 anchor's 'when could be more explicit' does not apply given the enumerated examples.

5 / 5

Trigger Term Quality

Natural phrases users would say are well covered: 'change the look of the viewer', 'laying out a recording or dataset', 'hiding columns', 'changing column order', 'filtering rows'. It falls short of the 5 anchor because a few natural asks are missing as triggers — e.g. changing colors/colormaps (a whole body section) and 'arrange the panels/views' — but coverage is clearly above the midpoint.

4 / 5

Distinctiveness Conflict Risk

The 'Rerun viewer' blueprint niche is clear and the triggers are scoped to visual appearance and table layout, keeping it distinct from sibling skills like rerun-data-model or rerun-catalog-queries. Minimal conflict risk matches the 5 anchor; it is not 4 because the scope boundary is explicit rather than merely implied.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

rerun-io/rerun

Path

skills/rerun-blueprint/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.