> ## Documentation Index
> Fetch the complete documentation index at: https://www.productmetrics.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://www.productmetrics.io/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://www.productmetrics.io/docs/api/mcp.
> Every agent surface: https://www.productmetrics.io/docs/.well-known/llms-manifest.json

# check-stock-and-returns skill (/docs/agent-skills/check-stock-and-returns)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 859 · updated: 2026-11-17 -->
Related: [Product Metrics agent skills](/docs/agent-skills/overview.md), [Install Product Metrics skills](/docs/agent-skills/install.md), [Skills for every store platform and ad channel](/docs/agent-skills/platform-skills.md), [product-metrics: the agent skill that picks the right Product Metrics skill](/docs/agent-skills/product-metrics.md), [set-up-tracking skill](/docs/agent-skills/set-up-tracking.md), [connect-google-ads skill](/docs/agent-skills/connect-google-ads.md)

> 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](https://github.com/product-metrics/skills/blob/main/plugins/product-metrics/skills/check-stock-and-returns/SKILL.md) or at [`/.well-known/agent-skills/check-stock-and-returns/SKILL.md`](https://www.productmetrics.io/docs/.well-known/agent-skills/check-stock-and-returns/SKILL.md).



```bash
npx 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

```text
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.

## Where next



* [find-unprofitable-products skill](/docs/agent-skills/find-unprofitable-products): products that lose money after ads
* [check-product-segments skill](/docs/agent-skills/check-product-segments): what each segment holds, read only
* [MCP tools](/docs/mcp/tools#get_inventory_state): the inventory and insight tools
