agentleFS
XuHo-ITXuHo-IT/Content-Agent-Kit/skills/ads-fatigue-watch/SKILL.md

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.

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
  1. Very specific:

    Write brain/fatigue-<date>.md: the table, the briefs, and the thresholds used.

    line 67

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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ằng install-skills.mjs --kit, đường dẫn nằm trong file .kit-root cạ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ướcAgent làm gìNgười dùng cần làm
1. Xuất số liệuHướ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ấtXuất file và gửi cho agent
2. Kiểm traChạ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ớiMỗ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ắtChỉ đề xuất mẫu nên tạm dừng, không tự tắtTự 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 budgets

2. What the statuses mean

statusruledo
🔴 FATIGUED≥ 2 signals: frequency ≥ 3 · CTR −25% vs its first 3 days · CPM +30% · cost/result +30%refresh this week
🟡 WATCH1 signalbrief the replacement now, swap when a 2nd signal appears
🟢 HEALTHYnoneleave it alone — changing a working ad resets learning
⚪ NOT_ENOUGH_DATA< 6 days or < 2,000 impressions in a windowno 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-lab as 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.