numbrone skill
A skill that builds a hierarchy of agents: a chief, per-project managers and workers in separate git worktrees inside herdr
- 138 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Workers write code and run commands on their own in separate branches; the number of confirmation prompts depends on your settings.
- Managers read tickets and errors from connected external systems.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/numbroneDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Workers write code and run commands on their own in separate branches; the number of confirmation prompts depends on your settings.
- Managers read tickets and errors from connected external systems.
This is third-party code. Review the repository files before installing.
What it does
numbrone is one skill, one bash script and three markdown role files. You give the chief a task in plain words, the chief works out which of your projects it belongs to and hands it to that project's manager. The manager runs workers in parallel, each in its own tab and a separate git worktree on a `numbrone/<task>` branch, reviews their work and reports up the chain. Everything runs inside herdr, so any agent can be watched live. The chief writes no code: it routes, delegates and tells you what is happening. State is kept in plain text files you can read and edit. The chief and managers can also watch external sources such as Linear, Sentry and Datadog.
Who it is for. People running several projects at once who want to give tasks to one agent and let parallel workers carry them out across repositories.
Good fit when
- Two tasks from different repositories must start with one phrase and run in parallel.
- Bugs from Sentry or Linear should reach the right project's manager without manual routing.
- Changes go into separate branches so your own working copy stays untouched.
- You want to watch what each agent does live and get notified when your answer is needed.
Not a fit when
- You work on Windows: macOS and Linux are supported.
- herdr does not suit as a terminal environment: the whole scheme is built on its workspaces and tabs.
- You have a single task in one repository: a chief, manager and worker hierarchy is excessive.
Example request
Fix the flaky login test in the API and add a dark mode toggle to the web application.Limitations
herdr, git and jq on macOS or Linux are required. The project is independent and not affiliated with the herdr team. It uses Claude Code by default, while Codex, Gemini and OpenCode connect through separate configuration. Installing herdr is suggested with `curl -fsSL https://herdr.dev/install.sh | sh`, which is worth reading before running. The number of permission prompts is set at first run. Managers review worker output before marking it ready, but the merge decision stays with you. The latest commit is from November 2026.
How to disable. Delete the `~/.claude/skills/numbrone` and `~/.numbrone` folders, then close the `numbrone/*` workspaces in herdr. Task branches stay in the repositories and leftover worktrees go away with `git worktree remove`.
FAQ
What does the chief do?
The chief writes no code. It takes a request, identifies the project, hands it to the manager and tells you about progress and questions.
Where do workers run?
Each worker gets a herdr tab and a separate git worktree on a `numbrone/<task>` branch, so tasks run in parallel and your checkout is untouched.
How do I install the skill?
With `npx skills add stevenmichaelthomas/numbrone -g` or by hand: clone the repository and copy `skills/numbrone` into `~/.claude/skills/`.
How do I start after installing?
Start herdr, run `herdr integration install claude`, open Claude Code and type `/numbrone`. The skill walks through setup, and the chief starts with `cd ~/.numbrone && claude`.
Can I use something other than Claude Code?
Yes, herdr supports Codex, Gemini, OpenCode and other agents. Setup is described in the Using another agent section.
Discussion
No questions or reviews yet.
Related
SkillsOne agent launches others in the background: Claude Code, Codex, Copilot CLI, Grok Build and Pi, with a model chosen per stage.
A skill with 25 commands to audit and improve the prompts, tools and agent designs of a project in Cursor, Claude Code and Codex
A herdr pane that draws an agent swarm as a live graph with attempts, review gates and evidence, so large runs stay readable.
A desktop app where Claude Code, Codex, Gemini and other agents work as a team of specialists in a shared project
A skill that turns several Claude Code, Codex and Cursor windows into a team with a coordinator, shared registry and cross-review
A skill plus hooks that keep a coding agent on task and cut speculative defenses, unread checksums and scope creep
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| numbrone (this card) | no | 138 | |
| herdr | no | 50,721 | a terminal environment for agents; numbrone adds chief, manager and worker roles on top |
| Claude Squad | no | 8,790 | manages several agent sessions in tmux; numbrone routes tasks across projects through a hierarchy |
README in short
The README shows the scheme from chief through managers to workers and the report chain back. Sections on inputs, teaching the chief from your corrections and the work log describe how the system accumulates knowledge.