CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

herdr

Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to use Herdr to inspect or control panes, tabs, workspaces, terminals, commands, or communication with another agent. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work. Requires HERDR_ENV=1.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Failed to scan

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a high-quality operational skill: every instruction is an executable command, workflows are sequenced with explicit validation gates and timeout-recovery loops, and it encodes genuinely non-obvious domain rules (ID opacity, status semantics, no-focus conventions, safety boundaries). The two areas with headroom are tightening the repeated and edge-case-heavy status-semantics prose and splitting reference-grade detail (status state machine, read-source catalog) into a references file.

Suggestions

Move the idle/done state-machine detail (the three paragraphs of focus-attention edge cases) into a short reference table in a references/ file, keeping only the operational rule ('wait for done in background tabs, idle in watched tabs; treat both as completed') inline.

Deduplicate repeated guidance: state the split geometry rule and 'inspect before waiting' once, and reference them from the two workflows instead of restating the same command and rule in both.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence throughout (no basic explanations) and nearly every line is Herdr-specific knowledge Claude cannot know, e.g. "Treat every ID as an opaque string" and the enumerated read sources. It is not a 5 because sections could be tightened: the idle/done semantics span three dense paragraphs of edge cases ("If the foreground client is explicitly unfocused, completion can become done even in the active tab"), and points are repeated ("Inspect before waiting" appears at lines 150 and 192; the split command is shown twice). It is clearly above anchor 3 since there is no generic padding.

4 / 5

Actionability

Quotes: "test "${HERDR_ENV:-}" = 1", "herdr pane split --current --direction right --no-focus", "herdr wait agent-status <returned-pane-id> --status done --timeout 120000", "herdr pane read <returned-pane-id> --source recent-unwrapped --lines 120". Every workflow step is a copy-paste-ready executable command with real flags, timeouts, and JSON field names ("Read result.pane.pane.pane_id"), plus concrete error-handling decision rules. This matches anchor 5; anchor 4 would imply minor gaps in executable coverage, which are not present.

5 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints and feedback loops: env gate ("If the check fails... stop"), "Inspect the pane after launch. If agent_status is not yet idle, wait for the idle transition", "If a wait times out, inspect herdr pane get... and pane read before deciding what to do", and "Re-read create, split, move, list, or get responses after mutations". The pre-flight guard against accidental mutation ("Do not probe a mutating nested command by omitting arguments") strengthens the safety sequence. This matches anchor 5's explicit validation with error-recovery loops; anchor 4 would require missing checkpoints.

5 / 5

Progressive Disclosure

The body is well-sectioned (Learn the current CLI, IDs and current context, Start agents interactively, Run an ordinary command, Safety rules) and wisely delegates CLI syntax to runtime discovery via "herdr --help" instead of inlining version-sensitive help text, which is appropriate one-level-late disclosure. However, the skill exceeds the simple-skill threshold at ~190 lines with no reference layer: the agent-status state machine and the read-source catalog are reference-grade detail living inline, and the bundle's scripts/ and assets/ are never referenced from the body. This lands at anchor 4 (good structure, minor organization gaps) rather than 5.

4 / 5

Total

18

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a model example: it states what the skill does, gives explicit and restrictive when-conditions with concrete trigger nouns, adds anti-trigger guidance to prevent false positives, and declares an environment precondition. Its only minor weakness is that the capability verbs are umbrella terms (control/inspect) rather than an enumeration of specific operations.

DimensionReasoningScore

Specificity

Quotes: "Control Herdr, a terminal multiplexer for coding agents" and "inspect or control panes, tabs, workspaces, terminals, commands, or communication with another agent" — several concrete actions over enumerated resources. It sits at anchor 4 rather than 5 because the verb coverage is umbrella-like (control/inspect) and doesn't enumerate distinct operations (split, read, wait, rename) found in the body; it is clearly above anchor 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

What: "Control Herdr, a terminal multiplexer for coding agents." When: "Use only when the user explicitly mentions Herdr or asks to use Herdr..." plus an explicit exclusion clause and the requirement "Requires HERDR_ENV=1". Both what and when are answered explicitly with concrete trigger phrases, matching anchor 5 exactly; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Quotes: "explicitly mentions Herdr", "panes, tabs, workspaces, terminals, commands, or communication with another agent", plus the anti-triggers "background terminal, delegation, or parallel work". Since the natural user trigger is the product name itself, coverage is comprehensive including synonym phrases for what the tool manages; nothing natural is missing, so anchor 5 fits better than 4.

5 / 5

Distinctiveness Conflict Risk

Quotes: "Use only when the user explicitly mentions Herdr" and "Do not use merely because a task could benefit from a background terminal, delegation, or parallel work." The proper-noun gate plus explicit anti-triggers give a clear niche with minimal conflict risk, matching anchor 5 rather than anchor 4's 'minor overlap risk'.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

KennethJefferson/HerdrPlus

Path

__references/herdr/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.