CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

qsv-performance

Performance guide covering index files, stats cache, and frequency cache accelerators for qsv

Quality

71%

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/qsv-performance/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is a lean, well-organized reference: dense comparison tables, a concrete size-based decision tree, and specific commands with explicit thresholds. Its only real gaps are minor redundancy across sections and the absence of any complete copy-paste command examples, which keep actionability and conciseness just below top marks.

DimensionReasoningScore

Conciseness

The body is dense with tables, a decision tree, and terse rules, with no padding or explanations of concepts Claude already knows (Parquet gets only a six-word "columnar format" gloss, which is justified). Minor redundancy — "index first" and the Polars >100MB rule each appear in multiple sections — keeps it at anchor 4 rather than anchor 5's "every token earns its place".

4 / 5

Actionability

Concrete commands and flags throughout (`qsv stats --cardinality --stats-jsonl`, `slice --len N`, `frequency --limit N`, `--output file.csv`, "sqlp with ORDER BY LIMIT instead of sort") with explicit thresholds ("> 100MB", "> 10MB"). It falls short of anchor 5's copy-paste-ready full invocations — no complete command line with an input file is shown — so anchor 4 ("mostly executable; concrete commands with minor gaps") fits.

4 / 5

Workflow Clarity

The "Large File Decision Tree" provides a clearly sequenced, size-gated workflow, and each accelerator carries an explicit ordering rule ("Always run `index` first if you'll run 2+ commands"; "Run stats ... before using any smart command"). No validation checkpoints are present, but none are required for read/analysis operations — the destructive/batch cap does not apply — and the missing feedback loops keep it below anchor 5.

4 / 5

Progressive Disclosure

The body is well-sectioned (accelerators → memory classes → decision tree → tips → concurrency → timeouts) with no buried or nested references; it references no external files and the bundle contains none. Good structure with no navigation issues matches anchor 4; the under-50-line exception that would allow a 5 does not apply to this ~110-line body.

4 / 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 is concise and names its niche clearly, anchored by the specific "qsv" domain and three named accelerators. Its main weaknesses are the absence of any 'when to use' trigger guidance (capping completeness at 3) and the lack of action verbs or natural trigger phrases users would say.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when qsv commands are slow, when processing large CSV files, or before running multiple qsv commands on the same file.'

State what the skill does with action verbs, not just what it covers, e.g. 'Speeds up qsv workflows by selecting the right accelerator and command for a file's size.'

Include natural trigger terms users would say — 'slow', 'large CSV', 'speed up' — alongside the technical accelerator names.

DimensionReasoningScore

Specificity

The description names the domain (qsv) and three concrete accelerator components ("index files, stats cache, and frequency cache"), but contains no actions — it says what the guide covers, not what the skill does. Anchor 3 (names domain with limited concrete content) fits better than 4, which expects several specific actions.

3 / 5

Completeness

A clear 'what' is present ("Performance guide covering index files, stats cache, and frequency cache accelerators"), but there is no 'when' — no 'Use when...' clause or any trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Contains some relevant keywords ("performance", "index files", "qsv") but misses the natural phrases a user would actually say when needing this skill, such as "slow", "large CSV", or "speed up". Keyword coverage is present but missing common variations, matching anchor 3 rather than 4.

3 / 5

Distinctiveness Conflict Risk

"for qsv" gives it a clear niche with minimal conflict risk against non-qsv skills, but as a bare performance guide with no distinct triggers it has minor overlap risk with a general qsv skill — the "mostly distinct; minor overlap risk" of anchor 4 rather than anchor 5's distinct triggers.

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