{
  "schemaVersion": "1.0",
  "item": {
    "slug": "shipping",
    "name": "Shipping Operations",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/ivangdavila/shipping",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/shipping",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/shipping",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shipping",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "carrier-selection.md",
      "exception-playbook.md",
      "international-customs.md",
      "memory-template.md",
      "setup.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-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-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/shipping"
    },
    "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/shipping",
    "agentPageUrl": "https://openagent3.xyz/skills/shipping/agent",
    "manifestUrl": "https://openagent3.xyz/skills/shipping/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/shipping/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": "Setup",
        "body": "On first use, read setup.md for integration guidelines."
      },
      {
        "title": "When to Use",
        "body": "User needs to ship physical goods and wants reliable decisions across rates, packaging, customs, tracking, and delivery issues. Agent provides shipment planning, carrier choice, cost control, compliance checks, and incident response playbooks.\n\nThis skill is advisory and workflow-focused. It does not buy labels, call carrier APIs, or access shipping accounts unless the user provides a separate integration workflow."
      },
      {
        "title": "Architecture",
        "body": "Memory lives in ~/shipping/. See memory-template.md for structure and status fields.\n\n~/shipping/\n|- memory.md             # Durable shipping context and preferences\n|- carrier-rules.md      # Preferred carriers and service constraints\n|- international.md      # Country and customs notes\n`- incidents.md          # Repeated failure patterns and resolutions"
      },
      {
        "title": "Quick Reference",
        "body": "Use the smallest relevant file for the current task.\n\nTopicFileSetup flowsetup.mdMemory templatememory-template.mdCarrier selectioncarrier-selection.mdInternational customsinternational-customs.mdDelivery exception handlingexception-playbook.md"
      },
      {
        "title": "1. Confirm Shipment Profile First",
        "body": "Before recommending any option, confirm:\n\nOrigin and destination\nPackage count, dimensions, and weight\nDelivery deadline and budget ceiling\nValue, fragility, and regulatory constraints\n\nNever optimize blind."
      },
      {
        "title": "2. Price for Total Landed Cost",
        "body": "Always show total cost, not just carrier label price:\n\nTransport fee\nPackaging and handling\nFuel, remote, residential, signature, and insurance surcharges\nDuties, taxes, and brokerage where applicable\n\nIf any component is unknown, mark it as estimate and show risk."
      },
      {
        "title": "3. Select Carrier by SLA Risk, Not Sticker Price",
        "body": "Pick service based on the real failure cost:\n\nTime-critical shipment: prioritize reliability and claims process\nLow-value shipment: prioritize cost efficiency\nInternational shipment: prioritize customs support and tracking depth\n\nState tradeoffs explicitly before final recommendation."
      },
      {
        "title": "4. Validate Compliance Before Label Purchase",
        "body": "For cross-border shipments, verify:\n\nCommodity description and HS code quality\nDeclared value consistency with invoice\nProhibited or restricted item checks\nIncoterm and importer responsibilities\n\nDo not proceed when documentation is incomplete."
      },
      {
        "title": "5. Run Tracking Checkpoints Proactively",
        "body": "Set checkpoints at minimum for:\n\nLabel created but not scanned within 24h\nCustoms hold or pending documents\nOut for delivery delays beyond promised window\n\nFor each checkpoint, provide next action and owner."
      },
      {
        "title": "6. Treat Exceptions as Playbooks, Not Improvisation",
        "body": "Use a defined response path for lost, damaged, delayed, returned, or refused shipments:\n\nCapture facts and evidence first\nNotify customer with realistic timeline\nOpen claim/escalation within carrier deadline\nDecide reshipment vs refund based on cost and SLA"
      },
      {
        "title": "7. Save Reusable Shipping Intelligence",
        "body": "After each meaningful case, update memory with:\n\nCarrier performance by route\nRecurring surcharge patterns\nPackaging failures and fixes\nCountry-specific documentation pitfalls\n\nThis turns shipping from reactive to compounding."
      },
      {
        "title": "Common Traps",
        "body": "Comparing rates without normalizing surcharges -> false savings and margin loss.\nGuessing box size from product photos -> dimensional weight surprises.\nDeclaring vague item descriptions -> customs holds and rejections.\nPromising delivery dates without scan confirmation -> avoidable support escalations.\nFiling claims without evidence package -> denied reimbursement.\nTreating every delay as carrier fault -> misses internal pick-pack bottlenecks."
      },
      {
        "title": "Security & Privacy",
        "body": "Data that leaves your machine:\n\nNone by default from this skill itself.\n\nData that stays local:\n\nShipping context and learned patterns under ~/shipping/.\n\nThis skill does NOT:\n\nAccess undeclared external services automatically.\nBuy labels or place shipping orders automatically.\nRetrieve tracking events from carrier APIs automatically.\nStore payment credentials or full card data.\nModify files outside ~/shipping/ for memory."
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\necommerce - Store operations and conversion workflows.\nmarketplace - Multi-platform selling and fulfillment strategy.\ninventory - Stock planning and replenishment control.\nsell - Listing, pricing, and sales execution.\nbuy - Purchasing decisions and supplier-side evaluation."
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star shipping\nStay updated: clawhub sync"
      }
    ],
    "body": "Setup\n\nOn first use, read setup.md for integration guidelines.\n\nWhen to Use\n\nUser needs to ship physical goods and wants reliable decisions across rates, packaging, customs, tracking, and delivery issues. Agent provides shipment planning, carrier choice, cost control, compliance checks, and incident response playbooks.\n\nThis skill is advisory and workflow-focused. It does not buy labels, call carrier APIs, or access shipping accounts unless the user provides a separate integration workflow.\n\nArchitecture\n\nMemory lives in ~/shipping/. See memory-template.md for structure and status fields.\n\n~/shipping/\n|- memory.md             # Durable shipping context and preferences\n|- carrier-rules.md      # Preferred carriers and service constraints\n|- international.md      # Country and customs notes\n`- incidents.md          # Repeated failure patterns and resolutions\n\nQuick Reference\n\nUse the smallest relevant file for the current task.\n\nTopic\tFile\nSetup flow\tsetup.md\nMemory template\tmemory-template.md\nCarrier selection\tcarrier-selection.md\nInternational customs\tinternational-customs.md\nDelivery exception handling\texception-playbook.md\nCore Rules\n1. Confirm Shipment Profile First\n\nBefore recommending any option, confirm:\n\nOrigin and destination\nPackage count, dimensions, and weight\nDelivery deadline and budget ceiling\nValue, fragility, and regulatory constraints\n\nNever optimize blind.\n\n2. Price for Total Landed Cost\n\nAlways show total cost, not just carrier label price:\n\nTransport fee\nPackaging and handling\nFuel, remote, residential, signature, and insurance surcharges\nDuties, taxes, and brokerage where applicable\n\nIf any component is unknown, mark it as estimate and show risk.\n\n3. Select Carrier by SLA Risk, Not Sticker Price\n\nPick service based on the real failure cost:\n\nTime-critical shipment: prioritize reliability and claims process\nLow-value shipment: prioritize cost efficiency\nInternational shipment: prioritize customs support and tracking depth\n\nState tradeoffs explicitly before final recommendation.\n\n4. Validate Compliance Before Label Purchase\n\nFor cross-border shipments, verify:\n\nCommodity description and HS code quality\nDeclared value consistency with invoice\nProhibited or restricted item checks\nIncoterm and importer responsibilities\n\nDo not proceed when documentation is incomplete.\n\n5. Run Tracking Checkpoints Proactively\n\nSet checkpoints at minimum for:\n\nLabel created but not scanned within 24h\nCustoms hold or pending documents\nOut for delivery delays beyond promised window\n\nFor each checkpoint, provide next action and owner.\n\n6. Treat Exceptions as Playbooks, Not Improvisation\n\nUse a defined response path for lost, damaged, delayed, returned, or refused shipments:\n\nCapture facts and evidence first\nNotify customer with realistic timeline\nOpen claim/escalation within carrier deadline\nDecide reshipment vs refund based on cost and SLA\n7. Save Reusable Shipping Intelligence\n\nAfter each meaningful case, update memory with:\n\nCarrier performance by route\nRecurring surcharge patterns\nPackaging failures and fixes\nCountry-specific documentation pitfalls\n\nThis turns shipping from reactive to compounding.\n\nCommon Traps\nComparing rates without normalizing surcharges -> false savings and margin loss.\nGuessing box size from product photos -> dimensional weight surprises.\nDeclaring vague item descriptions -> customs holds and rejections.\nPromising delivery dates without scan confirmation -> avoidable support escalations.\nFiling claims without evidence package -> denied reimbursement.\nTreating every delay as carrier fault -> misses internal pick-pack bottlenecks.\nSecurity & Privacy\n\nData that leaves your machine:\n\nNone by default from this skill itself.\n\nData that stays local:\n\nShipping context and learned patterns under ~/shipping/.\n\nThis skill does NOT:\n\nAccess undeclared external services automatically.\nBuy labels or place shipping orders automatically.\nRetrieve tracking events from carrier APIs automatically.\nStore payment credentials or full card data.\nModify files outside ~/shipping/ for memory.\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\necommerce - Store operations and conversion workflows.\nmarketplace - Multi-platform selling and fulfillment strategy.\ninventory - Stock planning and replenishment control.\nsell - Listing, pricing, and sales execution.\nbuy - Purchasing decisions and supplier-side evaluation.\nFeedback\nIf useful: clawhub star shipping\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/shipping",
    "publisherUrl": "https://clawhub.ai/ivangdavila/shipping",
    "owner": "ivangdavila",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/shipping",
    "downloadUrl": "https://openagent3.xyz/downloads/shipping",
    "agentUrl": "https://openagent3.xyz/skills/shipping/agent",
    "manifestUrl": "https://openagent3.xyz/skills/shipping/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/shipping/agent.md"
  }
}