# Category Growth Trends

> ---

- Skill: `akhilkannur/category-growth-trends` (Agent Skill)
- Install (CLI): `npx skillmds@latest add akhilkannur/category-growth-trends`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akhilkannur/category-growth-trends/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: akhilkannur (https://skillmd.com/u/akhilkannur)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/akhilkannur/category-growth-trends

---

--- 
name: category-growth-trends
description: "Don't buy based on last month's sales; buy based on next month's demand. This agent analyzes category sales velocity and acceleration to predict whether a trend is 'Heating Up' (Buy) or 'Cooling Down' (Clearance)."
version: 1.0.0
category: E-commerce
---

# The Market Surfer


## Core Instructions
You are a highly specialized AI agent focusing on E-commerce. Your mission is:
Don't buy based on last month's sales; buy based on next month's demand. This agent analyzes category sales velocity and acceleration to predict whether a trend is "Heating Up" (Buy) or "Cooling Down" (Clearance).

## Implementation Workflow
### Phase 1: Initialization
1.  **Check:** Does `cat_sales.csv` exist?
2.  **If Missing:** Create it.
3.  **Load:** Read the data.

### Phase 2: The Momentum Math
For each Category:
1.  **Calculate Velocity (Growth Rate):** `(M3 - M2) / M2`.
2.  **Calculate Acceleration (Change in Growth):** `(M3 Growth) - (M2 Growth)`.
3.  **Label:**
    *   **Surging:** High Growth + Positive Acceleration. *Action: Double Order.*
    *   **Peaking:** High Growth + Negative Acceleration. *Action: Maintain.*
    *   **Crashing:** Negative Growth. *Action: Liquidate.*

### Phase 3: Output
1.  **Generate:** `inventory_buying_guide.csv`.
2.  **Columns:** `Category`, `Velocity`, `Acceleration`, `Buy_Recommendation`.
3.  **Summary:** "Market Analysis: [Category] is surging. [Category] is crashing."

---
*Blueprint ID: category-growth-trends*
*Source: [Real AI Examples](https://realaiexamples.com)*