Ryuu's Skills

Overview

What runs in Claude Code, Codex, OpenCode and other tools that read a skills directory.

Prerequisites: git, gh and Bun 1.4.0 or newer. Installing needs no Python.

skills/ is plain markdown backed by a Bun and TypeScript CLI. Nothing in it is tied to one agent, so it works anywhere skills are read. agents/ uses Claude Code format; the installer also translates it into OpenCode v2 subagents. The CLI's skills hook verbs speak the hook protocol Claude Code and Codex share. An OpenCode v2 plugin maps its tool events to those same verbs. Wiring is per agent: Claude Code, Codex, OpenCode and Other Tools.

Claude CodeCodexOpenCode v2Cursor, Copilot
skills/yesyesyes, nativelyyes, if the tool reads a skills dir
plans and its scriptsyesyesyesyes
agents/ Claude subagentsyesnowritten as v2 subagentsno
skills hook verbsyesyesyes, through the pluginno
prs modeyesyesyesyes
reviewer extensionsyesyesyesyes
guards and session briefyesyesyes, through the pluginno
AGENT_RULES rule groupsyesrules/skills.rules, prefix rules onlypolicies for denies, permissions for asksno

In Practice

Outside Claude Code:

  • The panel skills (interrogate, how, architect) fan out to the Claude agents in agents/ and to Codex arms, which run as child tasks where the harness can delegate to Codex, such as T3 Code, and as plain calls to the Codex CLI everywhere else. With only one of the two, the panel runs that family's arms. With neither Claude agents nor a Codex transport, it degrades to a single pass rather than failing, which each skill states in its own steps.
  • AGENT_RULES enforces the rule groups in Claude Code, Codex and OpenCode: the installer writes them into each tool's own config. Cursor and Copilot get none, and a Codex prefix rule cannot express every entry, so put the same rules in your AGENTS.md for those.
  • prs mode and the reviewer extensions are skill text plus CLI commands that call git and gh, so they run in any tool. Claude Code, Codex and OpenCode also get the commit guard, comment guard, dash guard, session brief and reply guard. OpenCode runs those through its plugin, not hook config.
  • The installer creates a skills directory for the tools known to read one and links into the rest only where a directory already exists. Other Tools has the rule and the overrides.

AGENTS.md is the right home for the rules themselves. It is the one file every tool reads, so a rule written there applies everywhere, and the hooks make a subset of it mechanical.

On this page