Documentation
From README.md · b46c48d · Built 2026-11-17
Claude Code, Codex CLI, Gemini CLI, Cursor and GitHub Copilot CLI as a plugin or extension, and OpenCode and Qwen Code as a skill. Hermes Agent packaging is included, and it is listed in the Hermes plugin catalog. Any other agent that reads SKILL.md files and can run Python 3.8 can use the skill too. The Claude Code, Codex CLI, Gemini CLI and Copilot CLI packages are installed and checked with each agent's own CLI. Cursor, OpenCode and Qwen Code follow each agent's published format.
Cursor, OpenCode, Qwen Code and Hermes are not live-tested.
Install
One repository, one skill, a wrapper for each agent. Pick yours:
| Agent | Install |
|---|---|
| Claude Code | claude plugin marketplace add aunysillyme-dev/aunx-skills then claude plugin install aunx-decompose@aunx |
| Codex CLI | codex plugin marketplace add aunysillyme-dev/aunx-decompose then codex plugin add aunx-decompose@aunx-decompose |
| Gemini CLI | gemini extensions install https://github.com/aunysillyme-dev/aunx-decompose |
| GitHub Copilot CLI | copilot plugin install aunysillyme-dev/aunx-decompose |
| Cursor | cursor-agent plugin marketplace add https://github.com/aunysillyme-dev/aunx-decompose, then install it from Customize, Plugins |
| OpenCode | npx aunx-decompose install --agent opencode |
| Qwen Code | npx aunx-decompose install --agent qwen |
| Hermes Agent | hermes plugins install aunx-decompose then hermes plugins enable aunx-decompose, listed in the Hermes plugin catalog |
Skill only, from npm
npx aunx-decompose install copies the skill into an agent's skills folder. It defaults to Claude Code. Name another agent with --agent, repeat the flag for several, or use all:
npx aunx-decompose install --agent codex
npx aunx-decompose install --agent gemini --agent cursor
npx aunx-decompose install --agent all
--agent | User folder | With --project |
|---|---|---|
claude | ~/.claude/skills | .claude/skills |
codex | ~/.agents/skills | .agents/skills |
gemini | ~/.gemini/skills | .gemini/skills |
cursor | ~/.cursor/skills | .cursor/skills |
opencode | ~/.config/opencode/skills | .opencode/skills |
copilot | ~/.copilot/skills | .github/skills |
qwen | ~/.qwen/skills | .qwen/skills |
--force replaces an existing copy. npx aunx-decompose check --plan plan.json runs the checker without installing anything.
From skills.sh
npx skills add aunysillyme-dev/aunx-skills --skill decompose
Listed at skills.sh. The CLI asks which agent to install into.
Use it
Type /decompose <task> in Claude Code (namespaced as /decompose:decompose), Gemini CLI and Hermes, $decompose in Codex, or ask any agent to split a task into steps, plan dependencies, or check write-path overlap. Decompose plans work and does not execute the plan.