CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

help

Think before typing. Root cause first, two candidate fixes, pick one, ask if still unclear, then change only the files the request needs. Edit the confidence bar and scope rules to fit the project. Use when a bug report comes in, when a previous fix did not work, or when the request is vague.

71

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 lean, well-structured skill body with concrete rules, explicit sequencing, and effective checklist gates. Its weaknesses are unresolved template placeholders in the confidence bar and protected-areas list, and a verification step that names the requirement without giving the reader a way to satisfy it.

Suggestions

Resolve the template placeholders before use — replace '[98]%' with the project's actual confidence threshold and fill in '[Add project specific protected areas: ...]' or delete the bracket, so the rules are executable as written.

Make the verification checklist item actionable: state how to verify (e.g. 'run the affected test or reproduce the reported behavior before claiming done') instead of only 'The fix was verified, not just written'.

Consider trimming the Convex rules section or moving it behind the existing `convex-*` skill pointer, since the one-liners ('Patch without reading when possible') largely restate what that skill covers.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence throughout — e.g. "Slow down for thirty seconds before the first edit. It saves an hour later." and "Never assume. A wrong assumption costs more than a question." No basic concepts are re-explained, and every section delivers rules rather than background. The checklist briefly restates earlier rules, but that is a deliberate pre-edit gate, not padding.

5 / 5

Actionability

Mostly executable guidance: concrete commands ("Dates from `git log --date=short`, never invented"), one-to-one field mapping rules, and an explicit checklist. However, unfilled template placeholders — "[98]%" in the confidence bar and "[Add project specific protected areas: admin dashboard, billing flow, etc.]" — are gaps a reader must resolve before the guidance is fully actionable, matching the 4 anchor's 'minor gaps' rather than fully copy-paste ready.

4 / 5

Workflow Clarity

The 'Reflect before acting' section gives a clear numbered 1–5 sequence with a stop-and-ask checkpoint, and two checklists ('Before the first edit', 'Before saying done') act as explicit gates. Not a 5 because verification is only asserted ("The fix was verified, not just written") with no how — no command, test invocation, or retry loop is given, leaving a minor validation gap.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and at this size the single-file structure is appropriate: clear section headers, terse overview-level rules, and clearly signaled one-level references to external skills ("Load the matching `convex-*` skill", "Load `git-safety` before any git command that could discard work") with no nested reference chains.

5 / 5

Total

18

/

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 that explicitly covers both capability and trigger conditions with natural user phrasing and concrete actions. Its only weaknesses are a few missing trigger synonyms and mild overlap risk from broadly applicable framing like "Think before typing".

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions covering the full workflow — "Root cause first, two candidate fixes, pick one, ask if still unclear, then change only the files the request needs" — plus a concrete setup action ("Edit the confidence bar and scope rules to fit the project"). Coverage is comprehensive, matching the anchor for multiple specific concrete actions rather than the 4 anchor's 'minor gaps in coverage'.

5 / 5

Completeness

It explicitly answers both what (the root-cause-first, two-candidate-fix, scoped-change workflow) and when ("Use when a bug report comes in, when a previous fix did not work, or when the request is vague") with concrete trigger phrases. Not the level below, because the 'when' clause is explicit and specific rather than weakly implied.

5 / 5

Trigger Term Quality

Triggers like "bug report", "previous fix did not work", and "request is vague" are phrases users would naturally say. However, common variations such as "regression", "still broken", or "the fix didn't work" are absent, which places it at good-but-not-comprehensive keyword coverage.

4 / 5

Distinctiveness Conflict Risk

"When a previous fix did not work" is a genuinely distinctive trigger, but the opening "Think before typing" and the trigger "when the request is vague" are broad enough to overlap with general careful-coding or planning skills. Mostly distinct with minor overlap risk rather than a clear niche.

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

waynesutton/convexskills

Path

templates/skills/help/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.