Skip to content
Available skills

check-stock-and-returns skill

The skill an agent uses to find products advertised while out of stock, reorder dates, slow movers and return rates per category, and to set lead times after you confirm them.

check-stock-and-returns sets your stock and product returns next to your ads: products advertised while they run out, what to reorder and when, slow movers, and return rates per category. It reads stock from your connected shop. The only change it makes is a lead time or safety buffer you confirm; it never orders stock or pauses anything.

Use it for

Stock risk while advertising, reorder dates, slow movers and returns per category.

Works through

The CLI inventory and insights commands, or the MCP tools get_inventory_state and get_poas_report.

You get

The products to act on, with stock, cover and dates, and options to increase or lower priority.

The skill

Full file: on GitHub or at /.well-known/agent-skills/check-stock-and-returns/SKILL.md.

pnpm dlx skills add product-metrics/skills \
  --skill check-stock-and-returns

When an agent uses it

  • “Are we advertising products we can’t deliver?”
  • “What do I need to reorder before Black Friday?”
  • “Which categories have the most returns?”

Example conversation

You:    Are we advertising anything that's about to run out?
Agent:  get_poas_report (stock: "at_risk", last_30_days)
        5 advertised products are out of stock or at risk.
        Merino Socks: 14 on hand, 1.2 weeks of cover, lead time 3 weeks,
          stockout 24 Nov, reorder now: 120 units suggested.

        Options: lower priority on Merino Socks until stock arrives,
        or reorder what the planner suggests. You decide.

Example data.

Commands and tools it uses

StepCLI / MCP
Stock while advertisedMCP get_poas_report (stock), list_products_to_investigate (signal_kinds)
Reorder and slow moversproductmetrics inventory get-state (inventory.get_state), MCP get_inventory_state
Stars about to run out, returns per categoryproductmetrics insights get (dashboard_run_out, category_returns, save_settings_stock), MCP get_insights
Lead time and safety bufferproductmetrics inventory-settings get, productmetrics inventory-settings update (inventory_settings.update, after you confirm)

Stock, orders and inventory need Pro.

Where next