orchid-operator

Manages orchid/divybot agent swarms by checking coordinator health, opening work issues, and handling credentials.

5|1|Updated May 31, 2026
One-click install
npx skills add https://github.com/denoland/orchid --skill orchid-operator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orchid-operator
Source: https://github.com/denoland/orchid/tree/main
Command: npx skills add https://github.com/denoland/orchid --skill orchid-operator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires herdr, git, ssh, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides an interface for human operators to manage and oversee an orchid/divybot agent swarm, handling tasks such as checking the health of the swarm, opening issues for work, supervising workers, and deploying the coordinator.

Core Features & Use Cases

  • Swarm Health Monitoring: Check the status of the coordinator service and ensure every open issue has a live agent.
  • Worker Supervision: Monitor the status of individual workers and address issues like stuck workers or credential problems.
  • PR Supervision and Merging: Forward new reviews, CI failures, and conflicts to workers, and decide whether to merge green PRs automatically.
  • Swarm Pacing: Control the concurrency of agents per account to ensure even usage of the subscription budget.
  • Target Management: Enable or disable specific targets, set agent overflow order, and configure automerge rules.
  • Host Management: Add or remove hosts from the swarm, configure required capabilities and capacities.
  • Coordinator Deployment: Deploy new coordinator binaries across the swarm.
  • Troubleshooting: Identify and fix common issues such as credential problems, worker spawning failures, and stranded agents.
  • Use Case: Suppose you are responsible for an orchid/divybot swarm managing a large codebase. This Skill allows you to monitor the swarm's health, open new issues for workers, and ensure that the coordinator is up-to-date with the latest credentials.

Quick Start

Use the orchid-operator skill to check the health of the orchid service.

Frequently Asked Questions about orchid-operator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor the health of an agent swarm and ensure every open GitHub issue has a live worker?

Swarm health monitoring involves checking the coordinator service status and verifying that every open GitHub issue has a live worker assigned. This Skill supervises workers by identifying stuck agents and handling credential problems to maintain operational stability.

Can I automatically merge green pull requests and forward CI failures to workers?

Yes, automated PR supervision allows you to forward new reviews, CI failures, and conflicts to workers, and decide whether to merge green PRs automatically. This directly handles GitHub issue to PR conversion and ensures continuous integration stability.

How do I manage concurrency and pacing for agents to avoid exceeding subscription budgets?

Swarm pacing controls the concurrency of agents per account to ensure even usage of your subscription budget. This allows you to coordinate multiple hosts and handle concurrent requests without exceeding operational limits.

Do I need SSH and herdr to deploy a coordinator binary across multiple hosts?

Deploying a coordinator binary across multiple hosts requires dependencies like herdr, git, and SSH. This host management process involves adding or removing hosts from the swarm and configuring their required capabilities and capacities.

What is the best way to troubleshoot worker spawning failures and stranded agents in a divybot swarm?

Troubleshooting worker spawning failures and stranded agents involves checking the coordinator service health and addressing credential problems. This Skill identifies and fixes common issues like worker spawning failures, credential problems, and stranded agents.