{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/agent-failure-registry",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-failure-registry",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      ".github/PULL_REQUEST_TEMPLATE.md",
      "CONTRIBUTORS.md",
      "README.md",
      "SKILL.md",
      "examples/belial-puppeteer-detection.yaml",
      "examples/belial-twitter-cookie-expiry.yaml"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/agent-failure-registry",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Failure Registry Skill",
        "body": "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."
      },
      {
        "title": "Quick Start",
        "body": "Search for similar failures:\n\n./scripts/search-registry.sh --category api_failure\n./scripts/search-registry.sh --keyword \"puppeteer\"\n./scripts/search-registry.sh --tag twitter --tag auth\n\nSearch everything:\n\n./scripts/search-registry.sh --all"
      },
      {
        "title": "1. Search — When Things Break",
        "body": "When you encounter an error, search the registry before reinventing the wheel:\n\nBy Category: api_failure, auth_expiry, rate_limit, silent_failure, data_corruption, timeout, logic_error, dependency_break, permission_denied, other\nBy Keywords: Tool names, error messages, symptoms\nBy Tags: Platform, service, technology\n\nThe registry contains post-mortems from examples/ (curated) and submissions/ (community).\n\nSearch Results Include:\n\nSummary of what went wrong\nRoot cause analysis\nFix that worked\nPrevention strategies\nLessons learned"
      },
      {
        "title": "2. Submit — Share Your Pain",
        "body": "When you solve a new failure, help the community:\n\nDocument the failure following the schema\nSubmit via GitHub PR (script can help generate template)\nInclude context — what you tried, what worked, what didn't\n\nRequired Fields:\n\nTitle, category, tags\nSummary, root_cause, fix\nPrevention steps, lessons learned\nConfidence level (1-5)"
      },
      {
        "title": "3. Learn — Stay Ahead",
        "body": "Periodically browse recent submissions to learn from others' failures before you hit them yourself."
      },
      {
        "title": "Script Usage",
        "body": "The search-registry.sh script handles all the heavy lifting:\n\nArguments:\n\n--category CATEGORY — Search specific failure category\n--tag TAG — Search by tag (repeatable)\n--keyword KEYWORD — Free-text search in all fields\n--all — Show all entries (for browsing)\n\nExamples:\n\n# Find authentication issues\n./scripts/search-registry.sh --category auth_expiry\n\n# Find Twitter-related failures\n./scripts/search-registry.sh --tag twitter\n\n# Find Puppeteer issues\n./scripts/search-registry.sh --keyword \"puppeteer\"\n\n# Multiple criteria\n./scripts/search-registry.sh --category api_failure --tag openai\n\n# Browse everything\n./scripts/search-registry.sh --all"
      },
      {
        "title": "Repository Structure",
        "body": "The Agent Failure Registry contains:\n\nexamples/ — Curated failure post-mortems\nsubmissions/ — Community submissions\ntemplate.yaml — Template for new submissions\nschema/postmortem.yaml — Schema validation"
      },
      {
        "title": "Categories Reference",
        "body": "api_failure — API errors, timeouts, invalid responses\nauth_expiry — Authentication/token expiration issues\nrate_limit — Rate limiting, quota exceeded\nsilent_failure — No error thrown, but wrong behavior\ndata_corruption — Data integrity, parsing failures\ntimeout — Operation timeouts, hanging processes\nlogic_error — Flawed reasoning, incorrect assumptions\ndependency_break — External service/lib failures\npermission_denied — Access control, file permissions\nother — Miscellaneous failures"
      },
      {
        "title": "Tips",
        "body": "Before Searching:\n\nExtract key error messages or symptoms\nIdentify the failing component (API, tool, process)\nNote the context (what were you trying to do?)\n\nWhen Submitting:\n\nBe specific about the fix that worked\nInclude what you tried that didn't work\nRate your confidence in the solution (1-5)\nTag with relevant technologies/services\n\nFor Prevention:\n\nReview failures in your domain periodically\nUpdate your error handling based on lessons learned\nShare edge cases and gotchas with the community"
      },
      {
        "title": "Implementation Notes",
        "body": "Registry cloned to /tmp/agent-failure-registry\nUses PyYAML for parsing (with grep fallback)\nSearches both examples/ and submissions/\nOutput formatted for readability\nHandles multiple search criteria\n\nRemember: Every failure is a lesson. Document it, share it, learn from it."
      }
    ],
    "body": "Failure Registry Skill\n\nSearch 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.\n\nQuick Start\n\nSearch for similar failures:\n\n./scripts/search-registry.sh --category api_failure\n./scripts/search-registry.sh --keyword \"puppeteer\"\n./scripts/search-registry.sh --tag twitter --tag auth\n\n\nSearch everything:\n\n./scripts/search-registry.sh --all\n\nUse Cases\n1. Search — When Things Break\n\nWhen you encounter an error, search the registry before reinventing the wheel:\n\nBy Category: api_failure, auth_expiry, rate_limit, silent_failure, data_corruption, timeout, logic_error, dependency_break, permission_denied, other\nBy Keywords: Tool names, error messages, symptoms\nBy Tags: Platform, service, technology\n\nThe registry contains post-mortems from examples/ (curated) and submissions/ (community).\n\nSearch Results Include:\n\nSummary of what went wrong\nRoot cause analysis\nFix that worked\nPrevention strategies\nLessons learned\n2. Submit — Share Your Pain\n\nWhen you solve a new failure, help the community:\n\nDocument the failure following the schema\nSubmit via GitHub PR (script can help generate template)\nInclude context — what you tried, what worked, what didn't\n\nRequired Fields:\n\nTitle, category, tags\nSummary, root_cause, fix\nPrevention steps, lessons learned\nConfidence level (1-5)\n3. Learn — Stay Ahead\n\nPeriodically browse recent submissions to learn from others' failures before you hit them yourself.\n\nScript Usage\n\nThe search-registry.sh script handles all the heavy lifting:\n\nArguments:\n\n--category CATEGORY — Search specific failure category\n--tag TAG — Search by tag (repeatable)\n--keyword KEYWORD — Free-text search in all fields\n--all — Show all entries (for browsing)\n\nExamples:\n\n# Find authentication issues\n./scripts/search-registry.sh --category auth_expiry\n\n# Find Twitter-related failures\n./scripts/search-registry.sh --tag twitter\n\n# Find Puppeteer issues\n./scripts/search-registry.sh --keyword \"puppeteer\"\n\n# Multiple criteria\n./scripts/search-registry.sh --category api_failure --tag openai\n\n# Browse everything\n./scripts/search-registry.sh --all\n\nRepository Structure\n\nThe Agent Failure Registry contains:\n\nexamples/ — Curated failure post-mortems\nsubmissions/ — Community submissions\ntemplate.yaml — Template for new submissions\nschema/postmortem.yaml — Schema validation\nCategories Reference\napi_failure — API errors, timeouts, invalid responses\nauth_expiry — Authentication/token expiration issues\nrate_limit — Rate limiting, quota exceeded\nsilent_failure — No error thrown, but wrong behavior\ndata_corruption — Data integrity, parsing failures\ntimeout — Operation timeouts, hanging processes\nlogic_error — Flawed reasoning, incorrect assumptions\ndependency_break — External service/lib failures\npermission_denied — Access control, file permissions\nother — Miscellaneous failures\nTips\n\nBefore Searching:\n\nExtract key error messages or symptoms\nIdentify the failing component (API, tool, process)\nNote the context (what were you trying to do?)\n\nWhen Submitting:\n\nBe specific about the fix that worked\nInclude what you tried that didn't work\nRate your confidence in the solution (1-5)\nTag with relevant technologies/services\n\nFor Prevention:\n\nReview failures in your domain periodically\nUpdate your error handling based on lessons learned\nShare edge cases and gotchas with the community\nImplementation Notes\nRegistry cloned to /tmp/agent-failure-registry\nUses PyYAML for parsing (with grep fallback)\nSearches both examples/ and submissions/\nOutput formatted for readability\nHandles multiple search criteria\n\nRemember: Every failure is a lesson. Document it, share it, learn from it."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/unleashedbelial/agent-failure-registry",
    "publisherUrl": "https://clawhub.ai/unleashedbelial/agent-failure-registry",
    "owner": "unleashedbelial",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}