About this mod

Yorozuya

A place for skills used by Claude Code.

The skills are written as procedures that Claude decides how to carry out on the spot, rather than scripts that blindly run a fixed sequence of commands. The only skill with a script is restart-sessions, and it is limited to irreversible chains and read-only work such as watching and extracting conversation logs. The commands actually run vary with the Claude Code version, permission settings, CLAUDE.md, and so on. When something does not work, add an instruction or have it investigate at that point.

To use one, put .agents/skills/<skill>/ in the skill directory of the project that will use it (.claude/skills/ for Claude Code). Making it a symlink to the cloned checkout lets 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 has no effect). The restart-sessions context watcher lets each session watch itself when you load the mod (mod/). To watch from outside without the mod, put a SessionStart hook in the using project's .claude/settings.json (the restart-sessions README). Put the heavy-task hook in settings.json as well (the heavy-task README).

Skill list

| skill | What it does | Requirements and real-machine verification | | --- | --- | --- | | restart-sessions | Restarts sessions on Herdr, carrying over the conversation log. When started in a project with a SessionStart hook, it watches context usage and restarts sessions that send an alert without asking for confirmation | Herdr. Watching requires a status line that reports usage and config.local.json. Verified on macOS and Windows 11 | | weekly-pace | Estimates the weekly quota pace of Claude and Codex. restart-sessions uses it to add a note saying that work should be handed 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 under pressure, and its mod tells the session when room opens up | The using project's .claude/heavy-commands.json, which lists what counts as heavy. The hook and mod are for Claude Code (the mod uses 2.1.289 function hooks). Verified on macOS only | | cleanup | Investigates candidates for disk clutter, reports them, and 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 through on Windows only. The mod is for Claude Code and was verified on macOS only | | machine-setup | Installs apps and tools on a new machine and brings in configuration files | Claude Code. Completed end to end only on Ubuntu (Docker) |

The prerequisites, mechanics, and usage of each skill are in its linked README. The rules for changing a skill are in AGENTS.md.