attention-control
Air traffic control discipline for agent output, written for a reader with ADHD: action first, one meaning per word, state restated every turn.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/aaddrick-attention-control)HTML
<a href="/listings/aaddrick-attention-control"><img src="/api/listings/aaddrick-attention-control/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
<details open> <summary><strong>Claude Code</strong></summary>
Claude Code is the only agent here with a native output style slot. Run these two commands in your terminal:
claude plugin marketplace add aaddrick/attention-control
claude plugin install attention-control@attention-control
Then run `/config`, select **Output style**, and pick **Attention Control**. It takes effect after `/clear` or the next session.
To skip the picker, add `outputStyle` to `~/.claude/settings.json`. It is a top-level key. It does not go inside `env`, `permissions`, or any other block:
{
"model": "opus",
"env": { "EXAMPLE_VAR": "1" },
"outputStyle": "Attention Control"
}`model` and `env` stand in for keys you may already have. Keep them. Add the `outputStyle` line beside them.
For one session instead of every session, use the skill the plugin also ships:
/attention-control:attention-control
Say "stop attention control" to turn it off.
</details>
<details> <summary><strong>Codex</strong></summary>
Codex has no output style slot, so the rules ship as a skill.
codex plugin marketplace add aaddrick/attention-control --ref main
codex plugin add attention-control@attention-control
Inside Codex, `/plugins` opens the plugin browser instead.
Start a new thread, then type the skill:
$attention-control:attention-control
Codex prefixes a plugin skill with the plugin name. Say "stop attention control" to turn it off. For every turn instead, put the always-on snippet from [INSTALL.md](./INSTALL.md#the-always-on-snippet) in `~/.codex/AGENTS.md`.
</details>
<details> <summary><strong>Cursor, Gemini CLI, Copilot, Zed, and manual install</strong></summary>
See [INSTALL.md](./INSTALL.md). None of them has an output style slot, so the rules ship as a skill, a rules file, or an `AGENTS.md` block. On a skill route, type `/attention-control` and say "stop attention control" to turn it off.
</details>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 24 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "$schema": "https://www.schemastore.org/claude-code-marketplace.json",
- "name": "attention-control",
- "description": "Air traffic control discipline for agent output, written for a reader with ADHD: action first, one meaning per word, state restated every turn.",
- "owner": {
- "name": "aaddrick",
- "url": "https://github.com/aaddrick"
- },
- "plugins": [
- {
- "name": "attention-control",
- "description": "Output style that shapes every response for a reader with ADHD and writes each sentence in controlled English.",
- "source": "./",
- "category": "productivity",
- "keywords": [
- "adhd",
- "output-style",
- "accessibility",
- "simplified-technical-english",
- "productivity"
- ]
- }
- ]
- }
README.md · README · 293 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <p align="center">
- <img src=".github/assets/hero.png" alt="Attention Control: air traffic control discipline for agent output, written for a reader with ADHD. Two flight progress strips. The unstyled reply overruns a single box and falls off the edge. The Attention Control reply splits into four fields: ACTION, EDIT, STATE, NEXT." width="100%">
- </p>
- <p align="center">
- <strong>Attention Control</strong><br>
- <em>Air traffic control discipline for agent output.</em><br>
- <em>Written for a reader with ADHD.</em>
- </p>
- <p align="center">
- <a href="LICENSE"><img src="https://img.shields.io/github/license/aaddrick/attention-control?style=flat" alt="License"></a>
- <a href=".github/workflows/plugin-load-check.yml"><img src="https://img.shields.io/github/actions/workflow/status/aaddrick/attention-control/plugin-load-check.yml?label=plugin%20loads&style=flat" alt="Plugin load check"></a>
- </p>
- <p align="center">
- <a href="https://www.linkedin.com/in/aaddrick/">Connect on LinkedIn!</a>
- </p>
- <p align="center">
- <strong>English</strong> ·
- <a href=".github/readme/README.zh-CN.md">简体中文</a> ·
- <a href=".github/readme/README.ja.md">日本語</a> ·
- <a href=".github/readme/README.ko.md">한국어</a> ·
- <a href=".github/readme/README.vi.md">Tiếng Việt</a> ·
- <a href=".github/readme/README.pt-BR.md">Português (BR)</a>
- </p>
- ## Install
- <details open>
- <summary><strong>Claude Code</strong></summary>
- Claude Code is the only agent here with a native output style slot. Run these
- two commands in your terminal:
- ```bash
- claude plugin marketplace add aaddrick/attention-control
- ```
- ```bash
- claude plugin install attention-control@attention-control
- ```
- Then run `/config`, select **Output style**, and pick **Attention Control**. It
- takes effect after `/clear` or the next session.
- To skip the picker, add `outputStyle` to `~/.claude/settings.json`. It is a
- top-level key. It does not go inside `env`, `permissions`, or any other block:
- ```json
- {
- "model": "opus",
- "env": { "EXAMPLE_VAR": "1" },
- "outputStyle": "Attention Control"
- }
- ```
- `model` and `env` stand in for keys you may already have. Keep them. Add the
- `outputStyle` line beside them.
- For one session instead of every session, use the skill the plugin also ships:
- ```
- /attention-control:attention-control
- ```
- Say "stop attention control" to turn it off.
- </details>
- <details>
- <summary><strong>Codex</strong></summary>
- Codex has no output style slot, so the rules ship as a skill.
- ```bash
- codex plugin marketplace add aaddrick/attention-control --ref main
- ```
- ```bash
- codex plugin add attention-control@attention-control
- ```
- Inside Codex, `/plugins` opens the plugin browser instead.
- Start a new thread, then type the skill:
- ```
- $attention-control:attention-control
- ```
- Codex prefixes a plugin skill with the plugin name. Say "stop attention control"
- to turn it off. For every turn instead, put the always-on snippet from
- [INSTALL.md](./INSTALL.md#the-always-on-snippet) in `~/.codex/AGENTS.md`.
- </details>
- <details>
- <summary><strong>Cursor, Gemini CLI, Copilot, Zed, and manual install</strong></summary>
- See [INSTALL.md](./INSTALL.md). None of them has an output style slot, so the
- rules ship as a skill, a rules file, or an `AGENTS.md` block. On a skill route,
- type `/attention-control` and say "stop attention control" to turn it off.
- </details>
- ## What it does
- Air traffic control phraseology exists for one reason: a distracted human under
- load will mishear an instruction. Aviation solved this with two disciplines.
- Controlled vocabulary makes each word mean one thing. Fixed message shape puts
- the instruction first and the background last.
- This style applies both disciplines to your coding agent. The agent leads with
- the action you can run, and writes each sentence so one word means one thing.
- The style targets one reader: a reader with ADHD. That reader is where the shape
- rules come from. See [Why the shape rules exist](#why-the-shape-rules-exist).
- ## What changes
- <table>
- <tr>
- <td width="50%">
- ### Before
- > Great question! Let me take a look. It seems like the auth flow has a few
- > moving pieces here. Looking at `src/auth.ts`, the token verification logic
- > could possibly be utilizing a deprecated API — the `verifyToken` function
- > around lines 42-58 has been implemented against an older `jsonwebtoken`
- > signature. One approach that might be considered would be updating the
- > package and refactoring that function. By the way, your dependency versions
- > in general could probably use a review at some point. Hope this helps! Let me
- > know if you'd like me to dig deeper into any of this.
- </td>
- <td width="50%">
- ### After
- > Run `npm install jsonwebtoken@latest`.
- >
- > I changed `src/auth.ts:47`. `verifyToken` now names the algorithm:
- >
- > `jwt.verify(token, secret, { algorithms: ["HS256"] }, callback);`
- >
- > Run `npm test -- auth.spec.ts`. It takes about 10 seconds.
- >
- > The old call named no algorithm. `jsonwebtoken` v9 rejects an unsigned token
- > unless you pass `algorithms: ["none"]`.
- >
- > Next: paste the first failing line if a test fails.
- </td>
- </tr>
- </table>
- ## The two layers
- **Shape** decides what you say and in what order. 11 rules:
- 1. Lead with the next action.
- 2. Do the work you own.
- 3. Number multi-step work.
- 4. End with one concrete next action.
- 5. Suppress tangents.
- 6. Restate state every turn.
- 7. Give time estimates in concrete units.
- 8. Show what now works.
- 9. State errors flat.
- 10. Cap lists at 5 items.
- 11. No preamble, no recap, no closer.
- **Language** decides how each sentence reads. The short version:
- - One word, one meaning. One action, one verb. No rotating synonyms.
- - Standard verbs: "check", "make sure", "start", "stop", "use", "show", "find", "change", "remove", "need".
- - Active voice. Name the actor.
- - Simple tenses only. No perfect tense, no auxiliary stacks.
- - 20 words per instruction, 25 per explanation. Noun clusters capped at 3 words.
- Full text: [`output-styles/attention-control.md`](./output-styles/attention-control.md).
- ## Why the shape rules exist
- Five facts about ADHD reading drive all 11 shape rules. Each fact below names
- the rules it produces.
- | The fact | What the agent does |
- |---|---|
- | **Working memory is small.** Anything not on screen is gone. | It never writes "keep in mind X". It restates the state every turn: "Step 3 of 5 done: I changed the schema. Next: run `scripts/backfill.py`." (rules 6, 10) |
- | **Knowing the answer is not doing the answer.** Work dies in the gap between the two. | It does the work it owns instead of handing it back. It gives the command, not the label. "Add the missing header" is a label. `Authorization: Bearer ${token}` is a fix. (rules 1, 2, 3) |
- | **Starting is the hardest step.** | The first line is small, obvious, and doable now. The last line names one action that takes under two minutes. "Open the file" counts. (rules 1, 4) |
- | **Time estimates feel uniform.** "A bit of work" and "a few hours" register the same. | It writes "about 15 minutes if tests cover this, an afternoon if not". It never writes "some work". (rule 7) |
- | **Dopamine is scarce.** A buried win does not register. | After a change, it names the result in concrete terms: "Login works with magic links. Run `npm run dev` and open `/login`." (rule 8) |
- Two more rules protect attention itself. Rule 5 suppresses tangents, so one open
- thread stays one open thread. Rule 11 removes the preamble and the closer, so
- the answer starts on line 1.
- This is why the style is not "be terse". Terseness that drops the command, the
- number, or the condition costs the reader a round trip, and a round trip costs
- the thread. Rule 9 follows from the same logic: an error gets a location, a
- cause, and a fix, with no "Uh oh" in front of it. Alarm is not information, and
- it competes with the information for the same attention.
- You need no ADHD diagnosis for this to help. A tired reader, a reader on a
- phone, and a reader with 40 open tabs all read the same way.
- ## What it leaves alone
- Four targets, one rule each. Code, commands, file paths, identifiers, and error
- messages stay verbatim. Quoted text stays verbatim. Code comments and commit
- messages match the style of the repository around them. Only the prose the agent
- writes itself follows this style.
- Those are instructions, not a lock. An output style is system prompt text, and
- nothing outside the model enforces it. Treat the boundary as a strong default,
- and check the output when it matters.
- Accuracy beats brevity. A rule never removes a fact, a number, a condition, or a
- scope qualifier. A hedge that carries real uncertainty stays.
- ## Evals
- The harness compares response quality against an unstyled baseline. It does not
- measure length.
- ```bash
- python3 scripts/run_evals.py validate
- ```
- ```bash
- python3 scripts/run_evals.py plan --trials 3
- ```
- 24 cases, 6 scored dimensions, and a release gate that blocks a candidate that
- regresses correctness or safety.
- The judge is the weak point, so the harness targets it. `blind` hides the
- condition and balances the positions. The judge scores every group twice with
- the order reversed, then reports how often the two passes disagree. The runner
- runs in an empty directory and reads none of your config. Design notes and the
- measurements behind them: [evals/README.md](./evals/README.md).
- ## Tune it
- Fork, edit `output-styles/attention-control.md`, then regenerate every
- agent-specific copy:
- ```bash
- python3 scripts/sync_style.py
- ```
- Swap your copy in, one command at a time:
- ```bash
- claude plugin uninstall attention-control
- ```
- ```bash
- claude plugin marketplace remove attention-control
- ```
- ```bash
- claude plugin marketplace add <your-username>/attention-control
- ```
- ```bash
- claude plugin install attention-control@attention-control
- ```
- ## Credits
- This style combines two existing works. Neither author takes part in this
- project.
- **Shape layer:** [`i-have-adhd`](https://github.com/ayghri/i-have-adhd) by
- Ayoub G. (MIT). The eval harness derives from the same project.
- **Language layer:** the
- [`asd-ste100` output style](https://gist.github.com/L1nefeed/4164ecaaf77879e76dca3c06f142f1c2)
- by [L1nefeed](https://github.com/L1nefeed), itself a condensation of
- [ASD-STE100](https://www.asd-ste100.org/) Simplified Technical English, Issue 9.
- This project reproduces no text from the ASD specification. The ASD does not
- certify, endorse, or sponsor it. Details in [NOTICE.md](./NOTICE.md).
- ## License
- MIT. See [LICENSE](./LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.