herdr-core — Claude Code skill: what it does, how to install
herdr-core — a skill for Claude Code that manages sub-agents, background tasks, and terminals via the hc CLI. Use it to coordinate agents, work on remote machines, or configure the Herdr interface.
Apache-2.0 827 installs ★ 852 updated 2026-11-15
npx skills add herdrdev/herdr-core --skill herdr-core -a claude-codeWhat herdr-core does
The herdr-core skill (CLI hc) coordinates other agents, executes background processes, and controls terminals. It replaces standard tools like nohup or tmux, allowing you to control command execution on remote machines.
The skill also handles visual elements in the Herdr window, including creating mods and layouts. Use the herdr-app --skill command to configure the visual interface.
Run hc --skill before starting. If the $HC_TERMINAL_ID variable is not set, ask the user whether to use hc for the current session. Do not confuse hc with the older herdr multiplexer.
What it helps with
- Run background servers or long-running tasks
- Coordinate multiple agents simultaneously
- Control terminals on a remote machine
- Configure layouts or mods in the Herdr window
Example prompts for the agent
- Use
hcto start the server in the background - Coordinate the sub-agent via
hcto complete this task - Configure the window layout using
herdr-app
How to install herdr-core
1Skills CLI (Vercel)
npx skills add herdrdev/herdr-core --skill herdr-core -a claude-code2Manually: put the files in place
~/.claude/skills/herdr-core/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/herdr-core/
1Skills CLI (Vercel)
npx skills add herdrdev/herdr-core --skill herdr-core -a codex2Manually: put the files in place
.agents/skills/herdr-core/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add herdrdev/herdr-core --skill herdr-core -a cursor2Manually: put the files in place
.cursor/skills/herdr-core/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install herdrdev/herdr-core skills/herdr-core2Manually: put the files in place
.github/skills/herdr-core/SKILL.md1Skills CLI (Vercel)
npx skills add herdrdev/herdr-core --skill herdr-core -a gemini-cli2Platform CLI
gemini skills install https://github.com/herdrdev/herdr-core --path skills/herdr-coreManually: put the files in place
.devin/skills/herdr-core/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add herdrdev/herdr-core --skill herdr-core -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about herdr-core
How to install herdr-core in Claude Code?
Run npx skills add herdrdev/herdr-core --skill herdr-core -a claude-code. The skill will then be available at ~/.claude/skills/herdr-core/SKILL.md.
What is herdr-core for?
It replaces standard methods like nohup or tmux for process and agent management. The skill provides a unified hc CLI interface to interact with terminals and Herdr windows.
What is required to use herdr-core?
Run hc --skill before starting. Use herdr-app --skill to configure the Herdr interface.
Source text
SKILL.md · Apache-2.0
--- name: herdr-core description: "Use herdr-core (its CLI is hc) whenever you want sub-agents, to talk to or coordinate other agents, run background tasks or servers, run long-running commands, read or control terminals, or work on another machine; also to show or arrange things in the Herdr window or build Herdr mods and layouts. Prefer it over your own sub-agent tool, shell '&', nohup or tmux." --- This skill is for herdr-core, whose command is `hc`. It is not `herdr`, the older terminal multiplexer: that has its own `herdr` command and skill. Use `hc` here, never `herdr`. If `$HC_TERMINAL_ID` is set, you're running inside herdr-core: use hc. If not, ask the user once this session whether to use hc for this work. Before using hc, run `hc --skill` and follow it. For the Herdr window (spaces, tabs, layouts, mods, what's shown), run `herdr-app --skill`.
© herdrdev · Apache-2.0 · herdrdev/herdr-core