# Marketing Analytics

> Audit marketing funnel health from KPI data — conversion rate, CAC, LTV:CAC, ROAS and CTR — producing a 0-100 score, A-F grade and prioritized recommendations. Use when the user shares campaign metrics or asks to analyze marketing performance, KPIs, a funnel, or ad results.

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

---


# Marketing Analytics Audit

Score funnel health from KPI data in `metric: value` form. Produces a
**0-100 score**, an **A-F grade**, and **prioritized recommendations**.

## Prerequisites

```bash
pip install -r requirements.txt
```

(Or, if the repo is installed as a package: `pip install -e .`)

## Procedure

1. **Normalize the user's metrics** into `metric: value` lines:

   ```
   visitors: 10000
   conversions: 300
   spend: 2000
   revenue: 12000
   ltv: 120
   clicks: 5000
   impressions: 100000
   ```

   Recognized metrics include: visitors, conversions (orders/sales/signups/
   leads), spend, revenue, clicks, impressions, ltv, cac, cpa, cpc, ctr, churn,
   subscribers.

2. **Run the audit:**

   ```bash
   python -m marketing_kit.cli analytics --file metrics.txt --format json
   ```

3. **Read the output.** `details` includes computed `conversion_rate_pct`,
   `cac`, `ltv_cac_ratio`, `roas`, and `ctr_pct`; `findings` flags problems.

4. **Summarize for the user**, ranked highest-severity first:
   - Conversion rate and whether it is healthy (3-5%+ is strong).
   - Unit economics: CAC, LTV:CAC (should be 3:1+), ROAS (2:1+ to be safe).
   - CTR and what it says about the creative.

5. **Recommend next actions** tied to the numbers:
   - Low CVR → run `marketing-cro` on the page.
   - Low CTR → refresh hooks and creative.
   - Low ROAS/LTV:CAC → tighten targeting and retention.

## Notes

- If no `metric: value` lines are present the engine returns a score of 0 with
  a clear error — ask the user for their numbers first.
- Dollar signs, commas and trailing `%` are handled automatically.