ads-fatigue-watch
Skill8 starsChanged 4 months agoMITView on GitHub
Find Facebook/Instagram ads that are wearing out — frequency climbing, CTR falling from its own start, CPM and cost per result rising — and write a concrete refresh brief for each, from an Ads Manager CSV export or the meta-ads MCP. Use when the user says "quảng cáo đuối", "ads bị bão hoà", "CPM tăng", "CTR giảm", "mẫu này chạy lâu rồi", "ad fatigue", "creative refresh", "canh ads", or on a schedule twice a week. Reads only; never pauses or edits an ad.
In this repository32 other files it gives its agents.
- AGENTS.mdAGENTS.md
- ads-comment-triageSkill
- ads-creative-labSkill
- ads-policy-checkSkill
- ads-reportSkill
- audience-planSkill
- audit-and-fixSkill
- bootstrap-content-agentSkill
- brand-lessonsSkill
- catalog-feed-auditSkill
- competitor-analysisSkill
- crawl-and-queueSkill
- create-videoSkill
- creator-startSkill
- daily-runSkill
- daily-topic-videoSkill
- design-campaignSkill
- freshness-checkSkill
- geo-optimizeSkill
- localize-videoSkill
- motion-craftSkill
- new-templateSkill
- performance-reviewSkill
- promo-calendarSkill
- repurposeSkill
- research-and-captureSkill
- review-gateSkill
- story-videoSkill
- talking-head-editSkill
- topic-radarSkill
- ugc-koc-briefSkill
- video-and-postSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 67
Write brain/fatigue-<date>.md: the table, the briefs, and the thresholds used.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Fatigue watch — replace a creative before it burns budget, not after
"Canh tắt ads" by eye means turning things off when they already cost money. This skill compares each ad with its own first days and flags the decline while it is still a trend.
Hướng dẫn từng bước cho người dùng
Chạy lệnh
node scripts/…ở thư mục gốc của kit — thư mục cóAGENTS.md, hai cấp trên file này (nếu skill được cài bằnginstall-skills.mjs --kit, đường dẫn nằm trong file.kit-rootcạnh file này).
Dẫn người dùng theo đúng các bước dưới, bằng lời đơn giản. Trước khi bắt đầu: một câu nói skill sẽ làm gì, mất khoảng bao lâu, cần người dùng chuẩn bị gì. Đầu mỗi bước báo "Bước n/N — <tên bước>" kèm một câu đang làm gì. Khi cần người dùng làm gì, chỉ hỏi đúng một việc. Kết thúc: kết quả nằm ở đâu và việc nên làm tiếp.
| Bước | Agent làm gì | Người dùng cần làm |
| 1. Xuất số liệu | Hướng dẫn xuất CSV từ Ads Manager: cấp Quảng cáo, chia Theo ngày, 14 ngày gần nhất | Xuất file và gửi cho agent |
| 2. Kiểm tra | Chạy node scripts/ads/fatigue-check.mjs export.csv, so mỗi quảng cáo với 3 ngày đầu của chính nó | Nói nếu đây là tệp retarget (ngưỡng tần suất cao hơn) |
| 3. Giải thích trạng thái | 🔴 đuối · 🟡 theo dõi · 🟢 ổn · ⚪ chưa đủ dữ liệu, kèm ngưỡng đã dùng | — |
| 4. Viết brief làm mới | Mỗi tín hiệu thành một việc cụ thể (đổi hook, đổi hình, mở rộng tệp, xem lại trang bán) → brain/fatigue-<ngày>.md | Đọc brief, chọn mẫu sẽ làm lại |
| 5. Dừng — người dùng tự tắt | Chỉ đề xuất mẫu nên tạm dừng, không tự tắt | Tự tắt/bật trong Ads Manager |
Hay vướng:
- File thiếu cột theo ngày → phải chọn breakdown Theo thời gian → Ngày khi xuất.
- Thấy 🟢 rồi vẫn muốn sửa → quảng cáo đang tốt thì để yên, sửa sẽ làm nó học lại từ đầu.
- Nhiều dòng ⚪ → tài khoản chạy chưa đủ 6 ngày hoặc 2.000 hiển thị; chạy lại sau vài ngày.
1. Get the data
- No MCP: Ads Manager → Reports → level Ad, breakdown By time → Day, columns: Ngày, Tên quảng cáo, Lượt hiển thị, Người tiếp cận, Tần suất, Lượt click vào liên kết (or CTR), Số tiền đã chi tiêu, Kết quả. Export CSV. Vietnamese or English headers, "1.234,5" or "1,234.5" both work.
- meta-ads MCP: pull the same fields at ad level, daily, last 14 days; save as CSV with those headers and run the same script so the logic is identical either way.
node scripts/ads/fatigue-check.mjs export.csv
node scripts/ads/fatigue-check.mjs export.csv --freq 4 --min-impressions 3000 # retargeting / bigger budgets2. What the statuses mean
| status | rule | do |
| 🔴 FATIGUED | ≥ 2 signals: frequency ≥ 3 · CTR −25% vs its first 3 days · CPM +30% · cost/result +30% | refresh this week |
| 🟡 WATCH | 1 signal | brief the replacement now, swap when a 2nd signal appears |
| 🟢 HEALTHY | none | leave it alone — changing a working ad resets learning |
| ⚪ NOT_ENOUGH_DATA | < 6 days or < 2,000 impressions in a window | no conclusion; say so |
Defaults suit prospecting. Retargeting tolerates higher frequency (--freq 5). Tell the user which
thresholds you used.
3. Turn signals into briefs
The script prints one line per signal. Expand each into a brief the team can shoot:
- CTR fell → the hook is tired. Same product and offer, new first 3 seconds. Hand to
ads-creative-labas a hook-only round. - Frequency high → same message, new picture: other model/size, setting, format.
- CPM rose → the audience is used up; widen (broad/Advantage+), add placements. A new image alone will not fix it.
- Cost/result rose but CTR held → check the landing page and offer first (stock, size, ship fee, price matching the ad).
Write brain/fatigue-<date>.md: the table, the briefs, and the thresholds used.
4. Stop and ask
Propose which ads to pause and which replacements to launch. Do not pause anything. If the meta-ads MCP is connected, present the exact calls you would make and wait for a yes.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

