CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reproducible-analysis

Machine-readable journal format for reproducible data analysis operations

Quality

72%

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 ./.claude/skills/skills/reproducible-analysis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 strong, disciplined body: executable examples, explicit validation checkpoints, and genuine feedback loops around a clearly sequenced lifecycle. Its two weaknesses are the placeholder replay/hashing logic, which undercuts actionability at the exact point verification matters most, and the monolithic inline structure that a small references/ bundle would relieve.

Suggestions

Move the optional-fields table, the per-command integration matrix, and the replay script into a references/ file (e.g., references/journal-schema.md and references/replay.sh), keeping SKILL.md as a lean overview with clearly signaled one-level-deep links.

Replace the '# tool-specific replay logic here # ...' placeholder in replay-journal.sh with actual re-execution and output-hash verification logic, or explicitly justify why it must be tool-specific.

Give the real qsv hashing command in 'How to Compute Hashes' (the '# Via qsv sqlp (for CSV content hash)' comment currently provides no executable instruction), and note that 'shasum' is macOS-specific vs. 'sha256sum' on Linux.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — it never explains what JSON, SHA-256, or CSV hashing are — and every section (schema, lifecycle, verification, integration) earns its place. Minor trimmable spots remain: the 'How to Compute Hashes' section contains a placeholder comment ('# Via qsv sqlp (for CSV content hash)') that conveys little, and the fallback fingerprint example duplicates the required-fields table.

4 / 5

Actionability

Concrete guidance dominates: a full entry schema table, two complete JSONL entry examples, and an explicit lifecycle with init/complete entries. It falls short of 5 because the core of the machine replay script is a placeholder ('# Re-execute and verify output hash (tool-specific replay logic here) # ...') and the qsv-based hashing command is never actually given — the single most important verification operation is left as pseudocode.

4 / 5

Workflow Clarity

The journal lifecycle is explicitly sequenced (init → log each step after completion → complete), and the verification protocols include explicit checkpoints with error recovery: 'If mismatch, flag the step and stop', 'Log failures too... log both attempts (the failure with an error field, then the successful retry)', and 'Record the entry after the operation completes'. Human, agent, and CI verification paths are each spelled out step by step.

5 / 5

Progressive Disclosure

The ~186-line body is well-sectioned with clear headers, but no bundle files exist and content that plausibly belongs in references is inlined: the full optional-fields table, the per-command integration table for eight /data-* commands, and the bash replay script. This matches 'some structure but... content that should be separate is inline' better than level 4, which expects the bulk of detailed material split out.

3 / 5

Total

16

/

20

Passed

Description

53%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.

The description communicates a concrete and distinctive concept but is phrased as a passive noun phrase with no 'when to use' trigger guidance and limited natural trigger vocabulary. Adding an explicit 'Use when...' clause with user-facing trigger phrases and synonyms would substantially improve it.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user asks for reproducibility, an audit trail, or verification of a data analysis, or when logging data operations for later replay.'

Include natural synonyms and file extensions users would say — 'reproducibility', 'audit trail', 'replicate/verify an analysis', '.journal.jsonl' — to broaden trigger coverage.

Convert the noun phrase into third-person action verbs, e.g., 'Maintains a machine-readable journal of every data operation so analyses can be independently replayed and verified.'

DimensionReasoningScore

Specificity

The description names the domain ('reproducible data analysis operations') and one concrete artifact ('machine-readable journal format'), but is a single noun phrase with no enumerated actions. It is above the bare 'names the domain' level (2) because 'machine-readable journal' conveys a concrete mechanism, but well below level 4-5, which require several specific listed actions.

3 / 5

Completeness

The 'what' is clear (maintain a machine-readable journal of data operations for reproducibility), but there is no 'when' — no 'Use when...' clause or equivalent trigger guidance, which the rubric explicitly caps at 3. It is not level 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

'journal', 'reproducible', and 'data analysis' are relevant keywords, but common natural variations users would say are missing: 'reproducibility', 'audit trail', 'verify', 'replicate', and the '.jsonl' extension. This matches 'some relevant keywords but missing common variations or synonyms' rather than level 4's 'a few natural terms missing'.

3 / 5

Distinctiveness Conflict Risk

The reproducibility-journal niche is a clear, distinctive concept with minimal conflict risk, though it could overlap with general data-analysis skills (e.g., /data-* commands) that also touch reproducibility. 'Mostly distinct; minor overlap risk with closely related skills' fits better than 5, since the description never states its scope boundary.

4 / 5

Total

13

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dathere/qsv

Path

.claude/skills/skills/reproducible-analysis/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.