> ## 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-product-segments skill (/docs/agent-skills/check-product-segments)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 945 · 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 read-only skill an agent uses to explain your Product Segmentation segments, what each holds, the budget on Drainers and why a product changed segment.

**`check-product-segments` explains your six product segments with real figures: what each holds, how much revenue and budget it carries, and why a product moved.** Product Metrics machine learning segments every product on profitability, stock, product returns, potential and competitor prices, and writes the segment to a custom label for Shopping and Performance Max. The skill only reads.



* **Use it for:** Questions about Stars, Question Marks, Cash Cows, Dogs, Drainers and Ghosts.
* **Works through:** The MCP tools `summarize_groups`, `get_highlights` and `get_segment_history`, or the CLI.
* **You get:** Revenue, ROAS and products per segment, 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-product-segments/SKILL.md) or at [`/.well-known/agent-skills/check-product-segments/SKILL.md`](https://www.productmetrics.io/docs/.well-known/agent-skills/check-product-segments/SKILL.md).



```bash
npx skills add product-metrics/skills \
  --skill check-product-segments
```

## When an agent uses it

* "How much of my budget goes to Drainers?"
* "Which of my products are Stars right now?"
* "Why did this jacket drop out of Stars last week?"

## Example conversation

```text
You:    How are my segments doing?
Agent:  summarize_groups (by: "segment")
        Stars: 84 products, revenue €61,200, ROAS 9.8
        Question Marks: 132 products, revenue €22,400, ROAS 6.1
        Drainers: 210 products, revenue €1,900, ROAS 0.9
        get_highlights
        Drainers take €2,100 of the budget. Stars and Question Marks
        earn far more on it.

        Options: lower priority on Drainers, increase priority on
        Question Marks with room to grow. You decide.
```

Example data.

## Commands and tools it uses

| Step                       | CLI / MCP                                                                                                              |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Totals per segment         | MCP `summarize_groups` (`by: "segment"`), `get_highlights`                                                             |
| Products in a segment      | MCP `list_products_to_investigate` (`segment`)                                                                         |
| Why a product moved        | MCP `search_products`, `get_segment_history`, `get_product_context`                                                    |
| What changed this week     | MCP `get_changes` (`group_by: "segment"`), `get_group_timeseries`                                                      |
| Settings and segment label | `productmetrics settings get` (`settings.get`), `productmetrics feed-source-settings get` (`feed_source_settings.get`) |
| Segment counts without MCP | `productmetrics settings preview` with the saved settings (`settings.preview`)                                         |



> **Note:** A segment explains past results; it does not predict future profit. Ad clicks are one signal among many in the model, so the skill explains segments on profitability and potential.

## Where next



* [set-up-product-segmentation skill](/docs/agent-skills/set-up-product-segmentation): custom labels, settings and product rules
* [check-campaign-structure skill](/docs/agent-skills/check-campaign-structure): campaigns built on the segments, and the campaign plan
* [MCP tools](/docs/mcp/tools#products-and-segments): every products and segments tool
