Repository navigation
v0.4.4
Open Steps now reads as what it is: plain-language agent skills, built and measured on Claude Code, that also install on Codex, Cursor and Gemini CLI. The README says, tool by tool, what was run and what comes from each tool's documentation, and the install check stops calling a correct install on those three tools broken.
The README starts with installing, for every tool. Quick start opens with the one step every tool shares (clone the repository), then a Claude Code section (the plugin, the routing block, the install check) and a section for Codex, Cursor and Gemini CLI (one copy command into ~/.agents/skills/, the routing block per tool, the hooks per tool). A table, "What was run on each tool", gives each tool's status for installing the skills, the routing block, both hooks, how often the skills switch on by themselves, and the premortem's fresh agent: measured, watched (with the version and the operating system), checked by hand on test input, taken from the tool's documentation, or not measured. How often the skills switch on is measured on Claude Code so far; runners for the other tools are open issues #39 (Codex), #40 (Cursor) and #38 (Gemini CLI).
Claims corrected to what was actually seen.
- Codex hooks: the scripts were checked by hand against Codex-shaped input; Codex running them in a live session has not been watched yet. The README and docs/other-agents.md used to say Codex runs them unchanged.
- The Cursor CLI and Gemini CLI hook runs were one contributor's, on Windows 11, not reproduced by the maintainer; the Cursor desktop app has not been tried.
- The list of what a skill may do without asking now names every
allowed-toolsentry in the pack. It used to end with "Nothing else" while several entries were missing. - The premortem: in Claude Code its review went to a fresh agent in 9 of 9 runs on Sonnet 5 and 8 of 9 on Opus 5 (2026-09-14); on Codex CLI 0.151 no fresh agent started in four runs, a check made before the skill's last two changes.
- "Published measurements say" had no source; it now points at the pack's own numbers and says the evals do not compare wordings.
- Claude Code reads a project's
AGENTS.mdwhen there is noCLAUDE.md(v2.1.277 and later), which the routing-block paragraph now says. - Codex caps its skills catalog at 2% of the context window and shortens descriptions first, per its documentation; docs/other-agents.md notes that activation there may drop when many other skills are installed.
doctor.sh stops calling a correct install broken. Before, a correct Gemini CLI or Cursor install gave four faults and a correct Codex install two, because the script assumed Claude Code was present and took any copy in ~/.agents/skills/ for a Codex install. Now:
- Claude Code is judged when there is a sign of it; when there is none, its parts say "not checked" instead of FAULT, and when it is present with nothing of the pack set up while the pack is found for another tool, that is a fact line.
- The shared folder and each tool's own skills folder (
~/.codex/skills,~/.cursor/skills,~/.gemini/skills) are read. - Codex is judged in full when it is the only tool that reads a shared copy, so a Codex install that skipped the routing block or the hooks is still a fault.
- On Gemini CLI and Cursor, a hook that points at the documentation's placeholder path or at a missing adapter is a fault.
- A machine with no copy of the pack for any tool is still a fault.
- A Claude Code marketplace that was added but never installed no longer reads as an installed plugin.
hooks/test.sh grows from 53 to 183 checks, covering correct and broken installs on each tool. Labels and exit codes are unchanged, and the script still only reads. On Codex, Cursor and Gemini CLI you can now run it too: bash open-steps/doctor.sh from the folder holding the clone. It does not yet check which event each hook sits under.
Translations. Each of the six translations says at the top that installing on Codex, Cursor and Gemini CLI is described in the English Quick start, and carries the trademark line. They are otherwise as translated on 12 and 13 September.
Update: git pull inside your clone, then claude plugin update open-steps@open-steps. On Codex, Cursor and Gemini CLI, run the copy command again from the folder that holds the clone.