# Send Arbiter to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "arbiter",
    "name": "Arbiter",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/5hanth/arbiter",
    "canonicalUrl": "https://clawhub.ai/5hanth/arbiter",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/arbiter",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=arbiter",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "package.json",
      "scripts/get.sh",
      "scripts/push.sh",
      "scripts/status.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "arbiter",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T01:42:55.362Z",
      "expiresAt": "2026-05-06T01:42:55.362Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=arbiter",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=arbiter",
        "contentDisposition": "attachment; filename=\"arbiter-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "arbiter"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/arbiter"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/arbiter",
    "downloadUrl": "https://openagent3.xyz/downloads/arbiter",
    "agentUrl": "https://openagent3.xyz/skills/arbiter/agent",
    "manifestUrl": "https://openagent3.xyz/skills/arbiter/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/arbiter/agent.md"
  }
}
```
## Documentation

### Arbiter Skill

Push decisions to Arbiter Zebu for async human review. Use when you need human input on plans, architectural choices, or approval before proceeding.

### Installation

Quick install via ClawHub:

clawhub install arbiter

Or via bun (makes CLI commands available globally):

bun add -g arbiter-skill

Or manual:

git clone https://github.com/5hanth/arbiter-skill.git
cd arbiter-skill && npm install && npm run build
ln -s $(pwd) ~/.clawdbot/skills/arbiter

### Prerequisites

Arbiter Zebu bot running (or just bunx arbiter-zebu)
~/.arbiter/queue/ directory (created automatically by the bot)

### Environment Variables

Set these in your agent's environment for automatic agent/session detection:

VariableDescriptionExampleCLAWDBOT_AGENTAgent IDceo, swe1CLAWDBOT_SESSIONSession keyagent:ceo:main

### When to Use

Plan review before implementation
Architectural decisions with tradeoffs
Anything blocking that needs human judgment
Multiple related decisions as a batch

Do NOT use for:

Simple yes/no that doesn't need explanation
Urgent real-time decisions (use direct message instead)
Technical questions you can research yourself

### arbiter_push

Create a decision plan for human review.

CLI: arbiter-push '<json>' — takes a single JSON argument containing all fields.

arbiter-push '{
  "title": "API Design Decisions",
  "tag": "nft-marketplace",
  "context": "SWE2 needs these decided before API work",
  "priority": "normal",
  "notify": "agent:swe2:main",
  "decisions": [
    {
      "id": "auth-strategy",
      "title": "Auth Strategy", 
      "context": "How to authenticate admin users",
      "options": [
        {"key": "jwt", "label": "JWT tokens", "note": "Stateless"},
        {"key": "session", "label": "Sessions", "note": "More control"},
        {"key": "oauth", "label": "OAuth", "note": "External provider"}
      ]
    },
    {
      "id": "database",
      "title": "Database Choice",
      "context": "Primary datastore",
      "options": [
        {"key": "postgresql", "label": "PostgreSQL + JSONB"},
        {"key": "mongodb", "label": "MongoDB"}
      ],
      "allowCustom": true
    }
  ]
}'

JSON Fields:

FieldRequiredDescriptiontitleYesPlan titletagNoTag for filtering (e.g., project name)contextNoBackground for reviewerpriorityNolow, normal, high, urgent (default: normal)notifyNoSession to notify when completeagentNoAgent ID (auto-detected from CLAWDBOT_AGENT env)sessionNoSession key (auto-detected from CLAWDBOT_SESSION env)decisionsYesArray of decisions

Decision object:

FieldRequiredDescriptionidYesUnique ID within plantitleYesDecision titlecontextNoExplanation for revieweroptionsYesArray of {key, label, note?}allowCustomNoAllow free-text answer (default: false)defaultNoSuggested option key

Returns:

{
  "planId": "abc123",
  "file": "~/.arbiter/queue/pending/ceo-api-design-abc123.md",
  "total": 2,
  "status": "pending"
}

### arbiter_status

Check the status of a decision plan.

CLI: arbiter-status <plan-id> or arbiter-status --tag <tag>

arbiter-status abc12345
# or
arbiter-status --tag nft-marketplace

Returns:

{
  "planId": "abc123",
  "title": "API Design Decisions",
  "status": "in_progress",
  "total": 3,
  "answered": 1,
  "remaining": 2,
  "decisions": {
    "auth-strategy": {"status": "answered", "answer": "jwt"},
    "database": {"status": "pending", "answer": null},
    "caching": {"status": "pending", "answer": null}
  }
}

### arbiter_get

Get answers from a completed plan.

CLI: arbiter-get <plan-id> or arbiter-get --tag <tag>

arbiter-get abc12345
# or
arbiter-get --tag nft-marketplace

Returns:

{
  "planId": "abc123",
  "status": "completed",
  "completedAt": "2026-01-30T01:45:00Z",
  "answers": {
    "auth-strategy": "jwt",
    "database": "postgresql",
    "caching": "redis"
  }
}

Error if not complete:

{
  "error": "Plan not complete",
  "status": "in_progress",
  "remaining": 2
}

### arbiter_await

Block until plan is complete (with timeout).

arbiter-await abc12345 --timeout 3600

Polls every 30 seconds until complete or timeout.

Returns: Same as arbiter_get on completion.

### Example 1: Plan Review

# Push plan decisions (single JSON argument)
RESULT=$(arbiter-push '{"title":"Clean IT i18n Plan","tag":"clean-it","priority":"high","notify":"agent:swe3:main","decisions":[{"id":"library","title":"i18n Library","options":[{"key":"i18next","label":"i18next"},{"key":"formatjs","label":"FormatJS"}]},{"id":"keys","title":"Key Structure","options":[{"key":"flat","label":"Flat (login.button)"},{"key":"nested","label":"Nested ({login:{button}})"}]}]}')

PLAN_ID=$(echo $RESULT | jq -r '.planId')
echo "Pushed plan $PLAN_ID — waiting for human review"

### Example 2: Check and Proceed

# Check if decisions are ready
STATUS=$(arbiter-status --tag nft-marketplace)

if [ "$(echo $STATUS | jq -r '.status')" == "completed" ]; then
  ANSWERS=$(arbiter-get --tag nft-marketplace)
  AUTH=$(echo $ANSWERS | jq -r '.answers["auth-strategy"]')
  echo "Using auth strategy: $AUTH"
  # Proceed with implementation
else
  echo "Still waiting for $(echo $STATUS | jq -r '.remaining') decisions"
fi

### Example 3: Blocking Wait

# Wait up to 1 hour for decisions
ANSWERS=$(arbiter-await abc12345 --timeout 3600)

if [ $? -eq 0 ]; then
  # Got answers, proceed
  echo "Decisions ready: $ANSWERS"
else
  echo "Timeout waiting for decisions"
fi

### Best Practices

Batch related decisions — Don't push one at a time
Provide context — Human needs to understand tradeoffs
Use tags — Makes filtering easy (--tag project-name)
Set notify — So blocked agents get woken up
Use priority sparingly — Reserve urgent for true blockers

### File Locations

PathPurpose~/.arbiter/queue/pending/Plans awaiting review~/.arbiter/queue/completed/Answered plans (archive)~/.arbiter/queue/notify/Agent notifications

### Checking Notifications (Agent Heartbeat)

In your HEARTBEAT.md, add:

## Check Arbiter Notifications

1. Check if \`~/.arbiter/queue/notify/\` has files for my session
2. If yes, read answers and proceed with blocked work
3. Delete notification file after processing

### Troubleshooting

IssueSolutionPlan not showing in ArbiterCheck file is valid YAML frontmatterAnswers not appearingCheck arbiter_status, may be incompleteNotification not receivedEnsure --notify was set correctly

### See Also

Arbiter Zebu Architecture
Arbiter Zebu Bot
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: 5hanth
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T01:42:55.362Z
- Expires at: 2026-05-06T01:42:55.362Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/arbiter)
- [Send to Agent page](https://openagent3.xyz/skills/arbiter/agent)
- [JSON manifest](https://openagent3.xyz/skills/arbiter/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/arbiter/agent.md)
- [Download page](https://openagent3.xyz/downloads/arbiter)