{"id":6401,"plugin_id":"plugin_asdk_app_6a3be8ce7d0c81918cb8bcc8f6d0008e","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T22:48:18.103Z","digest":"065ae3d6df5466d986f4c293f7b8dadfcae2e0b595a4d429057cd19f8a15567e","against":null,"payload":{"name":"shipping-analysis","description":"Analyze shipping costs, compare carriers, optimize package dimensions, and review historical shipping spend via the Shippo API","included_files":[{"relative_path":"shippo/references/address-formats.md","size_in_bytes":4083},{"relative_path":"shippo/references/carrier-guide.md","size_in_bytes":5690},{"relative_path":"shippo/references/csv-format.md","size_in_bytes":5976},{"relative_path":"shippo/references/customs-guide.md","size_in_bytes":9321},{"relative_path":"shippo/references/error-reference.md","size_in_bytes":11389},{"relative_path":"shippo/references/international-shipping.md","size_in_bytes":6910},{"relative_path":"shippo/references/label-formats.md","size_in_bytes":2825},{"relative_path":"shippo/references/rate-shopping-guide.md","size_in_bytes":4320},{"relative_path":"shippo/references/response-envelope.md","size_in_bytes":1184},{"relative_path":"shippo/references/tool-reference.md","size_in_bytes":15981}],"skill_md_contents":"---\nname: shipping-analysis\ndescription: Analyze shipping costs, compare carriers, optimize package dimensions, and review historical shipping spend via the Shippo API\nmetadata:\n  version: \"1.5.2\"\n---\n\n# Shipping Analysis and Optimization\n\n## Geographic Cost Analysis\n\n1. Confirm origin address, destination list (or use representative cities), and parcel details.\n2. Call `ListCarrierAccounts` to see configured carriers.\n3. Call `CreateShipment` per destination to collect rates. Creating shipments is free; only `CreateTransaction` costs money.\n4. Write results to `analysis/` directory (markdown report + CSV). Columns: Route, Destination, Carrier, Service, Cost, Currency, EstimatedDays, Zone.\n\n---\n\n## Package Optimization\n\n1. Confirm the route.\n2. Define dimension profiles to test (or use user-provided ones).\n3. Check `ListCarrierParcelTemplates` and `ListUserParcelTemplates` for flat-rate and saved templates. See `shippo/references/rate-shopping-guide.md` for dimensional weight and flat-rate guidance.\n4. Call `CreateShipment` per profile on the same route.\n5. Compare: cheapest rate, carrier options, fastest option per profile. Note where flat-rate templates beat custom dimensions and where dimensional weight causes price jumps. See `shippo/references/carrier-guide.md` for carrier-specific weight limits and surcharges.\n\n---\n\n## Carrier Comparison\n\n1. Call `CreateShipment` for the route.\n2. Group the `rates` array by `provider`.\n3. Per carrier: cheapest service, fastest service, number of service levels, price range.\n\n---\n\n## Historical Cost Optimization\n\n1. Call `ListShipments` and `ListTransactions` to get past activity.\n2. Cross-reference: what the user paid vs. what alternatives were available.\n3. Identify patterns: carrier concentration, service-level mismatch, consistent overpayment.\n4. For a sample of shipments with tracking numbers, call `GetTrack` to check actual vs. estimated delivery times.\n5. If fewer than 5 successful transactions exist (not just shipments -- shipments are rate quotes, transactions represent actual spend), redirect to forward-looking analysis.\n\n---\n\n## Output Conventions\n\nWrite reports to the `analysis/` directory. Create it if it does not exist. Include both markdown and CSV. CSV must have a header row. Markdown must include a timestamp and input parameters.\n\n---\n\n## Quick Reference\n\n**Cost analysis:**\n`ListCarrierAccounts` -> `CreateShipment` (per destination) -> read `rates` arrays -> write report\n\n**Carrier comparison:**\n`CreateShipment` -> group `rates` by `provider` -> summarize\n\n**Historical review:**\n`ListShipments` + `ListTransactions` -> cross-reference -> `GetTrack` (sample) -> write report\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}