aden-hive/hive

Background Job Control manages long-running terminal jobs using start, poll, wait, and signal tools. Use it before launching builds, deploys, streaming logs, or taking over auto-backgrounded processes from terminal_exec.

Browser Edge Cases provides a standard operating procedure for debugging browser automation failures on complex websites. Use it when browser tools fail on LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.

Chart Creation Foundations teaches the one-tool embedding contract for rendering BI/financial-grade ECharts and Mermaid charts that appear live in chat and save as high-DPI PNGs. Use it whenever chart_* tools are available to avoid chartjunk and missing downloads.

Colony Progress Tracker claims tasks, records step progress, and verifies SOP gates in a shared SQLite queue. Use when your spawn message includes db_path and colony_id fields.

Context Preservation proactively extracts critical values from tool results into working notes before automatic context pruning destroys them. Use it when an agent must retain URLs, API fields, IDs, and analysis conclusions across long tasks.

Error Recovery guides an agent through a decision tree for tool call failures: retry transient errors once, fix and retry structural ones, or escalate if blocking. It switches tools after repeated failures and logs failed tasks to a database.

Filesystem Search teaches agents when to use terminal_rg, terminal_glob, and terminal_exec for filesystem search: content grep with ripgrep, filename globs, and predicate queries for mtime/size/type.

Hive Browser Automation drives a real Chrome instance through the Beeline extension and CDP using the hive-browser CLI, covering lifecycle, screenshots, viewport-fraction coordinates, shadow-DOM inputs, and CSP quirks.

Hive Image Generation creates and edits images from a text prompt using OpenAI gpt-image-2 through the Hive image service, billed to Hive credits. Use it to generate logos, illustrations, banners, product shots, and edit or restyle existing images from reference files.

Hive Note-Taking maintains a free-form scratchpad of decisions, extracted values, and open questions so context pruning doesn't lose anything you still need. Use it to record working data and reasoning between agent tool calls.

Hive PDF reads, writes, merges, splits, rotates, watermarks, encrypts, and OCRs PDF files. Use it when you need to extract text/tables/images, create or modify PDFs, combine or split PDFs, OCR a scanned PDF, password-protect a PDF, or render PDF pages as images.

LinkedIn Automation documents verified browser-automation flows for LinkedIn messaging, connection requests, feed composition, and search. Use it before automating LinkedIn with browser tools.

Persistent PTY Sessions manages interactive terminal sessions for stateful command execution, REPLs, and interactive prompts like sudo or SSH. Use it when you need state to persist across calls or drive a program that requires a real terminal.

Quality Monitor periodically self-assesses an agent's output quality to catch degradation before the judge does. Use it during long-running tasks to detect off-task work, inconsistencies, dropped items, or corner-cutting and correct course.

Queen Colony Debug is a standard operating procedure for live debugging queen sessions, colony forks, worker spawns, and tracker DB plumbing without touching the user's production Hive Desktop. Use it to verify invariants in the create_colony → tracker → run_parallel_workers → worker pipeline.

Slack Notifications Setup configures a Hive Sentinel Slack app, tokens, and channel so a colony can ping the user and accept replies through Slack. Use when asked to set up Slack notifications, get pinged on Slack, or connect Slack for alerts.

Telegram Notifications Setup drives a browser to create a Telegram bot via BotFather, store its token, detect the chat to notify, and turn on Sentinel so a colony can ping the user on Telegram and accept replies. Use it when the user asks to set up Telegram notifications or clicks the in-app 'Set this up with the agent' button on the Telegram step.

Terminal Tools Foundations teaches agents how shell tools behave: foreground/background auto-promotion, output handles, semantic exit codes, destructive warnings, and the bash-only policy. Use it whenever shell tools are available to avoid misreading grep exit 1 or losing truncated output.

Terminal Tools Troubleshooting provides diagnostic recipes for surprising terminal-tools results: empty stdout, null exit codes, expired handles, job/PTY limits, and semantic status mismatches. Use when a call returns something unexpected.

Test Reporting runs the Level 2 dummy agent integration test suite and generates a detailed HTML report with per-test input/output analysis. Use it when you need to run integration tests and view a structured report.

Triage Issue analyzes a GitHub issue, verifies claims against a codebase, and drafts a technical response to close invalid issues. Use it when a user provides an issue URL or number for triage.

Worker Delegation models a goal as a tracker table and writes a playbook that fans out independent row-level work to parallel workers via run_playbook. Use it in colony mode before fan-out to pilot the worker skill, then let convergence retry and resume unfinished rows.

Writing Hive Skills scaffolds a new Agent Skill for a Hive agent that conforms to the Agent Skills specification (SKILL.md with YAML frontmatter, optional scripts/references/assets directories). Use when the user asks to create, scaffold, add, or package a new skill for a Hive agent.

X Automation provides verified browser automation flows for posting, replying, deleting, and search-and-engage on X/Twitter using browser_* tools. It covers Draft.js composer quirks that disable the send button and includes daily-reply and job-market-reply playbooks.