CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

i-have-adhd

Shape output for an ADHD reader: next action first, numbered steps, no tangents. Trigger: /i-have-adhd.

69

Quality

87%

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

The canonical home for this skill is i-have-adhd in ayghri/i-have-adhd

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally well-crafted instruction-only skill. Every rule is concrete with bad/good contrast pairs, the pre-send checklist provides an explicit validation loop, and edge cases (override conditions, harness conflicts) are systematically covered. The only minor cost is a slightly redundant ADHD-cognition preamble.

DimensionReasoningScore

Conciseness

The body is lean overall — every rule uses compact bad/good example pairs — but has minor trimmable instances: 'Five facts drive every rule below' spends 11 lines on ADHD cognition Claude broadly already knows, and 'Vague estimates fail' is stated verbatim in both the facts section and Rule 6. This matches anchor 4 (minor over-explanation that could be trimmed), not 5, and is well above 3 since the padding is marginal.

4 / 5

Actionability

Fully concrete and executable for an instruction-only skill: enumerated forbidden phrases ('Great question,' 'Let me...'), a specific error-reporting format ('Test fails at `auth.spec.ts:42`: expected 200, got 401. Cause: missing auth header. Fix: add `Authorization: Bearer ${token}`'), concrete time estimates ('About 15 minutes if tests already cover this'), and a copy-paste-able pre-send checklist. This matches the top anchor for instruction skills; nothing remains vague.

5 / 5

Workflow Clarity

A single-purpose skill whose action is unambiguous, with an explicit validation checkpoint: the 'Pre-send check' section is a 5-item deletion checklist plus a final verification loop ('if the reader reads only the first line and the last line, do they know (a) what to do next, and (b) what just happened? If yes, send.'), and 'When to break the rules' enumerates edge cases including harness conflicts. Meets the simple-skill exception and the feedback-loop bar; not scored lower because no destructive/batch validation gap applies.

5 / 5

Progressive Disclosure

The skill is self-contained: no bundle files exist, no references are cited, and content is organized into clear H2/H3 sections (Rules, When to break the rules, Pre-send check) with no nesting. Splitting rules into reference files would harm a skill whose rules must be in context every turn, so the single-file structure with well-organized sections fully satisfies the simple-skill guidance.

5 / 5

Total

19

/

20

Passed

Description

78%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: concrete, third-person, and honest about scope, with explicit slash-command trigger guidance suited to its disable-model-invocation setting. It falls short of the top scores only on coverage — several of the skill's ten rules and common user phrasings around ADHD/brevity are not surfaced in the one-line summary.

Suggestions

Fold in one or two more of the skill's distinctive behaviors to close the coverage gap, e.g. '...no tangents, concrete time estimates, matter-of-fact error reports' to lift specificity toward 5.

Add natural synonyms a user might actually say — 'distracted', 'overwhelmed', 'step by step', 'keep it short' — alongside 'ADHD' to broaden trigger-term coverage.

Slightly expand the 'when' clause beyond the slash command, e.g. 'Use when the reader says they have ADHD, is easily overwhelmed by long output, or asks for step-by-step instructions.'

DimensionReasoningScore

Specificity

'Shape output for an ADHD reader: next action first, numbered steps, no tangents' names the domain and three concrete behaviors. Anchor 4 ('lists several specific actions; minor gaps in coverage') fits: the skill's ten rules include behaviors the description omits (concrete time estimates, matter-of-fact error tone, 5-item list cap, pre-send checks), so it is not comprehensive (5), but it exceeds the 1-2 actions of anchor 3.

4 / 5

Completeness

The 'what' is clear and concrete ('Shape output for an ADHD reader: next action first, numbered steps, no tangents'), and explicit trigger guidance exists ('Trigger: /i-have-adhd'), so the missing-trigger cap of 3 does not apply. However, the 'when' is terse — appropriate for a disable-model-invocation slash-command skill, but it could be more specific about when a user should invoke it. Matches anchor 4 ('both what and when; when could be more explicit or specific'), not 5.

4 / 5

Trigger Term Quality

'ADHD' is the core natural keyword a user would say, and 'numbered steps' and 'tangents' are natural phrasings. A few natural terms users might say are missing ('distracted,' 'overwhelmed,' 'keep it short,' 'step by step'), matching anchor 4 ('good keyword coverage; a few natural terms missing') rather than 5's synonym/variation coverage, and clearly above 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche — output shaping for an ADHD reader — with a distinct trigger ('Trigger: /i-have-adhd'). No other skill category (formatting libraries, document tools, general brevity) would plausibly fire on these triggers, so conflict risk is minimal, matching anchor 5.

5 / 5

Total

17

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

YoizenSA/dev-ai-workflow

Path

ywai/skills/i-have-adhd/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.