# effect-monitoring

effect-monitoring — a skill for Claude Code and Cursor that tracks marketing campaign performance on Xiaohongshu. Calculates ROI, ROAS, conversions, and acquisition cost per placement and influencer.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 169 installs · ★ 564 repo stars
- Author: vivy-yi
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vivy-yi/xiaohongshu-skills/tree/HEAD/skills/07-营销推广/effect-monitoring/SKILL.md
- Updated: 2026-01-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/effect-monitoring

## What it does

The agent collects exposure metrics (impressions, CPM, frequency), engagement (likes, comments, saves), and conversion (clicks, sales, CPA) into a single dashboard. Compares campaigns, calculates return on ad spend, and pauses underperforming placements. Supports UTM tagging, Google Analytics integration, and per-influencer tracking.

Input data — spend, clicks, conversions per campaign — the agent pulls from platform analytics or a file. Without FFprobe and `jq` installed, some metric calculations won't run. The report template generates a table with ROAS, CTR, and cost per lead per channel; text is not localized, metrics appear in English.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill effect-monitoring -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/effect-monitoring/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/effect-monitoring/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill effect-monitoring -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/effect-monitoring/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill effect-monitoring -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/effect-monitoring/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vivy-yi/xiaohongshu-skills skills/07-营销推广/effect-monitoring
```

2. **Manually: put the files in place**
- File: `.github/skills/effect-monitoring/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill effect-monitoring -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vivy-yi/xiaohongshu-skills --path skills/07-营销推广/effect-monitoring
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/effect-monitoring/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill effect-monitoring -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/vivy-yi/xiaohongshu-skills/tree/HEAD/skills/07-营销推广/effect-monitoring/SKILL.md

## When to use it
- Calculate ROAS and CPA for each Xiaohongshu ad campaign
- Compare two influencers by conversion rate and engagement
- Generate a weekly report for all active promotions with channel breakdown
- Monitor CPM and CTR in real time, stop the campaign when threshold is exceeded

## Example prompts
- Calculate ROAS for campaign `brand_a_june` from `campaign_stats.csv`
- Compare influencer conversion from `kol_results.xlsx`, show top three
- Build a dashboard: reach, engagement, conversion per placement for the week

## Similar
- [utm-parameter-generator](https://affpapa.org/en/nevibecode/skills/utm-parameter-generator.md) — skill · 338 installs
- [social-media-analyzer](https://affpapa.org/en/nevibecode/skills/social-media-analyzer.md) — skill · 1558 installs
- [marketing-analytics](https://affpapa.org/en/nevibecode/plugins/marketing-analytics.md) — plugin · ★ 450 repo stars
- [campaign-analytics](https://affpapa.org/en/nevibecode/skills/campaign-analytics.md) — skill · 793 installs
- [email-sequence](https://affpapa.org/en/nevibecode/skills/anthropics-email-sequence.md) — skill · 3100 installs
- [campaign-plan](https://affpapa.org/en/nevibecode/skills/campaign-plan.md) — skill · 3500 installs

From the same set: [vivy-yi/xiaohongshu-skills](https://affpapa.org/en/nevibecode/by/vivy-yi/xiaohongshu-skills.md) — 100 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
