Agent skill

Adhd

by UditAkhourii in UditAkhourii/adhd

Parallel divergent ideation for coding agents. An agent skill from UditAkhourii/adhd.

MITAuto-check passedProductivity & Automation

Install Adhd

skills CLI
$ npx skills add UditAkhourii/adhd --skill adhd -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install UditAkhourii/adhd adhd --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/UditAkhourii/adhd.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/adhd .claude/skills/adhd && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
adhd
GitHub stars
4.4k
Token cost
~2.8k tokens
SKILL.md length
1,600 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Parallel divergent ideation for coding agents. An agent skill from UditAkhourii/adhd.

  • Works in 2 steps: Diverge (no critic) → Focus (critic on)
  • Tasks that involve Focus and ADHD support
  • SKILL.md covers Pre-flight (run before Phase 1), The loop, Frames and Output shape, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Adhd is an agent skill from UditAkhourii/adhd. Parallel divergent ideation for coding agents. Spawns N isolated branches under different cognitive frames (regulator, biology, speedrunner, 10-year-old, $0 budget), scores, clusters, prunes traps, and deepens top survivors. Use on /adhd, "ADHD mode", brainstorm/ideate intents, or open-ended design, architecture, naming, API/SDK surface, and fuzzy-debugging decisions. Skip for syntax, lookups, bugs with known root cause, or closed phrasing ("quick", "standard", "canonical", "textbook"). Full pre-flight gate is in…

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Focus and ADHD support and Brainstorming. It works with Claude Agent SDK, TypeScript and Node.js. The repository describes itself as: ADHD — a skill for coding agents. Tree-of-thought with pruning, built on the Claude & Codex Agent SDK. Fans out parallel divergent thoughts under different cognitive frames… The licence is MIT.

When your agent uses it

  • Tasks that involve Focus and ADHD support
  • Tasks that involve Brainstorming

Example prompts

  • “ADHD mode”
  • “standard”
  • “canonical”
  • “/adhd”

Requirements

  • Node.js

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Diverge (no critic)
  2. Focus (critic on)

What it can do on your machine

Read from SKILL.md and the folder at commit 7b91ce6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Adhd loads about 2.8k tokens when it runs. Until then it costs about 135 tokens; SKILL.md has 1,600 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~135
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from UditAkhourii/adhd at commit 7b91ce6, republished under its MIT licence (© UditAkhourii). 1,600 words, ~2,777 tokens.

