Dev tools

Open Steps is a Claude Code skill pack that rewrites agent output in plain language, and it has 441 stars in 22 days

September 16, 2026 at 4:20 AM PT

GitHub social card for the open-steps repository

Image: GitHub

Why it mattersA product owner who cannot read a diff can now supervise AI-written work directly, because the agent tells them what changed, what is left, and whether it is safe to close in words they use every day.

Pavlo Kharmanskyi has published Open Steps, an MIT-licensed pack of eight Claude Code skills that force the coding agent to report in plain language, ask its questions in words a non-engineer can answer, and end each piece of work with a one-screen verdict. The repository was created on 25 August 2026, has 441 stars and 75 forks, and was last pushed on 14 September.

What the pack does

The eight skills each fire on a specific moment in a session. os-done-or-not writes a one-screen report at the end of the work with a verdict: done or not, anything needed from the person, any new debt, safe to close. os-step-by-step produces numbered steps a non-technical person can follow, and only after the agent has tried everything itself. os-ask-simple states a question in plain words, names what it costs later, and marks one recommendation. os-check-work refuses to trust another session's report and checks every claim against what actually happened. os-say-simple rewrites any text without losing facts or bad news. os-big-picture keeps one standing file that names every feature, how far each got, and what is queued.

The author, who describes himself as not an engineer, says he built the pack because his own coding agent kept reporting its work in engineering shorthand, so he could not tell whether it was done.

Numbers the author quotes

The activation numbers were remeasured on 12 September against a set of 25 phrases, three runs each, headless, on three Claude models. Kharmanskyi reports that all 25 phrases fired the right skill 100 percent of the time on Opus 5, 98 percent on Sonnet 5, and 85 percent on Haiku 4.5. Off-topic questions fired zero of nine on every model. He also states the pack costs 770 tokens per session for the always-on skill descriptions, a figure Claude Code reports itself with claude plugin details open-steps.

These are the author's own numbers on his own test set, and he says so in the README. He also flags that Haiku moves between runs, that three runs per phrase is a smoke test rather than a benchmark, and that on Haiku two skills are unreliable enough that a user will sometimes have to type the skill name by hand.

The pack is a Claude Code plugin, and the skills also install into Codex, Cursor and Gemini CLI through their shared skills folder. Two hooks, both plain shell scripts, keep the skills firing across a long session.

Anyone running AI-assisted development for a team that mixes engineers and non-engineers has the exact class of problem this pack targets. The engineer reads the diff. The product owner reads a report they cannot verify. Open Steps rewrites that report as a plain verdict so the product owner can supervise the work directly. It also runs another agent against the first one's claims in os-check-work, which is the pattern a team building agents on top of agents already needs. Whether the 85 to 100 percent activation numbers hold up on a different phrase set is the first thing anyone adopting this should measure for themselves, and the evaluation harness is in evals/ for that purpose.

Source

Primary source: kharmanskyi/open-steps on GitHub.

Source: kharmanskyi on GitHub

This item was written by an AI system from the linked source. Reveneau is responsible for what it publishes.

More from AI News

OpenAI hires the Git AI founders to work inside Codex, and the standalone company will likely wind down

Aidan Cunniffe and Sasha Varlamov, the founders of the open-source Git AI tool that tracks how much code each AI coding agent writes and what it costs, are joining the OpenAI Codex team, and the standalone company they left Atlassian to build will likely wind down.

Source: PressDev tools

Codenotch puts your Claude, Cursor and Codex usage limits on the edge of the screen

Codenotch is a macOS app that pins how much of each coding agent's session limit you have used to the edge of the screen, and it reached 196 stars within hours of being published.

Source: GitHubDev tools

AgentsDock puts Claude Code, Codex and Cursor on your phone through a server you run

AgentsDock is a self-hosted client for Claude Code, Codex and Cursor that runs the CLIs on a machine you own and lets you drive them from a Mac, iPhone, iPad, Linux box, Windows PC or Android phone.

Source: Hacker NewsDev tools