CtrlK
BlogDocsLog inGet started
Tessl Logo

comparison-tool-design

Designing side-by-side comparison tools (plan-compare, product-compare, alternative-compare) that help users decide rather than just listing features. Axis selection, default-comparison logic, recommendation discipline. Honest about feature-list-dump (every feature in a row, no decision support), hidden-recommendation (biased comparison pretending to be neutral), and honest-comparison-with-guidance (genuine comparison plus opinionated recommendation) patterns. Triggers on comparison tool, plan compare, product compare, alternative compare, vs page, decision support tool. Also triggers when conversion through comparison stages is poor, when users are abandoning at the comparison step, or when a comparison tool is being scoped for the first time.

74

Quality

92%

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

85%

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

The body is a well-structured instruction-only playbook with strong progressive disclosure and a concrete, sequenced framework. Its main weakness is conciseness: the keystone framing is restated across multiple sections and some closing rhetoric could be trimmed without losing clarity.

Suggestions

Consolidate the feature-list-dump / hidden-recommendation / honest-comparison-with-guidance framing so it is defined once and referenced rather than restated in the intro, its section, and the closing.

Tighten the closing section ('The discipline is in the design choices...') which restates prior points rhetorically without adding new guidance.

Cite comparison-anti-patterns.md inline where its patterns are discussed, since it is listed in the Reference files section but never linked in the body.

DimensionReasoningScore

Conciseness

The ~250-line body restates the feature-list-dump / hidden-recommendation / honest-comparison-with-guidance framing in the intro, its own section, and the closing, and includes rhetorical restatement ('The discipline is in the design choices...'); mostly efficient domain guidance but could be tightened. Not level-3 because the repetition and conceptual setup pad tokens that don't all earn their place; not level-1 because the bulk is specific domain guidance rather than concepts Claude already knows.

2 / 3

Actionability

Gives concrete, specific directives: the 8-12 axis rule, literal recommendation phrasings ('For [audience], choose [option] because [reasons]'), named failure patterns with diagnoses, and a 12-consideration checklist — actionable instructional guidance per the code-vs-instruction note. Not level-2 because key details (axis counts, phrasing templates, decision criteria) are present rather than missing.

3 / 3

Workflow Clarity

Provides a clearly sequenced 12-consideration checklist with an explicit up-front gating decision (when comparison tools earn investment vs. when they do not), the analog of validation checkpoints for a design/audit skill. Not level-2 because the sequence and gating checkpoint are explicit, not implicit; the destructive/batch validation cap does not apply to this design playbook.

3 / 3

Progressive Disclosure

Each major section ends with a clearly signaled one-level-deep 'Detail in references/...' link, and a Reference files section lists all 9 files with one-line descriptions; all referenced files exist on disk. Not level-2 because references are well-signaled and content is appropriately split between inline overview and reference files.

3 / 3

Total

11

/

12

Passed

Description

100%

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 strong: it states concrete capabilities, lists explicit natural-language and behavioral triggers, answers both what and when, and occupies a distinct niche. Voice is appropriately third-person (gerund 'Designing'), so no voice penalty applies.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities (axis selection, default-comparison logic, recommendation discipline) plus three named patterns, matching the 'lists multiple specific concrete actions' anchor; not a level-2 'some actions' case because the actions are specific and enumerated.

3 / 3

Completeness

Clearly answers both what ('Designing side-by-side comparison tools...') and when (explicit 'Triggers on...' and 'Also triggers when...' clauses), matching the both-what-and-when anchor; not level-2 because the when is explicit, not implied.

3 / 3

Trigger Term Quality

'Triggers on comparison tool, plan compare, product compare, alternative compare, vs page, decision support tool' gives good coverage of natural terms a user would say, plus behavioral triggers; not a level-2 because common variations are present rather than missing.

3 / 3

Distinctiveness Conflict Risk

A clear niche (comparison tools) with distinct triggers unlikely to fire for sibling growth-tooling skills; not level-2 because the triggers are specific to comparison work rather than broadly overlapping.

3 / 3

Total

12

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
rampstackco/claude-skills
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.