무엇을 설치하는 것인가
i-have-adhd는 코딩 어시스턴트의 답변 형식을 바꾸는 에이전트 스킬(agent skill)이다. 에이전트 스킬은 마크다운 파일 하나(SKILL.md)에 '이럴 때는 이렇게 행동하라'를 적어 두면 어시스턴트가 그 지시를 자기 규칙으로 삼는 확장 방식이다. 코드를 실행하는 것도, 서버를 띄우는 것도 아니다. 어시스턴트에게 주는 지침서 한 장이라고 보면 된다.
Claude Code에서는 그 스킬이 플러그인 형태로 배포된다. 플러그인은 스킬·훅·명령 같은 확장 조각들을 한 묶음으로 설치하게 해 주는 포장 단위다. 이 플러그인 안에는 스킬 본체(SKILL.md) 하나와 세션 시작 훅(hook) 하나가 들어 있다. 훅은 세션이 시작될 때 자동으로 실행되는 스크립트를 말하는데, 여기서는 '항상 켜기' 옵션을 처리하는 데만 쓰인다.
만든 사람은 Ayoub G.(github.com/ayghri)이고 라이선스는 MIT다. 이 글을 쓰는 시점의 플러그인 버전은 0.1.0이다. 필자가 만든 물건이 아니라 써 보고 소개하는 것이며, 원본 저장소 주소는 글 끝에 있다.
이름 때문에 오해하기 쉬운데, ADHD 진단이 있어야 쓰는 도구가 아니다. 저장소 첫 줄이 그렇게 못 박아 두었다. 긴 답변에서 정작 필요한 한 줄을 찾느라 시간을 쓰고 있다면 그게 이 도구의 대상이다.
설치 — 명령 두 줄
터미널에서 아래 두 줄을 차례로 실행한다. 첫 줄은 배포처(marketplace)를 등록하는 것이고, 둘째 줄이 실제 설치다. `i-have-adhd@i-have-adhd`처럼 이름이 두 번 나오는 것은 오타가 아니라 `<플러그인 이름>@<배포처 이름>` 형식이고, 이 저장소는 둘이 같은 이름이라 그렇게 보인다.
저장소를 직접 내려받을(clone) 필요는 없다. Claude Code가 알아서 가져오고 이후 갱신도 맡는다.
설치가 끝나면 Claude Code를 한 번 재시작한다. 플러그인 목록은 실행 시점에 한 번 읽히기 때문에, 재시작 전에는 `/i-have-adhd`가 자동완성에 안 뜬다.
설치가 됐는지 확인하려면 `claude plugin list`를 실행한다. 나중에 갱신은 `claude plugin marketplace update i-have-adhd`, 제거는 `claude plugin uninstall i-have-adhd`와 `claude plugin marketplace remove i-have-adhd`를 함께 실행한다. 지우지 않고 잠시 끄기만 하려면 `claude plugin disable i-have-adhd`를 쓴다.
claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhdclaude plugin list
claude plugin marketplace update i-have-adhd
claude plugin uninstall i-have-adhd
claude plugin marketplace remove i-have-adhd켜는 방법이 두 가지다
여기가 이 플러그인에서 가장 자주 헷갈리는 지점이다. 설치했다고 답변이 바뀌지 않는다. SKILL.md 머리말에 `disable-model-invocation: true`가 걸려 있어서, Claude Code에서는 모델이 이 스킬을 스스로 발견해 적용할 수 없다. 사람이 켜야 켜진다. 중간이 없다 — 켜지 않았으면 꺼져 있는 것이다.
첫째 방법은 그때그때 켜는 것이다. 세션에서 `/i-have-adhd`를 치면 그 세션 동안 규칙이 적용된다. 끄고 싶으면 대화창에 "stop adhd mode" 또는 "normal mode"라고 쓴다.
둘째 방법은 항상 켜 두는 것이다. 홈 디렉터리의 `~/.claude/` 안에 `.i-have-adhd-always`라는 빈 파일을 하나 만들면 된다. 파일을 만드는 명령이 `touch`다. 이 파일이 있으면 세션이 시작될 때마다 플러그인의 훅이 규칙 전문을 자동으로 불러온다. 되돌리려면 그 파일을 지운다.
설정 디렉터리를 옮겨 쓰고 있다면(`CLAUDE_CONFIG_DIR` 환경변수를 설정한 경우) 훅이 그 경로를 따라간다. 훅은 이 파일이 있을 때만 동작하므로, 설치 자체가 기존 동작을 바꾸는 일은 없다.
항상 켜 둔 상태에서도 그 세션만 끄고 싶으면 여전히 "stop adhd mode"가 먹는다.
touch ~/.claude/.i-have-adhd-always # 매 세션 자동 적용
rm ~/.claude/.i-have-adhd-always # 다시 그때그때 켜는 방식으로출력이 어떻게 바뀌나
저장소가 같은 질문에 대한 전후 답변을 나란히 보여 준다. 인증 코드를 고쳐 달라는 요청에 대해, 켜기 전 답변은 "좋은 질문입니다. 한번 생각해 보죠."로 시작해 인증 흐름의 구성 요소를 훑고, 접근 방법을 서술하고, 지나가는 말로 의존성도 오래됐다고 덧붙인 뒤 "도움이 됐으면 좋겠습니다."로 끝난다. 정보는 다 있지만 지금 무엇을 눌러야 하는지는 문단 어딘가에 묻혀 있다.
켠 뒤의 답변은 `npm install jsonwebtoken@latest`를 실행하고 `src/auth.ts:42`를 열라는 문장으로 시작한다. 그다음 세 줄짜리 번호 목록이 오고, 마지막 줄은 "테스트가 실패하면 첫 실패 줄을 붙여 넣으세요"다. 같은 내용이지만 읽는 사람이 다음에 할 일이 첫 줄과 마지막 줄에 있다.
규칙은 열 가지이고 전문은 저장소의 SKILL.md에 있다. 각 규칙이 겨냥하는 것은 취향이 아니라 작업 기억·시작 장벽·시간 감각 같은 구체적인 지점이다.
| # | 규칙 | 무엇을 막는가 |
|---|---|---|
| 1 | 다음 행동을 첫 줄에 | 맥락 설명에 밀려 정작 실행할 명령이 아래로 내려가는 것 |
| 2 | 여러 단계는 번호로 | 한 문장에 '그다음'이 두 번 들어가 순서가 뭉개지는 것 |
| 3 | 2분 안에 할 수 있는 다음 행동으로 끝내기 | '알겠다'와 '했다' 사이에서 일이 멈추는 것 |
| 4 | 곁가지는 뒤로 | 지금 문제를 끝내기 전에 다른 문제가 끼어드는 것 |
| 5 | 진행 상태를 매 턴 다시 말하기 | '5단계 중 3단계'를 머릿속에 들고 있으라는 요구 |
| 6 | 시간 추정은 구체 단위로 | '조금 걸린다'와 '한나절'이 같게 읽히는 것 |
| 7 | 된 것을 눈에 보이게 | 성과가 요약문 안에 묻히는 것 |
| 8 | 오류는 담담하게 | '앗' 같은 감탄사로 시작해 원인·해결이 뒤로 밀리는 것 |
| 9 | 목록은 다섯 개까지 | 순위 없는 열 줄짜리 목록 |
| 10 | 서론·요약·맺음말 없애기 | "제가 하려는 것은"과 "더 필요한 게 있으면 알려주세요" |
규칙이 스스로 풀리는 자리
짧게 쓰라는 규칙이 답 자체를 지워 버리면 곤란하다. 그래서 스킬에는 규칙을 물리는 조건이 함께 적혀 있다. 여섯 가지다.
설명해 달라거나 처음부터 훑어 달라는 요청에는 길이 제한을 풀고 끝까지 설명한다. 대신 서론과 맺음말은 여전히 없고, 나중에 다시 훑을 수 있게 소제목을 붙인다.
되돌리기 어려운 명령(`rm -rf`, 강제 푸시, 스키마 변경, 테이블 삭제 같은 것) 앞에서는 짧게 쓰는 것보다 확인받는 쪽이 먼저다.
같은 오류가 세 턴 연속이면 코드 고치기를 멈추고, 틀렸을 수 있는 전제를 이름 붙여 말한 뒤 진단 질문을 하나 던진다.
요청 자체가 모호하면 짧은 확인 질문 하나가 추측해서 다시 쓰는 것보다 낫다. 선택지를 물으면 한 길만 제시하지 않고 2~4개를 추천안 먼저로 늘어놓는다. 그리고 에이전트 환경 규칙과 충돌하면 환경 쪽이 이긴다.
Claude Code가 아니면
같은 SKILL.md를 여러 도구가 그대로 읽는다. 변환이 필요 없다.
Codex는 배포처 등록에 `--ref main`을 붙이고 설치 명령이 `plugin add`다. 호출은 `$i-have-adhd`. Claude Code와 달리 Codex는 암묵 호출을 허용해서, 필요해 보이는 작업에서 스스로 켜지기도 한다.
Cursor·GitHub Copilot·OpenCode·Amp처럼 에이전트 스킬을 읽는 도구는 `npx skills add ayghri/i-have-adhd`로 넣는다. `-a <도구이름>`으로 특정 도구만, `-g`로 전체 프로젝트에 적용한다.
Zed는 에이전트 패널의 스킬 관리자에서 'Create skill from URL'을 골라 SKILL.md 주소를 붙여 넣으면 된다. Gemini CLI는 배포처 개념이 없어서 두 갈래인데, 명령 파일 하나를 `~/.gemini/commands/`에 내려받으면 필요할 때만 켜지고, 확장으로 설치하면 첫 메시지부터 항상 적용된다.
설정 파일에 규칙을 직접 붙이는 길도 있다. INSTALL.md가 도구별로 붙여 넣을 열 줄짜리 요약 블록을 제공한다 — Codex는 `~/.codex/AGENTS.md`, Copilot은 `.github/copilot-instructions.md`, Cursor는 사용자 규칙(User Rules)에 넣는다.
# Codex
codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd
# Cursor · Copilot · OpenCode 등 (에이전트 스킬 표준)
npx skills add ayghri/i-have-adhd -a cursor -y
npx skills add ayghri/i-have-adhd -g안 될 때 보는 곳
증상이 넷이고 원인이 대체로 정해져 있다.
`/i-have-adhd`가 자동완성에 안 뜨면 에이전트를 재시작한다. 플러그인 목록은 시작할 때 한 번 읽는다.
항상 켜기 파일을 만들었는데 아무 일도 없으면 플러그인을 갱신하고 재시작한다. 훅도 시작 시점에 읽히고, 이 기능은 `hooks/hooks.json`이 들어간 버전부터 동작한다.
`claude plugin marketplace add`가 실패하면 `owner/repo` 형식인지 본다. 로컬 경로로 넣는 경우에는 저장소 루트를 가리켜야 하고 `.claude-plugin/` 하위를 가리키면 안 된다.
설치했는데 답변이 여전히 서론으로 시작하면 새 세션을 연다. 그래도 그러면 SKILL.md의 문장을 직접 조여도 된다. 규칙을 바꾸고 싶으면 저장소를 포크해 SKILL.md를 고친 뒤, 원본을 먼저 지우고(포크와 원본이 이름을 공유한다) 자기 저장소를 배포처로 등록한다.
참고로 이 규칙 묶음은 J. Russell Ramsay와 Anthony L. Rostain의 『The Adult ADHD Tool Kit』을 느슨하게 참고해 만들어졌다. 사람이 하루를 조직하는 방법이 아니라, 언어 모델이 어떻게 답해야 하는가로 옮긴 것이다.
원본(MIT): github.com/ayghri/i-have-adhd