코딩 에이전트는 세션을 시작할 때
설치된 스킬의 이름과 설명을 전부 읽습니다.
안 쓰는 스킬도 건너뛰지 않아 토큰 낭비가 발생합니다.

앱을 만드는 중인데 글쓰기 스킬 12개까지 같이 읽힙니다.

스킬 60개 · 18,938자 · 세션마다 5,000~9,000토큰

쓰는 건 6개인데 읽히는 건 60개.
세션을 새로 열 때마다 60개를 다시 읽습니다.

제 컴퓨터에 설치된 스킬 60개의 이름과 설명 글자 수를 재서 토큰으로 환산한 값입니다. 스킬마다 설명 길이가 달라서 범위로 적었습니다. 내 프로젝트에서 스킬이 몇 개 읽히는지는 대시보드에 바로 나옵니다.

그래서 프로젝트마다 쓰지 않는 스킬과 플러그인을 꺼둘 수 있게 만들었습니다.

플러그인을 하나 설치하면 스킬·커맨드·훅이 한꺼번에 들어옵니다. 같이 쓰는 것끼리 그룹으로 묶어두고 프로젝트에 적용하면, 그 프로젝트에서는 묶어둔 것만 켜지고 나머지는 Claude Code에서 꺼집니다. 다른 프로젝트는 그대로입니다. 플러그인은 다음 세션을 열 때부터 켜지고 꺼집니다.

한 에이전트용으로 만든 스킬을 다른 에이전트에서도 그대로 쓸 수 있습니다.

같은 스킬 파일인데 에이전트마다 찾아보는 폴더가 다릅니다. 그래서 Claude Code용으로 만들어둔 스킬을 Codex나 Gemini CLI는 못 봅니다. 체크박스 하나면 나머지 에이전트도 그 파일을 그대로 읽습니다. 복사본이 생기지 않으니 고칠 때도 한 군데만 고치면 됩니다.

흩어져 있는 지침 파일도 찾아줍니다.

CLAUDE.md, AGENTS.md, .cursor/rules/처럼 에이전트마다 다른 지침 파일을 찾아 크기와 수정 시각을 보여줍니다. 수정 시각을 보면 CLAUDE.md는 고쳐뒀는데 AGENTS.md만 예전 그대로인 게 바로 보입니다.

자주 나오는 질문.

왜 macOS만 지원하나요?

설치 스크립트가 서버를 launchd에 등록하는데, launchd는 macOS에만 있습니다. server.py에는 macOS 전용 코드가 없어서, Linux에서는 systemd --user 유닛이 이 파일을 실행하게 하면 됩니다. Windows는 아직 지원하지 않습니다(#1).

내 컴퓨터에서 무엇이 바뀌나요?

그룹을 적용한 프로젝트 안에서 플러그인이 켜지고 꺼지고, 스킬 폴더로 이어지는 링크가 생깁니다. 지침 파일은 목록만 보여줄 뿐 고치지 않습니다.

되돌리거나 지우려면요?

대시보드에서 그룹 적용을 해제하면 그 그룹 스킬의 링크가 지워집니다. 플러그인을 켜고 끈 값은 그 프로젝트의 .claude/settings.local.json에 남아 있으니, 그것까지 지우려면 파일에서 enabledPlugins를 빼면 됩니다. 도구를 지우려면 Homebrew로 설치했을 때는 brew services stop agent-hud와 brew uninstall agent-hud를, 설치 스크립트로 설치했을 때는 launchctl bootout gui/$(id -u)/com.agent-hud를 실행하고 ~/Library/LaunchAgents/com.agent-hud.plist를 지웁니다. 그룹과 프로젝트 목록은 ~/.claude/tools/agent-hud/에 있으니 필요 없으면 이 폴더도 지웁니다.

다른 에이전트도 따로 설정해야 하나요?

아니요. 대시보드에서 “+ 폴더 추가”로 프로젝트를 넣으면 어느 에이전트로 작업하든 똑같이 보입니다. 플러그인과 스킬을 켜고 끄는 건 Claude Code에만 적용됩니다. 다른 에이전트는 그 설정을 읽지 않습니다.