About this mod

Yorozuya

A place for skills to use with Claude Code.

The skills are written as procedures for Claude to judge and carry out in the moment, rather than scripts that run fixed commands in sequence. The only skill with scripts is restart-sessions, and those scripts are limited to irreversible chains and read-only work such as watching and extracting conversation logs. The commands actually used vary with the Claude Code version, permission settings, CLAUDE.md, and other factors. When something does not work, add an instruction on the spot or have Claude investigate it.

To use a skill, place .agents/skills/<skill>/ in the skill directory of the project that will use it（.claude/skills/ for Claude Code）. A symlink to the cloned location makes pulled updates arrive automatically. If you copied it, add restart-sessions' config.local.json to the using project's .gitignore（the .gitignore in this repository does not apply）. If the restart-sessions context watcher is loaded as a mod（mod/）, each session watches itself. To watch from outside without the mod, add a SessionStart hook to the using project's .claude/settings.json（restart-sessions README）。Place the heavy-task hook in settings.json as well（heavy-task README）。

Skills

| skill | What it does | Requirements and real-device checks | | --- | --- | --- | | restart-sessions | Restarts sessions on Herdr while carrying over the conversation log. In a project with a SessionStart hook, it watches context usage and restarts sessions with notifications without asking for confirmation | Herdr. Watching requires a status line that reports usage and config.local.json. Real-device checks: macOS and Windows 11 | | weekly-pace | Estimates Claude and Codex weekly quota pace. restart-sessions uses it to add a note that work should go to Codex when Claude is running at a high pace | On the Claude side, Herdr and a status line that reports Weekly. On the Codex side, the codex CLI | | heavy-task | Measures CPU and memory before starting heavy work and decides whether to start or wait. Its hook stops heavy commands when CPU is constrained, and its mod tells the session when capacity is available again | The using project needs .claude/heavy-commands.json, listing what counts as heavy. The hook and mod are for Claude Code（the mod uses function hooks from 2.1.289）. Real-device checks: macOS only | | cleanup | Investigates disk-trash candidates and reports them, then deletes only the selected ones. The mod watches free space and, when the line is crossed, asks each session to clean up its own repository | Deletion was completed only on Windows. The mod is for Claude Code, and real-device checks were done only on macOS | | machine-setup | Installs apps and tools on a new machine and imports configuration files | Claude Code. Completed end to end only on Ubuntu（Docker） |

Each skill's prerequisites, mechanics, and usage are in the linked README. Rules for changing skills are in AGENTS.md.