{
  "schemaVersion": "1.0",
  "item": {
    "slug": "skill-update",
    "name": "Skill Update",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/skill-update",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/skill-update",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/skill-update",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skill-update",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "migrate.md",
      "preview.md"
    ],
    "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. 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. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.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/skill-update"
    },
    "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/skill-update",
    "agentPageUrl": "https://openagent3.xyz/skills/skill-update/agent",
    "manifestUrl": "https://openagent3.xyz/skills/skill-update/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/skill-update/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Safe Skill Updates",
        "body": "Core principle: Never update without user understanding and approval.\n\nUpdates can break things:\n\nChanged file locations → data loss\nRemoved features → broken workflows\nNew requirements → unexpected behavior\nChanged data formats → incompatible state\n\nReferences:\n\nRead preview.md — Diff and impact analysis\nRead migrate.md — Data migration strategies"
      },
      {
        "title": "Update Flow",
        "body": "Check — Are updates available?\nPreview — What changes? How does it affect user?\nExplain — Present changes step-by-step\nConfirm — User explicitly approves\nBackup — Save current state\nUpdate — Apply new version\nVerify — Confirm everything works"
      },
      {
        "title": "Checking for Updates",
        "body": "npx clawhub outdated           # List skills with updates\nnpx clawhub info <slug>        # Show available versions\n\nProactive notification: When user mentions a skill, check if update exists. Mention it once, don't nag."
      },
      {
        "title": "Preview Before Update",
        "body": "⚠️ Never update without showing impact first.\n\nFor each changed file:\n\nShow what's different (added/removed/modified)\nExplain how it affects user's workflow\nFlag breaking changes prominently\n\nBreaking change indicators:\n\nFile/folder structure changes\nRemoved instructions or features\nNew required setup steps\nChanged data format expectations"
      },
      {
        "title": "User Validation",
        "body": "Present changes in digestible format:\n\n\"Skill X has v2.0.0 available. Changes:\n⚠️ Breaking: Config now in config.md (was in SKILL.md)\nAdded: New templates/ folder with examples\nRemoved: Old legacy.md no longer needed\nMigration needed: Your saved preferences need to move.\nI can help migrate. Proceed?\"\n\nOnly update after explicit \"yes\"."
      },
      {
        "title": "Backup Strategy",
        "body": "Before ANY update:\n\nCopy current skill folder to ~/.clawhub/backups/<slug>-<version>-<timestamp>/\nNote the backup location in response\nIf update fails → offer restore"
      },
      {
        "title": "Handling Migrations",
        "body": "When data format changes:\n\nDetect user's current data (preferences, saved state)\nExplain what needs to migrate\nPropose migration steps\nExecute only with approval\nVerify migrated data works\n\nSee migrate.md for patterns."
      },
      {
        "title": "Rollback",
        "body": "If update causes problems:\n\n\"Something's not working? I have a backup from before the update.\nWant me to restore skill X to v1.2.3?\"\n\nKeep backups for at least 7 days or until user confirms new version works.\n\nUpdates should feel safe, not scary. User stays in control."
      }
    ],
    "body": "Safe Skill Updates\n\nCore principle: Never update without user understanding and approval.\n\nUpdates can break things:\n\nChanged file locations → data loss\nRemoved features → broken workflows\nNew requirements → unexpected behavior\nChanged data formats → incompatible state\n\nReferences:\n\nRead preview.md — Diff and impact analysis\nRead migrate.md — Data migration strategies\nUpdate Flow\nCheck — Are updates available?\nPreview — What changes? How does it affect user?\nExplain — Present changes step-by-step\nConfirm — User explicitly approves\nBackup — Save current state\nUpdate — Apply new version\nVerify — Confirm everything works\nChecking for Updates\nnpx clawhub outdated           # List skills with updates\nnpx clawhub info <slug>        # Show available versions\n\n\nProactive notification: When user mentions a skill, check if update exists. Mention it once, don't nag.\n\nPreview Before Update\n\n⚠️ Never update without showing impact first.\n\nFor each changed file:\n\nShow what's different (added/removed/modified)\nExplain how it affects user's workflow\nFlag breaking changes prominently\n\nBreaking change indicators:\n\nFile/folder structure changes\nRemoved instructions or features\nNew required setup steps\nChanged data format expectations\nUser Validation\n\nPresent changes in digestible format:\n\n\"Skill X has v2.0.0 available. Changes:\n\n⚠️ Breaking: Config now in config.md (was in SKILL.md) Added: New templates/ folder with examples Removed: Old legacy.md no longer needed\n\nMigration needed: Your saved preferences need to move. I can help migrate. Proceed?\"\n\nOnly update after explicit \"yes\".\n\nBackup Strategy\n\nBefore ANY update:\n\nCopy current skill folder to ~/.clawhub/backups/<slug>-<version>-<timestamp>/\nNote the backup location in response\nIf update fails → offer restore\nHandling Migrations\n\nWhen data format changes:\n\nDetect user's current data (preferences, saved state)\nExplain what needs to migrate\nPropose migration steps\nExecute only with approval\nVerify migrated data works\n\nSee migrate.md for patterns.\n\nRollback\n\nIf update causes problems:\n\n\"Something's not working? I have a backup from before the update.\nWant me to restore skill X to v1.2.3?\"\n\n\nKeep backups for at least 7 days or until user confirms new version works.\n\nUpdates should feel safe, not scary. User stays in control."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/skill-update",
    "publisherUrl": "https://clawhub.ai/ivangdavila/skill-update",
    "owner": "ivangdavila",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/skill-update",
    "downloadUrl": "https://openagent3.xyz/downloads/skill-update",
    "agentUrl": "https://openagent3.xyz/skills/skill-update/agent",
    "manifestUrl": "https://openagent3.xyz/skills/skill-update/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/skill-update/agent.md"
  }
}