my-adhd-caveman
ADHD shape + caveman diction for Gemini CLI: action first, numbered terse steps, fewer tokens.
Open source Open in the app JSON README (API)
About
ADHD shape + caveman diction for Gemini CLI: action first, numbered terse steps, fewer tokens.
Details
- Kind
- Plugins
- Topic
- AI, RAG & memory
- Publisher
- steinsfu
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.1.0
- Stars
- 2
- Last push
- 2026-08-19T09:11:01Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
steinsfu/my-adhd-caveman
README
<p align="center"> <img src="assets/logo.png" alt="my-adhd-caveman" width="168" height="168" /> </p> <h1 align="center">my-adhd-caveman</h1> <p align="center"> <b>ADHD shape + caveman diction</b><br /> Action first. Numbered terse steps. Fluff dies. Structure stays. Fewer tokens. </p> <p align="center"> <a href="LICENSE"><img src="https://img.shields.io/github/license/SteinsFu/my-adhd-caveman?style=flat-square" alt="MIT License" /></a> <a href="https://github.com/SteinsFu/my-adhd-caveman/stargazers"><img src="https://img.shields.io/github/stars/SteinsFu/my-adhd-caveman?style=flat-square" alt="GitHub stars" /></a> <img src="https://img.shields.io/badge/clients-Cursor%20·%20Claude%20·%20Codex%20·%20Gemini%20·%20Hermes-111827?style=flat-square" alt="Works with Cursor, Claude, Codex, Gemini, Hermes" /> </p> <p align="center"> <a href="#install">Install</a> · <a href="#always-on-optional">Always-on (optional)</a> · <a href="#what-it-does">What it does</a> · <a href="#commands">Commands</a> · <a href="./INSTALL.md">Full docs</a> </p> A skill for your coding agent. Stops it from burying the answer in preamble. Numbered steps stay. Extra words go: fewer output tokens, and a shorter chat for the next turn to re-read. Self-contained. Does **not** need [i-have-adhd](https://github.com/ayghri/i-have-adhd) or [caveman](https://github.com/JuliusBrussee/caveman) installed. --- ## What it does <table> <tr> <th width="50%">Before (83 tokens)</th> <th width="50%">After (69 tokens)</th> </tr> <tr valign="top"> <td> Great question! Let me think about this. Your auth flow has a few moving pieces: the middleware, the token verification, and the cookie handling. Looking at `src/auth.ts`, `verifyToken` (around lines 42–58) seems to use an older API. One approach would be to rewrite that function. After making the change, you'd want to run the auth tests. Hope this helps! </td> <td> Edit `src/auth.ts:42`. Change `<` to `<=` on expiry check. 1. Open `src/auth.ts` 2. In `verifyToken` (lines 42–58), use `<=` 3. Run `npm test -- auth.spec.ts` Next: run that test. Paste first failing line if any. </td> </tr> </table> Full rules: [`skills/my-adhd-caveman/SKILL.md`](./skills/my-adhd-caveman/SKILL.md). 1. Lead with the next action. 2. Number multi-step work. Cap 5. 3. End with one next action (under two minutes). 4. Progress = one line, not a recap. 5. Drop fluff. Keep structure. --- ## Install - Installing the skill **does not** turn it on for every chat. - Invoke it with `/my-adhd-caveman` (Codex: `$my-adhd-caveman`). **Most clients** (Cursor, Copilot, Windsurf, Cline, Amp, …): ```bash npx skills add SteinsFu/my-adhd-caveman -g ``` `-g` = user-wide. Drop `-g` for this project only. | Client | Command | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------ | | **Claude Code** | `claude plugin marketplace add SteinsFu/my-adhd-caveman && claude plugin install my-adhd-caveman@my-adhd-caveman` | | **Codex** | `codex plugin marketplace add SteinsFu/my-adhd-caveman --ref master && codex plugin add my-adhd-caveman@my-adhd-caveman` | | **Hermes** | `hermes skills install SteinsFu/my-adhd-caveman/skills/my-adhd-caveman` | | **Gemini CLI** (opt-in) | copy [`gemini.toml`](./skills/my-adhd-caveman/agents/gemini.toml) → `~/.gemini/commands/my-adhd-caveman.toml` | Update, uninstall, and more clients: **[INSTALL.md](./INSTALL.md)**. --- ## Always-on (optional) Skip this section if you only want the skill when you type `/my-adhd-caveman`. - The skill itself has no `alwaysApply`. - Always-on is a **separate** step: copy a short rule into the client's persistent instructions. **Cursor** ```bash mkdir -p ~/.cursor/rules curl -fsSL https://raw.githubusercontent.com/SteinsFu/my-adhd-caveman/master/rules/cursor.mdc \ -o ~/.cursor/rules/my-adhd-caveman.mdc ``` Or: Settings → Rules → User Rules, paste [`rules/always-on.md`](./rules/always-on.md). **Other clients:** paste [`rules/always-on.md`](./rules/always-on.md) into that client's instructions file: - `CLAUDE.md` - `~/.codex/AGENTS.md` - `~/.gemini/GEMINI.md` - workdir `AGENTS.md` - `.github/copilot-instructions.md`. Paths: [INSTALL.md](./INSTALL.md#always-on-optional). > **Gemini CLI exception:** `gemini extensions install https://github.com/SteinsFu/my-adhd-caveman` loads `GEMINI.md` and **is** always-on. Use the command-file install above if you want opt-in. Off in a session: `stop adhd-caveman` or `normal mode`. <details> <summary><b>Do other clients need the <code>rules/</code> folder?</b></summary> No. `rules/` is copy-paste templates. No client auto-loads that folder. - `cursor.mdc` is Cursor-only (`.mdc` + `alwaysApply`). - Claude, Codex, Gemini, Hermes, Copilot never scan the repo `rules/` folder. Same words, in their own instructions file. Details: [`rules/README.md`](./rules/README.md). </details> --- ## Commands | Say | Effect | | ---------------------------------------------- | ------------------------- | | `/my-adhd-caveman` | On for this session | | `/my-adhd-caveman lite\|full\|ultra\|wenyan-*` | Diction only. Shape stays | | `stop adhd-caveman` / `normal mode` | Off | Default diction: **full**. Code, commits, PRs, and docs stay normal prose. --- ## Credits - **Shape:** [ayghri/i-have-adhd](https://github.com/ayghri/i-have-adhd), action first, numbered steps, one next action - **Diction:** [JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman), drop fluff, fragments, fewer tokens ## License [MIT](./LICENSE)