CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-designer

Design new Claude skills from structured idea specifications. Use when the skill auto-generation pipeline needs to produce a Claude CLI prompt that creates a complete skill directory (SKILL.md, references, scripts, tests) following repository conventions.

Quality

86%

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

78%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-structured, lean skill body: copy-paste-ready commands drive a clearly sequenced workflow, and the bundle's reference files are properly disclosed with accurate one-line descriptions. The main gaps are the abstract validation step (no concrete reviewer command or threshold) and the absence of an error-recovery loop if output validation fails.

Suggestions

Make Step 4 concrete: give the actual command to run the dual-axis reviewer (e.g., the exact script invocation) and state the numeric score threshold that constitutes a pass.

Add a short feedback loop after Step 4 — what to do when validation fails (fix frontmatter and re-run, or regenerate the prompt), so the workflow closes the loop like Steps 1–3 do.

Trim the redundancy between the Overview, When-to-Use, and frontmatter description, and drop zero-information lines like "No external API keys required".

DimensionReasoningScore

Conciseness

The body is efficient — terse Prerequisites, numbered script behavior, and command blocks with no padding or explanation of concepts Claude already knows. It falls short of anchor 5 only because the Overview and When-to-Use sections partially restate the frontmatter description, and marginal lines like "No external API keys required" could be trimmed.

4 / 5

Actionability

The core operations are fully executable: two copy-paste-ready bash invocations with complete argument lists, plus documented exit codes ("Exit code 0 on success, 1 if required reference files are missing"). Not anchor 5 because Step 4's validation is abstract — "Score with dual-axis-skill-reviewer meets threshold" gives no command or threshold value, leaving a minor gap.

4 / 5

Workflow Clarity

Steps 1–4 are clearly sequenced (prepare input → build prompt → pipe to claude -p → validate output) with a dedicated validation step naming three checkpoints. It misses anchor 5 because there is no feedback loop: nothing says what to do when validation fails (e.g., regenerate, fix frontmatter, re-run the reviewer).

4 / 5

Progressive Disclosure

The Resources section gives a clear overview with well-signaled, one-level-deep references — each of the three reference files and the build script is listed with a one-line description, and all four paths resolve to real bundle files. Content that belongs in separate files (structure guide, quality checklist, template) is indeed split out, matching anchor 5.

5 / 5

Total

17

/

20

Passed

Description

87%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 concrete capabilities with enumerated deliverables, includes an explicit 'Use when…' trigger clause, and carves out a distinct niche in the skill-generation pipeline. The only weakness is that trigger phrasing is pipeline-centric, so a developer manually asking to 'scaffold a new skill' might not match it.

DimensionReasoningScore

Specificity

The description names concrete actions — "Design new Claude skills from structured idea specifications", "produce a Claude CLI prompt that creates a complete skill directory (SKILL.md, references, scripts, tests)" — enumerating specific artifacts. It stops short of anchor 5 because capabilities the body actually covers (validation against the reviewer, prompt-builder script) are absent, leaving minor gaps in coverage.

4 / 5

Completeness

Both questions are explicitly answered: the "what" ("Design new Claude skills from structured idea specifications") and a concrete "when" ("Use when the skill auto-generation pipeline needs to produce a Claude CLI prompt that creates a complete skill directory"). This matches the anchor-5 pattern of a clear action statement followed by an explicit 'Use when…' trigger phrase; it is above anchor 4, where the 'when' would be implicit or underspecified.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Design new Claude skills", "idea specifications", "skill directory", "SKILL.md", "Claude CLI prompt". Not anchor 5 because common user phrasings like "scaffold", "create", or "bootstrap a new skill" are missing, and some terms lean toward internal pipeline jargon.

4 / 5

Distinctiveness Conflict Risk

The niche is narrow and specific — generating design prompts for the skill auto-generation pipeline from JSON idea specs — with triggers unlikely to fire for unrelated skills. Minor overlap with generic skill-creation skills exists, but the pipeline framing keeps conflict risk minimal, matching anchor 5 rather than anchor 4's 'minor overlap risk with closely related skills'.

5 / 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/skill-designer/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.