Shipping Cost Optimizer

Analyze ecommerce fulfillment notes across weight, volume, packaging, region, carrier pricing, and free-shipping policy, then turn rough order-cost data into...

Security Scan

The skill's code, instructions, and requirements are consistent with a local, heuristic shipping-cost analysis tool and do not request unexplained credentials, external installs, or hidden network access.

Purpose & Capability

Name/description ask for offline analysis of order and packaging notes; the code parses user-provided text/structures and emits a markdown report. Required env, binaries, and config paths are none — proportional to the stated purpose.

Instruction Scope

SKILL.md restricts the skill to user-provided exports and explicitly disclaims live TMS/carrier/ERP integrations. The handler implementation only reads its own SKILL.md and the provided input; it does not attempt to access unrelated files, network endpoints, or secrets in the visible code.

Install Mechanism

No install spec is provided (instruction-only). The repository includes pure Python code and tests; there are no downloads, package installs, or extract steps that would write or execute remote code.

Credentials

The skill requests no environment variables, credentials, or config paths. The handler does not reference secrets or external service tokens in the provided source.

Persistence & Privilege

The skill is not marked always:true and does not request elevated persistence or modify other skills' configuration. Autonomous invocation is allowed by default (platform behavior) but is not combined with other red flags here.

Assessment

This skill appears to be a local, heuristic report generator that works from user-supplied order/packaging notes. It does not need credentials or perform network calls in the visible code. Before installing: (1) confirm you are comfortable running third-party Python code in your environment; (2) avoid supplying sensitive production data (e.g., full customer records or live credentials) when testing — use representative, anonymized order/cost notes; and (3) if you plan to integrate this into an automated pipeline, review the full handler.py (and any missing parts) to ensure there are no additional network calls or side effects not contained in the files provided.

Overview

Use this skill to convert order-cost notes, packaging specs, carrier rules, and free-shipping policies into a practical logistics cost brief. It is designed for operators who need to reduce fulfillment waste without losing control of delivery experience.

This MVP is heuristic. It does not connect to live TMS, carrier dashboards, ERP systems, or parcel tracking feeds. It relies on the user's exported cost notes, rate summaries, and operational context.

Trigger

Use this skill when the user wants to:

• find the biggest sources of shipping-cost waste
• compare packaging, carrier-routing, threshold, or regional-profitability options
• understand whether free-shipping policy is eroding margin too aggressively
• prepare a logistics cost review for ops, warehouse, finance, or leadership
• turn rough freight and packaging notes into a prioritized test plan

Example prompts

• "Where are we wasting the most money on shipping?"
• "Review packaging and carrier options for our store"
• "Should we raise the free-shipping threshold?"
• "Create a shipping cost reduction brief from these order notes"

Workflow

1. Capture the main tension, such as packaging waste, routing logic, threshold design, or regional loss-making orders.
2. Normalize the likely cost signals: weight, volume, packaging, region, carrier pricing, and surcharge behavior.
3. Separate cost reduction ideas into quick wins versus cross-functional projects.
4. Attach each idea to business impact, delivery-experience risk, and implementation difficulty.
5. Return a markdown shipping-cost report with opportunities, pilot recommendations, and limits.

Inputs

The user can provide any mix of:

• order weight and dimensional notes
• packaging or carton specifications
• carrier pricing or routing notes
• regional mix, remote-surcharge notes, or loss-making zones
• free-shipping thresholds or promotional shipping rules
• brand, speed, damage, or unboxing constraints

Outputs

Return a markdown report with:

• a cost snapshot
• prioritized optimization opportunities
• quick wins versus longer projects
• experience and risk notes
• assumptions and limits

Safety

• Do not claim access to live TMS, carrier dashboards, or ERP systems.
• Keep carrier changes, policy changes, and packaging changes human-approved.
• Do not recommend cost cuts that ignore damage, speed, or premium-brand experience.
• Downgrade certainty when rate cards or regional cost data are incomplete.

Best-fit Scenarios

• ecommerce shipping-cost reviews
• free-shipping threshold and packaging audits
• warehouse, ops, finance, and founder discussions about fulfillment margin
• businesses that need a practical first-pass logistics brief before deeper analysis

Not Ideal For

• real-time carrier routing automation
• parcel tracking or delivery exception handling
• highly specialized cross-border compliance design
• teams with no order-cost or shipping-logic visibility at all

Acceptance Criteria

• Return markdown text.
• Include cost snapshot, opportunity table, pilot plan, and risk notes.
• Distinguish quick wins from longer efforts.
• Keep the brief practical for ops, warehouse, and finance stakeholders.