i-have-adhd
ayghri/i-have-adhd — Claude Code 向け ADHD フレンドリー出力スキル(MIT)
ソースは GitHub: ayghri/i-have-adhd。/i-have-adhd を実行すると、以降のセッション応答が action-first(最初の行がコマンド・パス・スニペット)、番号付き手順、ターンごとの状態再提示に揃う。フックやバックグラウンド処理は使わず、Markdown のスキル定義だけで動く。
Claude Code の通常応答は、前置き・脱線・締めの定型句が混ざりやすい。ADHD の診断の有無に関わらず、「答えの前に 3 段落」は作業開始の摩擦になる。
| 症状 | スキル側の対策 |
|---|---|
| 前置きで本題が遅れる | 1 行目を実行可能なアクションに固定(ルール 1・10) |
| 手順が 1 段落に潰れる | 複数ステップは番号リスト、1 ステップ 1 アクション(ルール 2) |
| ターン間で進捗を忘れる | 「Step 3 of 5 done」のように状態を毎回再提示(ルール 5) |
| 脱線で最初の課題が消える | 副題は別質問として保留(ルール 4) |
| 完了が埋もれる | 何が動くようになったかを明示(ルール 7) |
i-have-adhd/
├── .claude-plugin/
│ ├── plugin.json # プラグイン宣言
│ └── marketplace.json # marketplace add 用
├── commands/
│ └── i-have-adhd.md # /i-have-adhd スラッシュコマンド
└── skills/
└── i-have-adhd/
└── SKILL.md # 10 ルール本体flowchart TD
U["ユーザー: /i-have-adhd"] --> C["commands/i-have-adhd.md"]
C --> S["skills/i-have-adhd/SKILL.md を読み込み"]
S --> F["frontmatter description で適用タイミングを指定"]
F --> R["以降の応答を 10 ルールで整形"]
R --> X["stop adhd mode / normal mode で解除"]
- スラッシュコマンドが
SKILL.mdの有効化を指示する。 - frontmatter の
descriptionが「いつルールを適用するか」をモデルに伝える(カジュアルな会話も含む)。 - 本文が「どう書くか」を 10 条で定義する。
- セッション中は有効。
stop adhd modeまたはnormal modeで解除。
skills/i-have-adhd/SKILL.md が正。以下は README の要約。
| # | ルール | 意図 |
|---|---|---|
| 1 | 次のアクションを先頭に | 「分かった」と「やった」の間の摩擦を減らす |
| 2 | 多段タスクは番号付き | 1 ステップ 1 境界。1 行に「それから」が 2 回入らない |
| 3 | 末尾は 1 つの具体アクション | 2 分以内にできる次の一手 |
| 4 | 脱線を抑制 | 副題は別質問として提示 |
| 5 | 毎ターン状態を再提示 | 作業記憶外の進捗を画面に戻す |
| 6 | 時間見積もりは具体単位 | 「少し」より「15 分」 |
| 7 | 完了を可視化 | 何が動くようになったかを前面に |
| 8 | エラーは事実ベース | 「Uh oh」禁止。原因と修正を並記 |
| 9 | リストは 5 件まで | 超えたら now/later や must/nice で分割 |
| 10 | preamble / recap / closer 禁止 | 「Great question」「Hope this helps!」等を排除 |
例外(ルールを緩める条件)
- ユーザーが explain / walk me through を要求 → 長文 OK。ただし preamble と closer は禁止、見出しでスキム可能に。
- 破壊的操作の直前 → 確認を優先(安全 > 簡潔)。
- 3 ターン連続でデバッグ失敗 → コード修正ループを止め、仮説を 1 つ質問。
- 要求が本当に曖昧 → 短い確認質問 1 つ。
送信前チェック(Pre-send)
SKILL.md 末尾のチェックリスト: 冒頭の「これから〜します」、末尾の「他に?」、by the way サイドバー、情報ゼロの hedging を削除。最初と最後の行だけ読んでも (a) 次に何をするか (b) 何が起きたかが分かるか確認する。
Great question! Let's think about this. Your auth flow has a few moving pieces… By the way, your dependency is also out of date… Let me know if you want to dig deeper!
「どこを触ればいいか」が後ろに埋もれる
Run npm install jsonwebtoken@latest, then edit src/auth.ts:42.
- Open
src/auth.ts - Replace
verifyToken(lines 42–58) - Run
npm test -- auth.spec.ts
Next: paste the first failing line if any test fails.
I've made some changes to the auth flow. Among other things… Hope this helps!
Step 3 of 5 done: middleware updated.
Login now works with magic links. Try: npm run dev, open /login.
Next: backfill the last_login column. Run the script?
対象は Claude Code のみ。詳細は INSTALL.md。
1. ローカルプラグイン(推奨)
git clone https://github.com/ayghri/i-have-adhd ~/i-have-adhd
claude plugin marketplace add ~/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd検証: claude plugin list に i-have-adhd が enabled で出る。セッションで /i-have-adhd を実行。
2. プロジェクト単位(marketplace なし)
mkdir -p .claude/skills/i-have-adhd
cp skills/i-have-adhd/SKILL.md .claude/skills/i-have-adhd/SKILL.md
mkdir -p .claude/commands
cp commands/i-have-adhd.md .claude/commands/i-have-adhd.md作業ディレクトリの .claude/skills/ と .claude/commands/ を自動検出。そのリポジトリ内だけ有効。
3. ユーザー全体(全プロジェクト)
bash install-user.shリポジトリルートで実行。~/.claude/skills/i-have-adhd/SKILL.md と ~/.claude/commands/i-have-adhd.md にコピー。$CLAUDE_CONFIG_DIR があればそちらを優先。再実行は上書きで安全。
~/.claude/CLAUDE.md に出力スタイルの指示を追記すれば、毎セッション最初からルール適用可能(/i-have-adhd 不要)。INSTALL.md の Always-on 節を参照。
| 経路 | スコープ | 切り替え |
|---|---|---|
| プラグイン | マシン全体(marketplace 経由) | /i-have-adhd で ON、stop/normal で OFF |
| プロジェクト skill | その repo のみ | 同上 |
| ユーザー skill | 全プロジェクト | 同上(セッションごとに opt-in) |
| CLAUDE.md 追記 | 設定に依存 | 常時。OFF にするには記述を削除 |
編集対象は skills/i-have-adhd/SKILL.md のみ。変更は次回 /i-have-adhd 実行時に反映(反映されない場合は Claude Code 再起動)。
- frontmatter
description— モデルが「いつスキルを発火するか」を読む。広すぎるとノイズ、狭すぎると取りこぼし。 - 本文 Rules — 追加・削除・文言調整は自由。10 条は出発点。
- Pre-send check — モデルが自己検査する最終ゲート。厳しさを上げたいときはここを厚くする。
| 質問 | 回答 |
|---|---|
| ただの「簡潔モード」? | いいえ。10 条は読み方・着手・ドーパミン配分まで含む形状指定。短さ ≠ action-first。 |
| 長い説明は壊れる? | explain 要求時は長文可。preamble/closer 禁止と見出し構造は維持。 |
/i-have-adhd なしで使える? | CLAUDE.md 追記で常時化可能(INSTALL.md)。 |
| プラグイン vs CLAUDE.md | プラグインはセッション単位 ON/OFF と共有に向く。CLAUDE.md は常時適用向け。 |
| ADHD 診断は必要? | 不要。preamble 探しのスクロールが負担なら対象。 |
- GitHub: ayghri/i-have-adhd — 本体リポジトリ
- README.md — ピッチ・Before/After・10 ルール
- INSTALL.md — 3 経路・トラブルシュート・アンインストール
- skills/i-have-adhd/SKILL.md — ルール全文と Pre-send check