Download SKILL.mdSave it as .claude/skills/adhd/SKILL.md (or your agent's skills folder).
name
adhd
description
Parallel divergent ideation for coding agents. Spawns N isolated branches under different cognitive frames (regulator, biology, speedrunner, 10-year-old, $0 budget), scores, clusters, prunes traps, and deepens top survivors. Use on /adhd, "ADHD mode", brainstorm/ideate intents, or open-ended design, architecture, naming, API/SDK surface, and fuzzy-debugging decisions. Skip for syntax, lookups, bugs with known root cause, or closed phrasing ("quick", "standard", "canonical", "textbook"). Full pre-flight gate is in the skill body.
license
MIT

ADHD

Stop picking the textbook answer. The first three answers the model would give are the answers a senior engineer would give in thirty seconds. Correct. Forgettable. The interesting answers live past number three, in the awkward middle nobody walks into. This skill makes the model walk there.

Pre-flight (run before Phase 1)

This skill is expensive. About 10 Agent calls, 30 to 90 seconds wall clock, 5 to 10x a single answer. Do not pay that cost when a direct answer is better. Run this gate before Phase 1.

Step 1. Explicit invocation check.

If the user typed /adhd or explicitly asked for ADHD mode, "use the adhd skill", or "run ADHD on this", SKIP the rest of this section and go straight to Phase 1. The user opted in. Do not second-guess.

Step 2. Self-judge (only if Step 1 did not match).

Ask yourself three questions. If the answer to any is no, ABORT.

  1. Open-ended? Would a senior engineer give multiple viable answers here, or is there one canonical answer? If canonical, abort.
  2. High-stakes? Is the cost of the obvious answer being wrong actually high? Architecture decisions, public API surfaces, naming a real product, fuzzy bugs with no known root cause, schema design = yes. Side project at 11pm = no.
  3. Open phrasing? Did the user avoid words like "quick", "standard", "canonical", "textbook", "just", "one-line"? If they used any of those, they want the direct answer. Abort.

If all three checks pass, proceed to Phase 1.

If any fails, ABORT and answer the question directly. Optionally append one sentence: "If you want a wider exploration under parallel cognitive frames with explicit trap detection, run /adhd <your problem>."

The loop

Two strict phases. Mixing them kills idea quality, because the critic strangles the generator.

Phase 1 — Diverge (no critic)

For the problem P:

  1. Pick 5 cognitive frames from the table below. Bias toward engineering tags when the problem is code-shaped. Always include at least one wild frame to keep range.

  2. Spawn 5 parallel Agent/Task tool calls. One per frame. Each Agent gets only:

    • the problem P
    • any context the user provided
    • the chosen frame's vantage prompt
    • a system instruction that forbids evaluation

    The exact instruction to give each Agent:

    You are in DIVERGENT mode. You are a generator, not a critic. Generate 6 short distinct ideas under this frame. Each idea is one phrase or one sentence. Do not evaluate. Do not rank. Do not hedge. The first three obvious answers everyone would give are banned. Push past them into the awkward middle. Output a JSON array only. No prose before or after. [{"text": "...", "rationale": "..."}, ...]

  3. Critical invariant. The Agent calls must be parallel and isolated. Do NOT serialize them. Do NOT pass one branch's output as context to another. Branches that see each other anchor each other and the whole method collapses to a wider single thought.

Phase 2 — Focus (critic on)

After all branches return:

  1. Score. Rate each idea on three axes 0 to 10: novelty (distance from the obvious default), viability (could it actually ship), fit (does it address the stated problem). For any idea that looks attractive but is a trap (hidden cost, false economy, will not scale, premature abstraction), flag it with a one-line reason.

  2. Cluster. Group ideas into 3 to 6 clusters by their underlying angle, not by surface keywords. Label clusters by angle: "remove the server plays", "cache-shaped plays", "batched-window plays", "race-multiple- backends plays".

  3. Deepen the top 3. Rank by weighted score (novelty 0.35 + viability 0.40 + fit 0.25), exclude traps, take top 3. For each, spawn one Agent call that produces:

    • a 4 to 8 sentence sketch of how the idea works
    • the load-bearing risk
    • the first concrete step a builder would take
    • 3 to 5 child ideas (variations, hybrids, unlocks)

    Deepen Agent instruction:

    You are in FOCUS mode. Take one promising idea and connect dots. Sketch how it would actually work in 4 to 8 sentences. Name the load-bearing risk. Name the first concrete step a coder would take. Then generate 3 to 5 sub-ideas that branch off (variations, combinations with other domains, things this unlocks). Output JSON only.

Frames

Pick 5 per run.

FrameVantage promptTags
hardware engineerYou think in latency, memory layout, and physical constraints. Re-ask this as a hardware/firmware problem. What does the bus topology, cache, timing budget tell you?code, wild
regulatorYou audit systems for compliance and failure modes. What must be provable, traceable, or refusable here?design, general
10-year-oldYou are a curious 10 year old who has never seen software. Describe naive but unencumbered approaches. Ignore convention.general, wild
competitor trying to break itYou are a hostile competitor or attacker. Generate approaches that exploit, fail, or sabotage the obvious solution. Then invert into ideas.code, design
biologyTransplant a mechanism from biology (immune systems, neural plasticity, cell signaling, evolution, gut flora). Force-fit it onto this engineering problem.code, wild
logisticsSteal mechanisms from logistics: queues, batching, just-in-time, hub-and-spoke, returns, last-mile. Apply them literally.code, design
game designApproach this as a game designer. What are the loops, rewards, friction, save-states, speedrun tricks? Treat the user as a player.design, general
marketsTreat the problem as a market. Buyers, sellers, market-makers. What does an auction, a futures contract, a clearing house look like here?design, wild
inversionAsk the OPPOSITE question. If goal is X, brainstorm how to guarantee NOT X. Then negate each answer back.code, design, general
extreme: $0 budget, 1 hourNo money, no team, one hour. What is the crudest version that still does the load-bearing thing?code, general
extreme: infinite budget, 10 yearsInfinite compute, infinite engineers, a decade. What is the maximalist version?design, wild
remove the load-bearing assumptionName the thing everyone treats as fixed (framework, database, request-response model, network). Imagine it is gone. What is possible?code, design, wild
speedrunnerYou are a speedrunner. Find glitches, skips, out-of-bounds tricks, frame-perfect shortcuts. What is the abusive-but-legal path?code, wild
ant colonyNo central planner. Many dumb agents, local rules, pheromone trails. How does the problem solve itself emergently?code, wild
3am on-callYou are the on-call engineer woken at 3am when this breaks. What design would let you not get paged?code, design
Show full SKILL.md (548 more words)Show less
Picking frames

For code-shaped problems: pick 4 frames tagged code or design, plus 1 tagged wild. For open product or strategy problems: a mix from all tags. Vary the picks across sessions so the same problem produces different candidate sets when re-run.

Output shape

After Phase 2, render in this order. Do not collapse it into a wall of prose. The structure is the point.

  1. Brief. One or two lines confirming the problem and any reframe used.
  2. Wide set. Full pool grouped by cluster. Each cluster labeled by underlying angle. Each idea is one short phrase. Show score chips like [N7 V8 F9] next to each.
  3. Converge. A 2 to 4 idea shortlist. State why each is on the list. Mark the non-obvious-but-viable pick explicitly with ★. List traps separately, each with the one-line reason it is a trap.
  4. Focus. The 3 deepened branches. For each: the sketch, the load- bearing risk, the first concrete step, and the child ideas.
  5. Provocation. One wildcard question or idea that opens a new direction the user can push into if nothing landed.

Anti-patterns

These are how this skill goes wrong. Watch for them.

  • Convergence disguised as divergence. Ten minor variations of one idea is not breadth. If every candidate shares the same underlying assumption, you have not diverged. You have decorated.
  • Weird-for-weird's-sake with no convergence. A pile of 30 unsorted absurdities is as useless as one safe answer. Always converge.
  • Walls of equally-weighted prose. Cluster, label, pull out the best. Structure is half the value.
  • Refusing to commit. After diverging, take a position on what is actually promising. "Here are 20 ideas, you decide" is a cop-out. Generate wide, but converge with a real opinion.
  • Skipping the isolation invariant. If you simulate parallel branches by writing them sequentially in one context, you have not done ADHD. You have done a wider single thought. The Agent/Task tool gives each branch a fresh context. Use it.

Calibration

  • How many ideas? Scale to stakes. Quick "name this function" = 3 frames × 4 ideas. "How should I position this product" = 5 frames × 8 ideas. Default is 5 × 6 = 30.
  • How weird? Read the room. Serious strategy work: flag the wild cards clearly so they do not read as unserious. Open brainstorming or play: let it run loose. Absurd ideas earn their place by seeding viable ones.
  • When to stop diverging? Stop when new candidates start repeating the shape of existing ones. The space is mapped. Do not pad to hit a number.

Cost

5 diverge + 1 score + 1 cluster + 3 deepen ≈ 10 Agent calls per run. About 5 to 10x a single-shot answer. Not for every keystroke. For decision points where the cost of the obvious answer is high.

Companion library and CLI

There is a Node/TS implementation that does the same loop with structured JSON parsing, score weighting, and a CLI. Use it when running outside Claude Code or in batch.

npm install -g adhd-agent
adhd "your problem here"

Code, paper, evals, and contributing guide at https://github.com/UditAkhourii/adhd. The skill above gives you the same loop inside Claude with no install required.

Source spec

This skill operationalises a written spec on divergent ideation. The original prose is preserved in SOURCE-SPEC.md for reference. The implementation choices made here (parallel isolated Agent calls, mechanical generator/critic split, frame-based branching) follow from that spec.

© UditAkhourii, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/adhd of UditAkhourii/adhd.

Open the folder on GitHubat commit 7b91ce6

Compare with similar skills

Adhd next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Adhd compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Adhd this skillUditAkhourii/adhd4.4k—~2.8kAutomated safety check: PassMIT
Iconify Iconsoomol-lab/open-flow230—~850Automated safety check: PassApache-2.0
Brightdata SDK JSbrightdata/skills264—~3kAutomated safety check: PassMIT
Open Supermarketsabracadabra50/open-supermarkets1171 repos~1.4kAutomated safety check: PassMIT
Sentry Node SDKgetsentry/sentry-for-ai268—~8.4kAutomated safety check: PassApache-2.0
Javascript SDKaiskillstore/marketplace4301 repos~3.3kAutomated safety check: PassNone

Similar skills

  • Iconify Icons

    oomol-lab/open-flow

    Search local Iconify JSON and use UnoCSS icon classes in the Open Flow repository.

    230 GitHub stars~850 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Brightdata SDK JS

    brightdata/skills

    Web data extraction and discovery using the Bright Data JavaScript/TypeScript SDK (@brightdata/sdk).

    264 GitHub stars~3k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Open Supermarkets

    abracadabra50/open-supermarkets

    Searches, compares and fills baskets across supermarkets in several countries, with delivery slots, checkout and nutrition data, as a CLI, MCP server or skill.

    117 GitHub starsUsed in 1 repo~1.4k tokens
    Productivity & AutomationAuto-check passed
  • Sentry Node SDK

    getsentry/sentry-for-ai

    Official

    Full Sentry SDK setup for Node.js, Bun, and Deno. An agent skill from getsentry/sentry-for-ai.

    268 GitHub stars~8.4k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Javascript SDK

    aiskillstore/marketplace

    JavaScript/TypeScript SDK for inference.sh - run AI apps, build agents, integrate with all models.

    430 GitHub starsUsed in 1 repo~3.3k tokens
    Backend & APIsAuto-check passed
  • Adhd

    prassanna-ravishankar/repowire

    Parallel divergent ideation via mesh fan-out. An agent skill from prassanna-ravishankar/repowire.

    265 GitHub stars~2.3k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

Questions about Adhd

What does Adhd do?

Parallel divergent ideation for coding agents. An agent skill from UditAkhourii/adhd. Adhd is an agent skill from UditAkhourii/adhd. Parallel divergent ideation for coding agents.

When should I use Adhd?

Adhd fits situations like: tasks that involve Focus and ADHD support; tasks that involve Brainstorming.

How do I install Adhd in Claude Code?

Run `npx skills add UditAkhourii/adhd --skill adhd -a claude-code`. Or copy the skill folder (skills/adhd in UditAkhourii/adhd) into .claude/skills/adhd in your project. Claude Code loads it when a task matches its description.

How do I install Adhd in Codex?

Run `npx skills add UditAkhourii/adhd --skill adhd -a codex`. Or copy the skill folder (skills/adhd in UditAkhourii/adhd) into .agents/skills/adhd in your project. Codex loads it when a task matches its description.

Can I use Adhd in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add UditAkhourii/adhd --skill adhd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adhd, .gemini/skills/adhd, .github/skills/adhd and .opencode/skills/adhd in your project.

What does Adhd need to run?

SKILL.md names no scripts, command-line tools or credentials: Adhd is instructions for the agent only. Our summary lists: Node.js.

Does Adhd access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Adhd safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Adhd use?

Adhd is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Adhd use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Adhd?

Skills that share tags, products or a category with Adhd: Iconify Icons (oomol-lab/open-flow, 230 stars), Brightdata SDK JS (brightdata/skills, 264 stars), Open Supermarkets (abracadabra50/open-supermarkets, 117 stars) and Sentry Node SDK (getsentry/sentry-for-ai, 268 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Adhd?

UditAkhourii (a GitHub user) maintains it in UditAkhourii/adhd, which has 4,371 GitHub stars. The repository was last updated on October 5, 2026.

Source: UditAkhourii/adhd on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.