CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

i-have-adhd

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

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 TanStack/ai

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 behavioral skill body: dense, example-driven, and self-consistent (it practices its own brevity rules), with concrete Bad/Good pairs for all ten rules, explicit override conditions, and a closing validation checklist. The only structural note is that everything lives inline in a 134-line single file with no progressive disclosure, which is defensible for this skill type but keeps it off the top progressive-disclosure anchor.

DimensionReasoningScore

Conciseness

The body is lean and efficient throughout: five one-line cognitive facts, ten rules each with single-line Bad/Good pairs, and no padding or explanations of concepts Claude already knows (no "what ADHD is" primer). The slight overlap between rule 10's forbidden openers/closers and pre-send items 1-2 is operational reinforcement rather than duplication, since the pre-send checklist adds new nuance (keep hedges carrying real uncertainty, replace idioms literally). Every section earns its place, matching the anchor-5 example rather than the minor-trimming of anchor 4.

5 / 5

Actionability

For an instruction-only skill, absence of code is not penalized when guidance is actionable, and this guidance is fully concrete: every rule pairs a Bad and Good example with real commands, paths, and file:line references ('Run `npm install jsonwebtoken`, then edit `src/auth.ts:42`', 'Test fails at `auth.spec.ts:42`: expected 200, got 401'), and the pre-send check is a runnable five-item verification. Coverage of common cases (multi-step tasks, errors, option requests, destructive actions) is complete, matching anchor 5.

5 / 5

Workflow Clarity

This is a single-task skill (apply the rules to every response) with an unambiguous action, so the simple-skill provision applies: the single action is clear. The pre-send check provides an explicit validation gate with a pass condition ('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' serves as override/error-recovery guidance. No destructive or batch operations exist, so the validation cap does not apply.

5 / 5

Progressive Disclosure

Sections are well organized with clear headers (Persistence, What ADHD changes, Rules, When to break the rules, Pre-send check) and easy in-file navigation. However, at roughly 134 lines the file exceeds the under-50-line simple-skill carve-out and is entirely inline with no references or split of content, so it does not meet the anchor-5 pattern of content appropriately split across files. The monolithic structure is justifiable for a style filter that must be fully resident in context, placing it at 4 rather than lower.

4 / 5

Total

19

/

20

Passed

Description

73%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 concise, third-person description with excellent trigger clarity and explicit negative boundaries that make it highly distinguishable from other skills. Its main weakness is that the 'what' is thinner than the 'when' — it names the domain and one filtering role but not the concrete formatting capabilities the skill applies.

Suggestions

Add one or two concrete capability statements so the 'what' matches the 'when' in explicitness, e.g., 'Reformats responses to lead with the next action, number multi-step tasks, cap lists at 5, and restate progress each turn.'

Broaden trigger coverage with natural variations users with ADHD actually say, such as 'I can't focus', 'I keep getting distracted', or 'neurodivergent-friendly output', to catch users who never use the word ADHD.

DimensionReasoningScore

Specificity

The description names the domain ("ADHD-friendly output") and one or two concrete roles ("required writing filter by the docs skill", invoking /i-have-adhd), matching the anchor for naming the domain with 1-2 concrete actions but not comprehensive coverage. It does not list several specific capabilities (next-action-first formatting, numbered steps, capped lists), so it falls short of a 4, while being far more concrete than the generic anchor at 2. Voice is third person ("the user invokes"), so no person-penalty applies.

3 / 5

Completeness

Both what and when are explicitly present: the when-clause is highly specific with positive triggers and negative exclusions ("Don't use for marketing copy or after the user says 'stop adhd mode'"), exceeding the anchor-4 example's when. The what is present but thin ("ADHD-friendly output", "required writing filter") without naming what the formatting actually changes, so it falls short of the fully explicit what+when of anchor 5.

4 / 5

Trigger Term Quality

Triggers are natural phrases a user would literally say: "invokes /i-have-adhd", "says they have ADHD", "asks for ADHD-friendly output", plus the deactivation phrases "stop adhd mode" / "normal mode". Good keyword coverage with a few natural terms missing (e.g., "I can't focus", "distracted", "neurodivergent", "executive dysfunction"), which places it at 4 rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (ADHD-shaped output formatting) with distinct triggers: a named slash command, an explicit user statement trigger, and explicit exclusions (marketing copy, stop-phrases) that actively prevent mis-triggering. This matches the anchor for a clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

16

/

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

TanStack/ai

Path

.grok/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.