Nd complexity gate
Diagnosis-free neurodivergent support skills for AI coding agents, with executive-function scaffolds and always-on Claude/Codex behaviors.
npx -y skills add jpoindexter/nd-skills --skill nd-complexity-gateAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 23 days oldThe repository was created 23 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Detect complex or multi-step requests and suggest structured planning before acting. Prevents diving into implementation before the problem is understood.
SKILL.md
3.2 KB, as published. Nobody here has run it
Complexity Gate — Plan Before You Act
What this addresses
Planning and organization difficulty: for many neurodivergent developers, complex multi-part tasks can trigger one of two failure modes — paralysis (not knowing where to start) or premature execution (jumping to implementation before understanding the full scope, then having to restart).
Both are costly. The complexity gate catches requests that warrant a plan before any tool call.
When to apply
Apply this skill when a user request contains two or more of the following signals:
Scope signals:
- Mentions multiple files, components, or services
- Uses words like "refactor", "redesign", "rewrite", "migrate", "overhaul"
- References schema changes, database migrations, or API changes
- Implies work across multiple abstraction layers (frontend + backend + database)
Ambiguity signals:
- Contains phrases like "somehow", "not sure how", "figure out", "any way to"
- The spec is described in outcomes ("make it work") rather than mechanics
- Multiple possible interpretations exist
Compound-task signals:
- Two or more "and then" / "and also" clauses
- Mentions phases, steps, or parts
- Requires coordinating work that could conflict
Instructions
-
Score the request. Silently assess: how many complexity signals are present?
-
At 2+ signals and plan mode not active: Before any tool call, emit a one-line note:
"⚠ This looks complex ([N] signals). Consider planning the approach before executing —
/planmodeon, or I can outline steps first?"If the user already said "just do it," "use your judgment," "do not ask," or supplied a terminal condition, do not turn this note into a question. State that you are structuring the work internally and proceed.
-
If the user says 'outline steps': Produce a numbered execution plan with:
- Each step as a single, concrete, verifiable action
- Files or commands that will be touched
- The acceptance criterion for each step
- Ask "Does this plan look right, or should I adjust before starting?" only when approval of the plan is genuinely required. Otherwise begin the first safe unit.
Use
$nd-task-decompositionwhen dependencies are hidden or the user needs an executable Now/Next/Later surface rather than a high-level plan. -
Never block. If the user says "just do it", proceed immediately. The suggestion is a cognitive scaffold, not a gate.
-
When plan mode IS active: Skip the suggestion — the user already chose structured execution.
Science basis
Planning and organization are direct executive function components. For people with EF challenges, the blank-page problem is often most acute at the START of a complex task. A brief plan — even if modified — provides the scaffolding that makes initiation possible. The alternative (diving in without a plan) often leads to scope drift, rework, and the "I'll just start over" loop.
Environmental manipulation principle: structure the task environment so it's easier to start correctly than to restart.