📦

herdr

Name: herdr
Author: herdrdev

Content revision r1 Safe ⚙️ External commands

Control Herdr Workspaces and Coding Agents

Managing several coding agents across terminal panes can make state, focus, and output difficult to track. This skill uses Herdr commands to organize panes, coordinate agents, run commands, and inspect results.

Supports: Claude Codex Code(CC)

🥉 78 Bronze

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request

Review the Skillstore skill "herdr" from https://skillstore.io/skills/herdrdev-herdr.md and its manifest at https://skillstore.io/api/skills/herdrdev-herdr/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Your Agent should still show its plan and request any confirmation required by the security policy.

Agent-readable resources

Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.

Markdown detail GET /skills/herdrdev-herdr.md Signed manifest GET /api/skills/herdrdev-herdr/manifest Signed lockfile GET /api/skills/herdrdev-herdr/lockfile

Test it

Using "herdr". Use Herdr to inspect the current session without changing focus.

Expected outcome:

Current workspace: w1
Active tab: w1:t1
Two panes are available, with one idle coding agent.

Using "herdr". Use Herdr to run the project tests in a sibling pane and summarize the result.

Expected outcome:

The tests completed in a background pane. All 48 tests passed, and the user focus remained in the original pane.

Using "herdr". Use Herdr to ask a reviewer agent for actionable findings.

Expected outcome:

The reviewer reached a settled state and reported two actionable findings concerning timeout handling and missing error-path coverage.

Security Audit

Safe

v1 • 8/14/2026 Open versioned report

Most alerts are false positives caused by Markdown code fences and inline code being mistaken for Ruby backtick execution. Seven examples perform real Herdr mutations, including launching agents, sending input, changing layout, and running a shell command; these capabilities are expected but require deliberate targeting.

Files scanned

196

Lines analyzed

Review items

False positives ignored

Capability review items (7)

These are real local capabilities that may be expected for this skill, so they require review but are not counted as confirmed malicious behavior.

Medium

SKILL.md:102-104

Ruby/shell backtick execution

```bash

The fenced example invokes `herdr pane split`, which mutates terminal layout. The fixed operation is purposeful and preserves focus, but it is real external command execution.

Medium

SKILL.md:110-112

Ruby/shell backtick execution

```bash

The example starts a Codex process in a selected pane through `herdr agent start`. Launching another agent is intended, but it consumes resources and grants that process access to the working directory.

Medium

SKILL.md:116-118

Ruby/shell backtick execution

```bash

This example starts an agent and forwards native agent arguments after `--`. The operation is intentional, but caller-supplied arguments can materially change the launched process.

Medium

SKILL.md:124-126

Ruby/shell backtick execution

```bash

The example sends an instruction to a live coding agent with `herdr agent prompt`. That agent may modify files or execute tools, so target selection and user intent are security-relevant.

Medium

SKILL.md:142-145

Ruby/shell backtick execution

```bash

The examples send Escape and Ctrl+C keystrokes to another agent. These commands can interrupt or alter an active process, making the external control capability a real operational risk.

Medium

SKILL.md:160-162

Ruby/shell backtick execution

```bash

The fenced example invokes `herdr pane split`, which changes the current terminal layout. It is bounded and keeps focus unchanged, but still performs a real mutating external command.

Medium

SKILL.md:166-170

Ruby/shell backtick execution

```bash

The example uses `herdr pane run` to execute command text in another shell pane. This is an explicit arbitrary-command capability, even though the shown command is a benign test invocation.

Risk Factors

Audited by: codex

Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report

Copy report link

https://skillstore.io/skills/herdrdev-herdr/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/herdrdev-herdr/security.svg)](https://skillstore.io/skills/herdrdev-herdr?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/herdrdev-herdr?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/herdrdev-herdr/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/herdrdev-herdr.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Academic citations (APA · BibTeX · CFF)

APA citation

herdrdev. (2026). herdr security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/herdrdev-herdr/audits/1

BibTeX citation

@techreport{herdrdev-herdrdev-herdr-2026,
  author = {herdrdev},
  title = {herdr security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/herdrdev-herdr/audits/1},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "herdr security audit report (audit version 1)"
version: "unspecified"
type: report
authors:
  - name: "herdrdev"
date-released: "2026-08-14"
url: "https://skillstore.io/skills/herdrdev-herdr/audits/1"
identifiers:
  - type: other
    value: "skillstore:herdrdev-herdr:audit:1"
    description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: Medium

Architecture

Maintainability

Content

Community

Spec Compliance

What You Can Build

Coordinate a code review

Create a sibling pane, start a reviewer agent, send the review request, and collect actionable findings.

Run tests beside active work

Open a background pane, run the requested test command, wait for completion text, and inspect recent output.

Inspect parallel agent progress

List active agents, check lifecycle states, and read output without changing the user interface focus.

Try These Prompts

Inspect the current session

Use Herdr to list the current workspace, tabs, panes, and agents. Summarize their identifiers and states without changing focus.

Run a background test

Use Herdr to create a sibling pane in the current directory. Run [test command], wait for completion, and summarize the output.

Delegate a focused review

Use Herdr to start a [agent kind] agent named [name] in a sibling pane. Ask it to review [scope] and return actionable findings.

Coordinate parallel investigation

Use Herdr to start two named agents for [task A] and [task B]. Preserve focus, monitor both, and consolidate their verified results.

Best Practices

Verify HERDR_ENV before issuing any Herdr control command.
Use explicit pane identifiers or unique agent names, and parse identifiers from command responses.
Preserve the current directory and user focus unless the user requests a different layout.

Avoid

Do not invoke Herdr unless the user explicitly requests Herdr.
Do not guess identifiers or rely on another client focus.
Do not close sessions or stop servers without explicit user authorization.

Frequently Asked Questions

What must be installed before using this skill?

The herdr binary must be available in PATH, and the current process must have HERDR_ENV set to 1.

Can this skill control Herdr from outside a managed pane?

No. The skill stops when the Herdr environment check fails.

Can it start Claude, Codex, or Claude Code agents?

It can start agent kinds supported by the installed Herdr version. The requested kind must be locally available.

Does it keep the current terminal focus?

Yes, background workflows use no-focus controls unless the user requests a focus change.

Can it run ordinary shell commands?

Yes. It can run requested command text in a selected pane, wait for output, and read the result.

How does it handle blocked agents?

It inspects the agent state and recent output before sending deliberate keys or additional input.

Developer Details

Author

herdrdev

License

MIT

Skillstore revision

Version notice

The author did not declare a version.

Repository

https://github.com/herdrdev/herdr/tree/d76657f2c7fc18dcce3b9af43842c8afaba1646b/skills/herdr

Ref

2d1a4712a46e152244a21c2b88e7479563580ea2

Maintenance freshness

8/14/2026

Usage

0 downloads · 0 views

File structure

📄 SKILL.md