bug-triage

A bug-investigation workflow for checking reports, finding duplicate GitHub issues, and preparing fixes for the Agent Orchestrator project, which uses Go and Electron.

In plain words
What is it for?
Use it to inspect bugs reported in chat or issues, confirm which Agent Orchestrator binary is running, create or update GitHub issues, and push pull requests with fixes.
Why use it?
It helps prevent reports based on the wrong program or runtime from wasting time. Each issue can include the technical context needed to investigate it.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/untrivial-ai/agent-orchestrator/bug-triage
Any agent
npx skills add Untrivial-ai/agent-orchestrator --skill bug-triage
Clone the repo
git clone --depth 1 https://github.com/Untrivial-ai/agent-orchestrator

Made for: Claude Code, Codex.

Per session 33 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,611 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00033 $0.04611
Opus 5 $0.00016 $0.02305
Sonnet 5 $0.00007 $0.00922
Haiku 4.5 $0.00003 $0.00461

Measured yesterday against content hash 2c6df9861f08, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

bug-triage scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/push_fix_to_github.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/bug-triage/SKILL.md · 422 lines

How it starts

The opening of the file, as written. The whole thing — 422 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Bug Triage Skill

Triage bugs into well-structured GitHub issues on the Agent Orchestrator repo.

Agent Orchestrator is Go + Electron. The backend is a Go daemon (backend/) exposing a loopback HTTP API on 127.0.0.1:3001; the frontend is an Electron + React supervisor (frontend/). There is no pm2/tmux/Node runtime here — the daemon owns lifecycle and sessions run under the Zellij runtime adapter. Triage against this stack, not the old TypeScript agent-orchestrator.

⚠️ Which ao are you running?

Agent Orchestrator ships no ao on your PATH. A bare ao very likely resolves to a different AO install — e.g. an old npm build at ~/.nvm/.../bin/ao that talks to port :3000. Triaging with the wrong binary produces bugs that don't exist in Agent Orchestrator (and miss ones that do).

Before any diagnostics:

which -a ao                      # see every ao on PATH — expect surprises
ao status 2>/dev/null            # if this shows port 3000, it is NOT Agent Orchestrator

Use an Agent Orchestrator binary explicitly:

# Option A — build from this repo (preferred during triage)
cd backend && go build -o /tmp/ao ./cmd/ao
/tmp/ao status                   # must report port: 3001

# Option B — the packaged app's bundled daemon
"/Applications/Agent Orchestrator.app/Contents/Resources/daemon/ao" status

Confirm ao status reports port: 3001 before trusting any output. Throughout this skill, ao means your verified Agent Orchestrator binary (/tmp/ao or the bundled one), never a bare PATH lookup.

Note: spawned sessions get a PATH pin so the session's ao resolves to the daemon's own executable (see hookPATH in backend/internal/session_manager/manager.go). That pin only applies inside sessions — your interactive shell is still on its own PATH, so pin it yourself.

1. Pre-flight

  • Pull latest code: git pull origin main. Stale code = bad triage.
  • Target repo: Always file on Untrivial-ai/agent-orchestrator (the current product repo, not a fork). Agent Orchestrator is the product, not a thin fork of upstream.
  • Verify your binary: confirm ao status shows port 3001 (see warning above).
  • Record source: chat URL, reporter name, attachments.

Read the full file on GitHub · 422 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 422 lines · 33 tokens per session scan A 2c6df9861f08

Subscribe to this mod's changes

bug-triage is a skill published in the GitHub repository Untrivial-ai/agent-orchestrator (10,763 stars, last pushed today), licensed Apache-2.0. It adds 33 tokens to every session and 4,611 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

bernstein-run

Run a verified multi-agent goal with Bernstein. Use when a task is too large for a single agent session: Bernstein decomposes the goal into tasks, spawns CLI coding agents in parallel git worktrees, verifies their output, and merges results. Also use to check run status, costs, and to verify a finished run against its…

sipyourdrink-ltd/bernstein · 75 tokens

bernstein-plan

Create and manage multi-step execution plans in Bernstein. Plans decompose complex goals into stages with dependencies. Use when the user wants to plan a complex feature, break down a large task, or review an execution plan before agents start working.

sipyourdrink-ltd/bernstein · 51 tokens

bernstein-agents

Manage Bernstein agents - list active agents, inspect their output, kill stalled agents, or stream live logs. Use when the user asks about agents, wants to see what an agent is doing, or needs to kill one.

sipyourdrink-ltd/bernstein · 49 tokens

bernstein-approve

Review and approve/reject pending tasks or plans in Bernstein. Use when the user asks about approvals, wants to review agent work, or needs to approve/reject a plan before execution begins.

sipyourdrink-ltd/bernstein · 43 tokens

bernstein-quality

Show quality metrics for Bernstein runs - success rates per model, lint/test pass rates, completion time distributions. Use when the user asks about quality, reliability, which model performs best, or pass rates.

sipyourdrink-ltd/bernstein · 44 tokens

manager

Planning - decompose goals, create tasks via task server.

sipyourdrink-ltd/bernstein · 14 tokens