CtrlK
BlogDocsLog inGet started
Tessl Logo

investigate-puffin

Investigate Puffin profiler recordings (.puffin files), find slow scopes, and compare before/after traces using the `rerun dump-puffin` command and bundled analysis helpers.

66

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/investigate-puffin/SKILL.md
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 highly actionable, well-sequenced profiling skill with executable recipes and explicit validation checkpoints; its only real weakness is that the referenced helper scripts are missing from the bundle.

Suggestions

Ship the referenced find_scopes.py and compare_traces.py in a scripts/ directory so the in-body invocations actually resolve.

Consider moving the peripheral 'How traces are captured' capture guidance into a short reference file to tighten the main workflow.

DimensionReasoningScore

Conciseness

Dense with executable recipes and largely free of re-explaining concepts Claude already knows; the 'How traces are captured' section and some Rerun-specific capture details are somewhat peripheral and could be trimmed, so it is not 5.

4 / 5

Actionability

Provides copy-paste-ready jq recipes and concrete python helper invocations that cover the common investigation cases (slowest scopes, per-thread totals, comparison, prefix search).

5 / 5

Workflow Clarity

Clear Setup -> Investigate -> Compare -> Analyze -> Cross-check sequence with explicit validation checkpoints (check '.scopes | length', dump per-call durations to sanity-check deltas, check registration on both traces) and feedback loops for missing scope registration; read-only so the destructive-cap does not apply.

5 / 5

Progressive Disclosure

Well-structured with clearly signaled one-level-deep references to helper scripts, but the referenced bundle files (find_scopes.py, compare_traces.py) are not present in the bundle, a minor organization gap that keeps it below 5.

4 / 5

Total

18

/

20

Passed

Description

70%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 specific, well-targeted description with concrete actions and strong distinctiveness, but it omits any explicit 'when to use' trigger guidance, capping completeness at 3.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user is profiling an app with Puffin, mentions .puffin files, or wants to compare before/after performance traces.'

Add a synonym or two (e.g. 'profiling', 'performance trace') to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'find slow scopes', 'compare before/after traces', 'using the rerun dump-puffin command and bundled analysis helpers' — matching the 'several specific actions; minor gaps' anchor; not 5 because coverage is not exhaustive and not 3 because it goes beyond 1-2 actions.

4 / 5

Completeness

The 'what' is clear (investigate recordings, find slow scopes, compare traces) but there is no 'Use when...' clause or equivalent explicit trigger guidance, so per the rubric completeness is capped at 3.

3 / 5

Trigger Term Quality

Includes natural domain terms a user would say — 'Puffin profiler recordings', '.puffin files', 'slow scopes', 'before/after traces' — giving good keyword coverage; not 5 because it lacks synonym/extension variants.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear, narrow niche (Puffin profiler, .puffin files, rerun dump-puffin) with distinct triggers and minimal overlap with other skills.

5 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
rerun-io/rerun
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.