CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rerun-parquet

Ingest tabular Parquet files into Rerun chunk streams with rerun.experimental.ParquetReader. Read when converting trajectory or sensor tables (LeRobot-style parquet, exported logs) into entities and components — column grouping, timeline/index columns, static columns, and lenses (DeriveLens) that assemble the typed components (Transform3D, Scalars) from the reader's grouped struct/scalar output. Builds on rerun-chunk-processing and rerun-data-model.

Quality

90%

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

82%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, dense reference for the ParquetReader API with executable examples and concrete validation semantics. The main weaknesses are redundancy between the main sections and the Gotchas list, and the absence of an explicit ordered workflow with feedback loops.

Suggestions

Deduplicate the Gotchas list against the main sections: gotchas 3, 5, 6, and 9 restate the static-columns error, prefix-stripped field names, /__properties drop, and no-pandas-munging advice already covered above — keep each gotcha to the failure symptom and a one-line pointer instead of restating the full rule.

Add a short ordered workflow section (map columns via rerun-data-model -> configure stream() with index/static columns -> construct lenses -> apply with output_mode -> drop /__properties) so the sequence readers must follow is explicit rather than implied by section order.

Move the lens builder table and selector grammar detail into a references/ file (e.g., references/lens-builders.md), keeping SKILL.md to the end-to-end example plus a pointer, to slim the ~245-line body.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence (no padding about what parquet is or how libraries work), but the Gotchas section repeats body material nearly verbatim: the static-column error appears twice, and the '/__properties' drop, prefix-stripping rule, and 'no pandas munging' advice each appear in both a main section and a gotcha. This fits the 'efficient; minor instances that could be trimmed' anchor rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Guidance is fully executable: a complete stream() call with every keyword argument, a builder table with argument orders, and two copy-paste-ready examples with imports (end-to-end Transform3D, Points3D via to_packed_component) covering the common cases. This matches the top anchor.

5 / 5

Workflow Clarity

The sequence is present and stated ('fill in the rerun-data-model mapping table first, then express it through stream()'), and validation behavior is explicit (config validated against the file's schema at stream(), ValueError raised eagerly for missing columns). It falls short of the top anchor because there is no explicit ordered workflow or validate-fix-retry loop; it stays above score 3 because checkpoints (eager validation, lazy static-column error as data-quality signal) are described rather than absent.

4 / 5

Progressive Disclosure

There are no bundle files, but the body is well-sectioned and the References section gives clearly signaled, one-level-deep pointers (SDK source paths, integration test files, sibling skills) with no nested references. It matches 'good structure; most content appropriately placed' — the lens builder table and selector grammar could arguably live in a separate reference file given the ~245-line body, keeping it below the top anchor, but nothing is buried or inline that clearly belongs elsewhere.

4 / 5

Total

17

/

20

Passed

Description

96%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 with a clear third-person 'what' statement, an explicit 'Read when' trigger clause, rich synonym coverage, and concrete named APIs. The only weakness is mild overlap risk with the sibling Rerun skills it references, which share much of its trigger vocabulary.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Ingest tabular Parquet files into Rerun chunk streams', 'column grouping, timeline/index columns, static columns', and 'lenses (DeriveLens) that assemble the typed components (Transform3D, Scalars)' — with comprehensive coverage of the skill's capabilities, matching the anchor for multiple specific concrete actions. It exceeds the score-4 anchor because coverage is comprehensive rather than having minor gaps.

5 / 5

Completeness

It explicitly answers both questions: what ('Ingest tabular Parquet files into Rerun chunk streams with rerun.experimental.ParquetReader') and when ('Read when converting trajectory or sensor tables (LeRobot-style parquet, exported logs) into entities and components') with concrete trigger phrases. Score 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural user vocabulary is covered with synonyms for both format and data type: 'Parquet files', 'parquet', 'tabular', 'trajectory or sensor tables', 'LeRobot-style parquet', 'exported logs'. This matches the comprehensive-coverage anchor; the only missing variation is the '.parquet' file extension, which the anchor-4 example's thinner coverage does not fit better.

5 / 5

Distinctiveness Conflict Risk

The parquet-to-Rerun ingestion niche is clear, but the description shares trigger vocabulary ('rerun', 'chunks', 'components', 'lenses') with the closely related skills it names (rerun-chunk-processing, rerun-data-model), creating minor overlap risk. It is not score 5 because those sibling skills could plausibly compete for the same Rerun-centric queries, though the role division is delineated.

4 / 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-parquet/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.