# Send Failure Registry 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": "agent-failure-registry",
    "name": "Failure Registry",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/unleashedbelial/agent-failure-registry",
    "canonicalUrl": "https://clawhub.ai/unleashedbelial/agent-failure-registry",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/agent-failure-registry",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-failure-registry",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      ".github/PULL_REQUEST_TEMPLATE.md",
      "CONTRIBUTORS.md",
      "README.md",
      "SKILL.md",
      "examples/belial-puppeteer-detection.yaml",
      "examples/belial-twitter-cookie-expiry.yaml"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "agent-failure-registry",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T21:29:06.316Z",
      "expiresAt": "2026-05-06T21:29:06.316Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-failure-registry",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-failure-registry",
        "contentDisposition": "attachment; filename=\"agent-failure-registry-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "agent-failure-registry"
      },
      "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/agent-failure-registry"
    },
    "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/agent-failure-registry",
    "downloadUrl": "https://openagent3.xyz/downloads/agent-failure-registry",
    "agentUrl": "https://openagent3.xyz/skills/agent-failure-registry/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agent-failure-registry/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agent-failure-registry/agent.md"
  }
}
```
## Documentation

### Failure Registry Skill

Search and learn from the Agent Failure Registry — a community-driven database of agent failures, solutions, and lessons learned. When you hit a wall, check if someone else already climbed it.

### Quick Start

Search for similar failures:

./scripts/search-registry.sh --category api_failure
./scripts/search-registry.sh --keyword "puppeteer"
./scripts/search-registry.sh --tag twitter --tag auth

Search everything:

./scripts/search-registry.sh --all

### 1. Search — When Things Break

When you encounter an error, search the registry before reinventing the wheel:

By Category: api_failure, auth_expiry, rate_limit, silent_failure, data_corruption, timeout, logic_error, dependency_break, permission_denied, other
By Keywords: Tool names, error messages, symptoms
By Tags: Platform, service, technology

The registry contains post-mortems from examples/ (curated) and submissions/ (community).

Search Results Include:

Summary of what went wrong
Root cause analysis
Fix that worked
Prevention strategies
Lessons learned

### 2. Submit — Share Your Pain

When you solve a new failure, help the community:

Document the failure following the schema
Submit via GitHub PR (script can help generate template)
Include context — what you tried, what worked, what didn't

Required Fields:

Title, category, tags
Summary, root_cause, fix
Prevention steps, lessons learned
Confidence level (1-5)

### 3. Learn — Stay Ahead

Periodically browse recent submissions to learn from others' failures before you hit them yourself.

### Script Usage

The search-registry.sh script handles all the heavy lifting:

Arguments:

--category CATEGORY — Search specific failure category
--tag TAG — Search by tag (repeatable)
--keyword KEYWORD — Free-text search in all fields
--all — Show all entries (for browsing)

Examples:

# Find authentication issues
./scripts/search-registry.sh --category auth_expiry

# Find Twitter-related failures
./scripts/search-registry.sh --tag twitter

# Find Puppeteer issues
./scripts/search-registry.sh --keyword "puppeteer"

# Multiple criteria
./scripts/search-registry.sh --category api_failure --tag openai

# Browse everything
./scripts/search-registry.sh --all

### Repository Structure

The Agent Failure Registry contains:

examples/ — Curated failure post-mortems
submissions/ — Community submissions
template.yaml — Template for new submissions
schema/postmortem.yaml — Schema validation

### Categories Reference

api_failure — API errors, timeouts, invalid responses
auth_expiry — Authentication/token expiration issues
rate_limit — Rate limiting, quota exceeded
silent_failure — No error thrown, but wrong behavior
data_corruption — Data integrity, parsing failures
timeout — Operation timeouts, hanging processes
logic_error — Flawed reasoning, incorrect assumptions
dependency_break — External service/lib failures
permission_denied — Access control, file permissions
other — Miscellaneous failures

### Tips

Before Searching:

Extract key error messages or symptoms
Identify the failing component (API, tool, process)
Note the context (what were you trying to do?)

When Submitting:

Be specific about the fix that worked
Include what you tried that didn't work
Rate your confidence in the solution (1-5)
Tag with relevant technologies/services

For Prevention:

Review failures in your domain periodically
Update your error handling based on lessons learned
Share edge cases and gotchas with the community

### Implementation Notes

Registry cloned to /tmp/agent-failure-registry
Uses PyYAML for parsing (with grep fallback)
Searches both examples/ and submissions/
Output formatted for readability
Handles multiple search criteria

Remember: Every failure is a lesson. Document it, share it, learn from it.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: unleashedbelial
- 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-29T21:29:06.316Z
- Expires at: 2026-05-06T21:29:06.316Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/agent-failure-registry)
- [Send to Agent page](https://openagent3.xyz/skills/agent-failure-registry/agent)
- [JSON manifest](https://openagent3.xyz/skills/agent-failure-registry/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/agent-failure-registry/agent.md)
- [Download page](https://openagent3.xyz/downloads/agent-failure-registry)