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.
Stock risk while advertising, reorder dates, slow movers and returns per category.
The CLI inventory and insights commands, or the MCP tools get_inventory_state and get_poas_report.
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-returnsWhen 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
| Step | CLI / MCP |
|---|---|
| Stock while advertised | MCP get_poas_report (stock), list_products_to_investigate (signal_kinds) |
| Reorder and slow movers | productmetrics inventory get-state (inventory.get_state), MCP get_inventory_state |
| Stars about to run out, returns per category | productmetrics insights get (dashboard_run_out, category_returns, save_settings_stock), MCP get_insights |
| Lead time and safety buffer | productmetrics inventory-settings get, productmetrics inventory-settings update (inventory_settings.update, after you confirm) |
Stock, orders and inventory need Pro.