CtrlK
BlogDocsLog inGet started
Tessl Logo

reproducible-analysis

Machine-readable journal format for reproducible data analysis operations

64

Quality

75%

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

100%

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

The content is a well-structured, highly actionable specification with concrete schemas, executable examples, and explicit verification workflows including validation checkpoints and error-recovery loops.

DimensionReasoningScore

Conciseness

The body is dense and task-specific (exact field schemas, MCP tool names, JSONL examples, an integration table) with no padding explaining concepts Claude already knows; every section earns its tokens.

3 / 3

Actionability

It provides concrete executable guidance: exact JSONL entry examples, precise field types, specific tool names like `mcp__qsv__qsv_stats`, shell hash commands, and a full bash replay script that is largely copy-paste ready.

3 / 3

Workflow Clarity

The Journal Lifecycle (init/during/complete) and the Verification Protocol for humans/agents/CI give clear sequences with explicit validation checkpoints (recompute input/output SHA-256, flag mismatch and stop) and error-recovery feedback loops.

3 / 3

Progressive Disclosure

The skill is a single self-contained file with no bundle files and clear, well-organized section headers (Core Principle, Journal Format, Lifecycle, Verification, Integration, Best Practices); per the rubric's simple-skill note, well-organized sections merit a 3 when no external references are needed.

3 / 3

Total

12

/

12

Passed

Description

50%

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 is concise and names a concrete, fairly niche artifact, but it omits any explicit "when to use" trigger guidance and relies on technical phrasing over natural user keywords.

Suggestions

Add an explicit trigger clause, e.g. "Use when running reproducible data analyses, auditing analysis provenance, or when the user asks for a verifiable/auditable record of data operations."

Surface natural user keywords such as "reproducibility", "audit trail", "provenance", "data pipeline", and "verification" so the skill triggers on common phrasings.

Reframe around actions ("maintain", "verify", "replay") rather than only naming the format, to strengthen specificity.

DimensionReasoningScore

Specificity

"Machine-readable journal format for reproducible data analysis operations" names a concrete artifact (journal format) and its domain, but describes a single thing rather than listing multiple specific actions.

2 / 3

Completeness

It answers "what" (a journal format for reproducible analysis) but provides no "Use when..." trigger clause, so per the rubric guideline completeness is capped at 2.

2 / 3

Trigger Term Quality

Phrases like "reproducible data analysis" are reasonably natural, but the description relies on technical phrasing ("machine-readable journal format") and lacks common trigger variations a user would actually say.

2 / 3

Distinctiveness Conflict Risk

The reproducibility-journal niche is fairly distinct, but "data analysis operations" is broad enough to overlap with general data-analysis skills and the absence of explicit triggers weakens distinctiveness.

2 / 3

Total

8

/

12

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
dathere/qsv
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.