Agent Skill

hive.terminal-tools-troubleshooting skill

hive.terminal-tools-troubleshootingaden-hive/hivecore/framework/skills/_preset_skills/terminal-tools-troubleshooting/SKILL.md

Read when a terminal-tools call returned something surprising — empty stdout despite no error, exit_code is null, output_handle came back expired, "too many jobs" / "session busy" / "too many PTYs", warning was set unexpectedly, semantic_status disagrees with exit_code. Diagnostic recipes only — load on demand. Don't preload; the foundational skill covers the happy path.

11kApache-2.0

always on

85 tokname + description

once used

1,115 tokSKILL.md body

bundled files

repo stars

11kGitHub

Install the hive.terminal-tools-troubleshooting skill

Skills CLI (Claude Code, Codex, Cursor and others)

npx skills add https://github.com/aden-hive/hive --skill hive.terminal-tools-troubleshooting

Claude Code, by hand (all projects)

git clone --depth 1 https://github.com/aden-hive/hive.git /tmp/hive
mkdir -p ~/.claude/skills
cp -R /tmp/hive/core/framework/skills/_preset_skills/terminal-tools-troubleshooting ~/.claude/skills/terminal-tools-troubleshooting

For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.

What it costs your context

Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.

When	What loads	Cost
Every session	Name and description	85 tok
When the agent uses it	The SKILL.md instructions	1,115 tok
Only if opened	No bundled files	—

Until it is used, hive.terminal-tools-troubleshooting costs about 16× less than the median MCP server we measured (1,362 tokens on every turn). Installing all 24 skills from aden-hive/hive would load 1,783 tokens of descriptions. Skills vs MCP study

Checks

The name breaks the specification (lowercase letters, digits and single hyphens, up to 64 characters).

Checked 2026-10-22 · method

What's inside

The headings of its SKILL.md. Read the full file on GitHub.

Troubleshooting terminal-tools
Empty stdout despite the command "should have" produced output
exitcode: null
outputhandle returned expired: true
"too many jobs" / JobLimitExceeded
"session busy"
"PTY cap reached"
warning is set, the command worked
semanticstatus: "ok" but exitcode: 1
semanticstatus: "error" but exitcode: 0
truncatedbytesdropped > 0 in terminaljoblogs
terminalptyopen succeeds but the first run times out
shell="/bin/zsh" returned an error
A command in shell=True is interpreted differently than expected

More skills from aden-hive/hive

All skills in this repo

browser-edge-casesaden-hive/hive
SOP for debugging browser automation failures on complex websites. Use when browser tools fail on specific sites like LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.
11k1039 tok idle · 1,605 in use
hive.browser-automationaden-hive/hive
Required before any hive-browser CLI command. The browser is driven from the terminal by running `hive-browser <command> ... --json` via terminal_exec — not via MCP tools. Teaches the browser lifecycle rules (the bridge attaches to the USER'S running Chrome — never kill or launch browser processes; timeouts are transport issues, not crashes), the screenshot + coordinate workflow (hive-browser interact with a fractional coordinate) that reaches shadow-DOM inputs selectors can't see, the viewport-fraction coordinate rule (not pixels), rich-text editor quirks ("send button stays disabled" failures), and CSP gotchas. Covers Chrome via CDP through the GCU Beeline extension.
11k142 tok idle · 11,043 in use
hive.chart-creation-foundationsaden-hive/hive
Required reading whenever any chart_* tool is available. Teaches the one-tool embedding contract (call chart_render → live chart appears in chat AND a downloadable PNG lands in the queen session dir), the ECharts (data viz) vs Mermaid (structural diagrams) decision, the BI/financial-grade aesthetic baseline (no chartjunk, restrained palette, proper typography, single message per chart), and the canonical spec patterns for the 12 most-common chart types. Skipping this leads to 1990s-Excel charts, missing downloads, and the agent writing markdown image links by hand instead of letting chart_render drive the UI.
11k133 tok idle · 2,493 in use
hive.colony-progress-trackeraden-hive/hive
Claim tasks, record step progress, and verify SOP gates in the colony SQLite queue. Applies when your spawn message includes a db_path field.
11k36 tok idle · 1,091 in use
hive.context-preservationaden-hive/hive
Proactively extract critical values from tool results into working notes before automatic context pruning destroys them.
11k24 tok idle · 231 in use
hive.error-recoveryaden-hive/hive
Follow a structured recovery decision tree when tool calls fail instead of blindly retrying or giving up.
11k25 tok idle · 278 in use
hive.image-generationaden-hive/hive
Required before calling image_generate. Create and edit images from a prompt — generate an image, make a picture / logo / illustration / icon / banner / poster / thumbnail / hero image / mockup / product shot / social graphic, or edit / restyle / combine existing images from reference images. Uses OpenAI gpt-image-2 through the Hive image service, billed to the user's Hive credits like an LLM call (no API key needed). Teaches the exact call shape, the quality/cost tradeoff (quality="low" is the default and cheapest), reference-image editing, how to show the result to the user with attach_file, and the failure modes (out of credits, model unavailable, moderation).
11k149 tok idle · 1,193 in use
hive.linkedin-automationaden-hive/hive
Read before automating LinkedIn with browser_* tools. LinkedIn combines shadow DOM (#interop-outlet), strict Trusted Types CSP that silently drops innerHTML, Lexical composer, native beforeunload dialogs that hang the bridge, and aggressive spam filters — each has bitten us at least once. Verified flows for profile messaging, connection-request acceptance, feed composition, and search. Requires hive.browser-automation. Verified against logged-in production 2026-04-11.
11k99 tok idle · 5,000 in use