# Send Catallax 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. 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. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "catallax",
    "name": "Catallax",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/kai-familiar/catallax",
    "canonicalUrl": "https://clawhub.ai/kai-familiar/catallax",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/catallax",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=catallax",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/NIP-3400.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "catallax",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T06:00:22.819Z",
      "expiresAt": "2026-05-06T06:00:22.819Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=catallax",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=catallax",
        "contentDisposition": "attachment; filename=\"catallax-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "catallax"
      },
      "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/catallax"
    },
    "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/catallax",
    "downloadUrl": "https://openagent3.xyz/downloads/catallax",
    "agentUrl": "https://openagent3.xyz/skills/catallax/agent",
    "manifestUrl": "https://openagent3.xyz/skills/catallax/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/catallax/agent.md"
  }
}
```
## Documentation

### Catallax Skill

Interact with Catallax — a decentralized contract work protocol on Nostr using Lightning/Cashu payments and trusted escrow arbiters.

### Protocol Overview

Read references/NIP-3400.md for the full spec. Key concepts:

Patron: Creates tasks, funds escrow, assigns workers
Arbiter: Escrow agent who judges work and handles payment
Free Agent: Applies for tasks, delivers work, gets paid
Kinds: 33400 (arbiter service), 33401 (task proposal), 3402 (task conclusion)
Status flow: proposed → funded → in_progress → submitted → concluded

### Querying Tasks

Use nak to query kind 33401 events from relays:

# List all task proposals (limit 50)
nak req -k 33401 -l 50 wss://relay.damus.io

# Filter by tag (e.g. tasks tagged "development")
nak req -k 33401 -t development -l 50 wss://relay.damus.io

# Filter by status (open tasks only)
nak req -k 33401 -l 100 wss://relay.damus.io | \\
  while read -r event; do
    status=$(echo "$event" | jq -r '.tags[] | select(.[0]=="status") | .[1]')
    if [ "$status" = "proposed" ] || [ "$status" = "funded" ]; then
      echo "$event"
    fi
  done

Parse the content field as JSON to get title, description, requirements. Parse tags for amount, status, categories.

### Display Format

When presenting tasks to the user, show:

Title (from content.title)
Bounty (from amount tag, in sats — show "?" if missing)
Status (from status tag)
Date (from created_at)
Categories (from t tags)
Description (from content.description, truncated)
Funding type (from funding_type tag: "patron" or "crowdfunding")

### Querying Arbiters

# List arbiter services
nak req -k 33400 -l 50 wss://relay.damus.io

Parse content for name, about, policy. Parse tags for fee_type, fee_amount, min/max amounts, categories.

### Display Format

When presenting arbiters:

Name (from content.name)
Fee (fee_type + fee_amount — e.g. "5%" or "1000 sats flat")
Min/Max (from min_amount/max_amount tags)
Categories (from t tags)
About (from content.about)

### Creating a Task Proposal

To create a task as a Patron, publish a kind 33401 event:

# Build and publish task proposal
nak event -k 33401 \\
  --tag d="<unique-slug>" \\
  --tag p="<your-pubkey>" \\
  --tag amount="<bounty-in-sats>" \\
  --tag t="<category>" \\
  --tag status="proposed" \\
  --tag funding_type="patron" \\
  -c '{"title":"Task Title","description":"Detailed description...","requirements":"What must be delivered"}' \\
  --sec "<nsec>" \\
  wss://relay.damus.io wss://nos.lol wss://relay.primal.net

Generate the d-tag slug from the title (lowercase, hyphenated, with random suffix for uniqueness).

Important: The content field must be valid JSON with title, description, and optionally requirements and deadline.

### Updating Task Status

Since kind 33401 is addressable replaceable, publish a new event with the same d-tag to update. Include all original tags plus changes:

# Update to funded (add zap receipt reference)
nak event -k 33401 \\
  --tag d="<same-d-tag>" \\
  --tag status="funded" \\
  --tag e="<zap-receipt-event-id>" \\
  # ... all other original tags ...
  --sec "<nsec>" \\
  wss://relay.damus.io

### Submitting Work (as Free Agent)

Work delivery is coordinated out-of-band per the protocol. However, agents may use kind 951 (work delivery) as a convention:

nak event -k 951 \\
  --tag e="<task-event-id>" \\
  --tag p="<patron-pubkey>" \\
  -c '{"delivery":"Description of completed work","evidence":"Link or proof"}' \\
  --sec "<nsec>" \\
  wss://relay.damus.io

### Task Conclusion (Arbiter only)

nak event -k 3402 \\
  --tag e="<payout-zap-receipt-id>" \\
  --tag e="<task-event-id>" \\
  --tag p="<patron-pubkey>" \\
  --tag p="<arbiter-pubkey>" \\
  --tag p="<worker-pubkey>" \\
  --tag resolution="successful" \\
  --tag a="33401:<patron-pubkey>:<task-d-tag>" \\
  -c '{"resolution_details":"Work met all requirements"}' \\
  --sec "<nsec>" \\
  wss://relay.damus.io

### Common Queries

User saysAction"find bounties" / "show tasks"Query kind 33401, filter status=proposed or funded"create a task" / "post a bounty"Build and publish kind 33401"find arbiters"Query kind 33400"submit work" / "deliver"Publish kind 951 referencing the task"check my tasks"Query kind 33401 filtered by user's pubkey in p-tags"what's the status"Fetch specific task by d-tag, report status

### Reference Client

For visual browsing: https://catallax-reference-client.netlify.app/catallax

### Key Relays

Query multiple relays for best coverage:

wss://relay.damus.io
wss://nos.lol
wss://relay.primal.net

Note: Some relays may not return results for nak req -k 33401 due to kind filtering. If nak returns empty results, fall back to a WebSocket script approach — open a WebSocket connection, send a REQ with {"kinds":[33401],"limit":50}, and collect EVENT responses until EOSE.

### Edge Cases

Missing amount tag: Some tasks use crowdfunding (funding_type=crowdfunding) with a NIP-75 goal tag instead of a fixed amount. Display bounty as "crowdfunded" in this case.
Content format: Content should be JSON but some early tasks used plain text. Try JSON.parse first, fall back to treating content as description.
Stale tasks: Tasks with status=proposed older than 30 days may be abandoned. Note age when displaying.
Multiple relays: Always publish to 3+ relays for discoverability. Query from multiple relays and deduplicate by event id.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kai-familiar
- Version: 1.0.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-29T06:00:22.819Z
- Expires at: 2026-05-06T06:00:22.819Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/catallax)
- [Send to Agent page](https://openagent3.xyz/skills/catallax/agent)
- [JSON manifest](https://openagent3.xyz/skills/catallax/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/catallax/agent.md)
- [Download page](https://openagent3.xyz/downloads/catallax)