Agent skill

Herdr Operations

by espennilsen in espennilsen/pi

A skill your agent uses when inspecting or operating Herdr sessions, workspaces, tabs, panes, agents, terminal output, agent messaging, or waits.

MITAuto-check passed

Install Herdr Operations

skills CLI
$ npx skills add espennilsen/pi --skill herdr-operations -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install espennilsen/pi herdr-operations --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.pi/skills/herdr-operations .claude/skills/herdr-operations && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
herdr-operations
GitHub stars
122
Token cost
~525 tokens
SKILL.md length
183 words
Files
2 (incl. references)
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when inspecting or operating Herdr sessions, workspaces, tabs, panes, agents, terminal output, agent messaging, or waits.

  • Operating Herdr sessions
  • SKILL.md covers Safe discovery, Choose the right target, Common workflows and Safety
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Terminal output

What it does

Herdr Operations is an agent skill from espennilsen/pi. Use when inspecting or operating Herdr sessions, workspaces, tabs, panes, agents, terminal output, agent messaging, or waits.

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/upstream-docs.md`).

The licence is MIT.

When your agent uses it

  • Operating Herdr sessions
  • Terminal output
  • Agent messaging

Example prompts

  • “/herdr-operations”

What it can do on your machine

Read from SKILL.md and the folder at commit 79d019b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Herdr Operations loads about 525 tokens when it runs, and up to ~842 if it reads all its reference files. Until then it costs about 36 tokens; SKILL.md has 183 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~525
With references · SKILL.md plus every file in references/, read only if the agent opens them
~842

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from espennilsen/pi at commit 79d019b, republished under its MIT licence (© espennilsen). 183 words, ~525 tokens.

Download SKILL.mdSave it as .claude/skills/herdr-operations/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
herdr-operations
description
Use when inspecting or operating Herdr sessions, workspaces, tabs, panes, agents, terminal output, agent messaging, or waits.

Herdr Operations

Inspect state before acting. Use the installed CLI help as the authority for the current version.

Safe discovery

bash
herdr status
herdr session list --json
herdr workspace list
herdr pane list
herdr agent list

If one command fails, do not try invented alternatives. Run herdr --help, then the relevant command group's --help; if needed, use the upstream docs fallback.

Choose the right target

NeedUse
Coding-agent state, output, or messageherdr agent …
Server, test, shell, or low-level terminal controlherdr pane …
Submit a shell command atomicallyherdr pane run <pane_id> <command>
Read logs without soft wrapping--source recent-unwrapped

Common workflows

Inspect an agent, then use the installed agent-message command:

bash
herdr agent list
herdr agent get <target>
herdr agent read <target> --source recent-unwrapped --lines 120
herdr agent --help
herdr agent <installed-message-command> <target> "<message>"

For example, documented releases have used agent send; newer releases may expose another message command. Use the spelling and argument order from local help.

Create an unfocused workspace or split pane so current work remains visible:

bash
herdr workspace create --cwd <path> --label <label> --no-focus
herdr pane split <pane_id> --direction right --no-focus

Wait rather than polling:

bash
herdr agent wait <target> --until idle --timeout 300000
herdr pane wait-output <pane_id> --match "<text>" --timeout 300000

Safety

  • Read output before sending input to an agent.
  • Use pane run instead of separate text and Enter events for shell commands.
  • Ask before stopping/deleting sessions or closing workspaces, tabs, or panes.
  • Treat agent messages as literal terminal input; do not send destructive instructions without explicit user approval.

© espennilsen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .pi/skills/herdr-operations of espennilsen/pi.

  • SKILL.md
  • references/upstream-docs.md

Open the folder on GitHubat commit 79d019b

Compare with similar skills

Herdr Operations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Herdr Operations compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Herdr Operations this skillespennilsen/pi122—~525Automated safety check: PassMIT
Herdrdavidondrej/skills4.1k—~2.1kAutomated safety check: PassMIT
Session Handoffsickn33/agentic-awesome-skills47k—~1.8kAutomated safety check: NotesMIT
Sessionanthropics/claude-for-legal9.6k3 repos~478Automated safety check: PassApache-2.0
Node Inspect Debuggeropenclaw/openclaw392k1 repos~894Automated safety check: PassMIT
Session History Searchslopus/happy24k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Herdr

    davidondrej/skills

    Operate and coordinate AI agents in Herdr workspaces in Ghostty.

    4.1k GitHub stars~2.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Session Handoff

    sickn33/agentic-awesome-skills

    A skill your agent uses when context approaches capacity, before /clear or /compact, when switching tasks, or when ending a coding session: produces a structured handoff artifact for the next session.

    47k GitHub stars~1.8k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Session

    anthropics/claude-for-legal

    Official

    Run a focused N-question study session on a subject — MBE, essay, or flashcards.

    9.6k GitHub starsUsed in 3 repos~478 tokens
    EducationAuto-check passed
  • Node Inspect Debugger

    openclaw/openclaw

    Debug Node.js with node inspect, --inspect, breakpoints, CDP, heap, and CPU profiles.

    392k GitHub starsUsed in 1 repo~894 tokens
    Frontend & DesignAuto-check passed
  • Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Session Handoff

    davila7/claude-code-templates

    Creates comprehensive handoff documents for seamless AI agent session transfers.

    32k GitHub starsUsed in 2 repos~1.6k tokens
    Agent WorkflowsAuto-check passed

More from espennilsen/pi

All 36 skills in this repo
  • GitHub

    espennilsen/pi

    Interact with GitHub repos, PRs, issues, CI, and notifications via the pi-github extension commands and gh CLI.

    122 GitHub stars~1k tokensUpdated 18 days ago
    Auto-check passed
  • Skill Creator

    espennilsen/pi

    Create, review, and improve skills for Pi agents. An agent skill from espennilsen/pi.

    122 GitHub stars~2.1k tokensUpdated 18 days ago
    Auto-check passed
  • Dry Code Review

    espennilsen/pi

    Perform a comprehensive DRY (Don't Repeat Yourself) code review on a codebase.

    122 GitHub stars~1.7k tokensUpdated 18 days ago
    Auto-check passed
  • Extract Design System

    espennilsen/pi

    Reverse-engineer a design system from a live website (public URL or localhost).

    122 GitHub stars~2k tokensUpdated 18 days ago
    Auto-check passed
  • PDF Reader

    espennilsen/pi

    Read and extract content from PDF files — text, tables, metadata, and images.

    122 GitHub stars~1.6k tokensUpdated 18 days ago
    Auto-check passed
  • Google Workspace

    espennilsen/pi

    Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows.

    122 GitHub stars~3.4k tokensUpdated 18 days ago
    Auto-check passed

Questions about Herdr Operations

What does Herdr Operations do?

A skill your agent uses when inspecting or operating Herdr sessions, workspaces, tabs, panes, agents, terminal output, agent messaging, or waits. Herdr Operations is an agent skill from espennilsen/pi. Use when inspecting or operating Herdr sessions, workspaces, tabs, panes, agents, terminal output, agent messaging, or waits.

When should I use Herdr Operations?

Herdr Operations fits situations like: operating Herdr sessions; terminal output; agent messaging.

How do I install Herdr Operations in Claude Code?

Run `npx skills add espennilsen/pi --skill herdr-operations -a claude-code`. Or copy the skill folder (.pi/skills/herdr-operations in espennilsen/pi) into .claude/skills/herdr-operations in your project. Claude Code loads it when a task matches its description.

How do I install Herdr Operations in Codex?

Run `npx skills add espennilsen/pi --skill herdr-operations -a codex`. Or copy the skill folder (.pi/skills/herdr-operations in espennilsen/pi) into .agents/skills/herdr-operations in your project. Codex loads it when a task matches its description.

Can I use Herdr Operations in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add espennilsen/pi --skill herdr-operations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/herdr-operations, .gemini/skills/herdr-operations, .github/skills/herdr-operations and .opencode/skills/herdr-operations in your project.

What does Herdr Operations need to run?

SKILL.md names no scripts, command-line tools or credentials: Herdr Operations is instructions for the agent only.

Does Herdr Operations access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Herdr Operations safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Herdr Operations use?

Herdr Operations is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Herdr Operations use?

About 525 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 317 tokens, read only when the agent opens those files.

What are the alternatives to Herdr Operations?

Skills that share tags, products or a category with Herdr Operations: Herdr (davidondrej/skills, 4.1k stars), Session Handoff (sickn33/agentic-awesome-skills, 47k stars), Session (anthropics/claude-for-legal, 9.6k stars) and Node Inspect Debugger (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Herdr Operations?

espennilsen (a GitHub user) maintains it in espennilsen/pi, which has 122 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 21, 2026.

Source: espennilsen/pi on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.