CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dual-axis-skill-reviewer

Review skills in any project using a dual-axis method: (1) deterministic code-based checks (structure, scripts, tests, execution safety) and (2) LLM deep review findings. Use when you need reproducible quality scoring for `skills/*/SKILL.md`, want to gate merges with a score threshold (for example 90+), or need concrete improvement items for low-scoring skills. Works across projects via --project-root.

Quality

88%

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 well-built operational skill body: fully executable commands, a clear four-step workflow with cross-project and reproducibility controls, and genuine one-level-deep references to real bundle files. Weaknesses are minor — some path repetition, no explicit validation checkpoint for the LLM JSON before merging, and under-signaled references.

Suggestions

State the reviewer script path once (e.g., only in the Workflow intro) and have the Installation section reference it instead of repeating the full path three times.

Add a validation checkpoint in Step 2 or 3, e.g. 'Verify the LLM JSON parses and follows references/llm_review_schema.md before merging; re-ask if fields are missing or malformed.'

Annotate the Resources references with what each contains and when to read it (e.g., 'LLM schema: read before producing the Step 2 JSON — references/llm_review_schema.md').

DimensionReasoningScore

Conciseness

The body is efficient — no concept explanations Claude already knows, and every section carries operational content (commands, flags, output paths). It sits at 4 rather than 5 because of minor trimmable repetition: the reviewer script path is stated three times (Workflow bullets, the bash comment block, and the Installation section), and the Resources section partially restates scoring behavior already implied by the workflow.

4 / 5

Actionability

Every step ships copy-paste-ready commands with real flags ('uv run "$REVIEWER" --project-root . --emit-llm-prompt --output-dir reports/'), concrete output filenames, and specific weight arguments. Even the orchestration-oriented Step 2 gives exact instructions (read the generated prompt file, return strict JSON, save for merge), matching the score-5 'fully executable' anchor rather than 4, which would require minor gaps.

5 / 5

Workflow Clarity

Steps 1-4 are clearly sequenced with commands per step, plus an Optional Controls section. It is 4 rather than 5 because there are no explicit validation checkpoints (e.g., 'verify the LLM JSON matches the schema before merging' would be a natural one) — Step 2 only says 'Ask the LLM to return strict JSON output' without a verify/retry loop.

4 / 5

Progressive Disclosure

The body is a well-organized overview with one-level-deep references to real bundle files ('LLM schema: references/llm_review_schema.md', 'Rubric detail: references/scoring_rubric.md') and the script path, all of which exist. It is 4 rather than 5 because the references appear only as bare paths at the bottom without signaling what each contains or when to read it, and the skills-index output explanation is inline where a pointer could serve.

4 / 5

Total

17

/

20

Passed

Description

88%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: it states the dual-axis mechanism concretely, gives an explicit 'Use when' clause with three concrete trigger scenarios, and anchors itself to a recognizable file pattern and workflow (merge gating). The only gaps are a few missing natural synonyms (audit/evaluate) and slight generic-trigger overlap with general review skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with the mechanisms behind them: 'deterministic code-based checks (structure, scripts, tests, execution safety)', 'LLM deep review findings', 'reproducible quality scoring', 'gate merges with a score threshold (for example 90+)', and 'concrete improvement items for low-scoring skills'. This matches the score-5 anchor ('lists multiple specific concrete actions; comprehensive coverage') and exceeds the score-4 anchor because coverage of the review, scoring, gating, and improvement outputs is comprehensive rather than having minor gaps.

5 / 5

Completeness

It explicitly answers 'what' ('dual-axis method: (1) deterministic code-based checks ... and (2) LLM deep review findings') and 'when' ('Use when you need reproducible quality scoring ..., want to gate merges with a score threshold ..., or need concrete improvement items'). Both are concrete and explicit, matching the score-5 anchor exactly; it is clearly not the score-4 anchor where the 'when' could be more specific.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: 'review skills', 'quality scoring', 'score threshold', 'gate merges', 'improvement items', plus the concrete path 'skills/*/SKILL.md'. It falls at score 4 rather than 5 because common synonyms like 'audit', 'evaluate', or 'lint skills' are absent, so a few natural trigger terms are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — scoring skills under 'skills/*/SKILL.md' with merge gating and a 90+ threshold — so it is 'mostly distinct'. It stops short of score 5 because the generic word 'review' and 'quality' phrasing creates minor overlap risk with general code-review or quality skills unless the user mentions skills specifically.

4 / 5

Total

18

/

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

tradermonty/claude-trading-skills

Path

skills/dual-axis-skill-reviewer/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.