zoryn agent¶
Integrate zoryn with local AI coding agents (Claude Code, Codex, opencode, …). Currently one subcommand group: agent skill.
zoryn agent skill¶
Manage the bundled zoryn Agent Skill in your local AI coding agents, so they load zoryn's ALT-packaging workflow knowledge on demand.
A skill is a folder containing a SKILL.md — the same format is read by Claude Code, Codex and opencode. The full skill ships with the zoryn package at /usr/share/zoryn/skills/zoryn/SKILL.md. Rather than copy that into every agent, zoryn agent skill install writes a small reference SKILL.md (the skill's frontmatter, so the agent discovers it, plus a pointer to the packaged file) into each agent's skills folder.
This keeps a single source of truth that updates with the package. It works precisely because the zoryn agent skill is only useful where zoryn is installed, so the referenced file is always present — including inside a zoryn devenv, where the package provides it natively (no dependence on a ~/.claude bind-mount).
The default target folders cover all three agents:
~/.claude/skills/zoryn/— Claude Code, opencode~/.agents/skills/zoryn/— Codex, opencode
zoryn agent skill install¶
Write the reference SKILL.md into the agent skills folders.
Options:
--dir DIR— install intoDIRinstead of the defaults (repeatable). A leading~/is expanded to your home directory.--force— overwrite a previously-installed zoryn reference. A folder zoryn did not write (your own skill, unrelated files) is refused regardless, so nothing of yours is deleted.
zoryn agent skill install # install into the default agent folders
zoryn agent skill install --force # reinstall, overwriting an existing reference
zoryn agent skill install --dir ~/.config/opencode/skills # install only into a specific folder
Restart the agent (or start a new session) afterwards to pick up the new skill.
zoryn agent skill uninstall¶
Remove the skill folder from each agent skills directory (the inverse of install). Only folders zoryn installed (carrying its reference marker) are removed; a folder you wrote yourself is left untouched. --dir selects specific folders.
zoryn agent skill status¶
For each agent skills folder, report whether the zoryn agent skill is installed, what it points at, and whether that referenced file still exists (a missing target is flagged). Exits non-zero if any install is broken (dangling reference) or foreign, so scripts can detect it.
zoryn agent skill path¶
Print the absolute path of the packaged SKILL.md, one line — handy in scripts.
zoryn agent skill show¶
Print the full bundled SKILL.md to stdout, without going through an agent.