이 mod 소개

Yorozuya

Claude Code에서 사용할 skill을 모아 두는 곳입니다.

skill은 정해진 명령을 순서대로 실행하는 스크립트가 아니라, Claude가 그 자리에서 판단해 진행하는 절차로 작성합니다(스크립트가 있는 것은 restart-sessions뿐이며, 되돌릴 수 없는 연쇄 작업과 감시·대화 로그 추출 같은 읽기 전용 처리로 한정합니다). 실제로 실행되는 명령은 Claude Code 버전, 권한 설정, CLAUDE.md 등에 따라 달라집니다. 잘 되지 않을 때는 그 자리에서 지시를 추가하거나 원인을 조사하게 합니다.

사용하려면 .agents/skills/<skill>/을 사용하는 프로젝트의 skill 디렉터리(Claude Code라면 .claude/skills/)에 둡니다. clone한 위치로 symlink를 만들면 pull한 업데이트가 그대로 전달됩니다. 복사했다면 restart-sessions의 config.local.json을 사용하는 프로젝트의 .gitignore에 추가합니다(이 저장소의 .gitignore는 적용되지 않습니다). mod(mod/)를 불러오면 restart-sessions의 컨텍스트 감시 기능이 각 세션을 스스로 감시하게 합니다. mod 없이 외부에서 감시하려면 사용하는 프로젝트의 .claude/settings.json에 SessionStart hook을 둡니다(restart-sessions README). heavy-task hook도 settings.json에 둡니다(heavy-task README).

skill 목록

| skill | 하는 일 | 필요한 것·실기 검증 | | --- | --- | --- | | restart-sessions | Herdr의 세션을 대화 로그와 함께 재시작합니다. SessionStart hook이 있는 프로젝트에서 실행하면 컨텍스트 사용률을 감시하고, 알림이 나온 세션을 확인 없이 재시작합니다 | Herdr. 감시에는 사용률을 표시하는 status line과 config.local.json이 필요합니다. macOS·Windows 11에서 실기 검증 | | weekly-pace | Claude와 Codex의 주간 할당량 사용 속도를 대략 계산합니다. restart-sessions가 Claude의 속도가 높을 때 재시작한 작업을 Codex에 넘기도록 덧붙이는 데 사용합니다 | Claude 쪽은 Herdr와 Weekly를 표시하는 status line, Codex 쪽은 codex CLI | | heavy-task | 무거운 작업을 시작하기 전에 CPU와 메모리를 측정하고 시작할지 기다릴지 결정합니다. CPU가 부족하면 hook이 무거운 명령을 막고, 여유가 생기면 mod가 세션에 알립니다 | 무엇을 무거운 작업으로 볼지 적는 사용하는 프로젝트의 .claude/heavy-commands.json. hook과 mod는 Claude Code용(mod는 2.1.289 function hooks 사용). macOS에서만 실기 검증 | | cleanup | 디스크 쓰레기 후보를 조사해 보고하고, 선택한 것만 삭제합니다. mod가 여유 공간을 감시하다가 선을 넘으면 각 세션에 자신의 저장소를 정리하게 합니다 | 삭제까지 확인한 것은 Windows뿐입니다. mod는 Claude Code용이며 macOS에서만 실기 검증 | | machine-setup | 새 컴퓨터에 앱·도구를 설치하고 설정 파일을 가져옵니다 | Claude Code. Ubuntu(Docker)에서만 처음부터 끝까지 확인 |

각 skill의 전제 조건·구조·사용법은 링크된 README에 있습니다. skill을 수정할 때의 규칙은 AGENTS.md에 있습니다.