Systems Lab

Agent skill

newsletter-monitor

Scan an AgentMail inbox for newsletter signals using configurable keyword campaigns.

dormantNeeds a keyActs undeclared323 words

Filed under Content and SEO.

From edupegoretti/fluidz-skills · 116 skills · 0 · pushed 2026-03-11

What it does when it runs

Scan an AgentMail inbox for newsletter signals using configurable keyword campaigns. Extracts matched keywords, context snippets, and company mentions from incoming emails. Use for monitoring accounting industry newsletters for buying signals like acquisitions, migrations, and staffing news.

Read from the skill and the 3 files bundled beside it. A skill’s own description is written to be selected by an agent, so it describes the job and not the dependencies.

Keys and connectors you must supply
  • AGENTMAIL_API_KEY
Hosts it reaches
No third-party host appears in the skill or its bundled files.
Tool permissions it declares
No allowed-tools in the frontmatter. It does act, so it runs under whatever permissions your session already grants.
Actions present in the files
shell

Ask about newsletter-monitor

Opens your assistant with this page's verified links already in the prompt.

Is this safe to install?ClaudeChatGPT
Adapt it to my stackClaudeChatGPT
What else do I need for it to workClaudeChatGPT
Rather ask a human? Talk to Cheetah
git clone --depth 1 --filter=blob:none --sparse https://github.com/edupegoretti/fluidz-skills.git /tmp/fluidz-skills
git -C /tmp/fluidz-skills sparse-checkout set "skills/composites/newsletter-monitor"
mkdir -p ~/.claude/skills/newsletter-monitor
cp -R "/tmp/fluidz-skills/skills/composites/newsletter-monitor/." ~/.claude/skills/newsletter-monitor/

Picked up without a restart. A project skill of the same name is shadowed by your personal one. For one repository only, swap ~/.claude/skills for .claude/skills. Claude Code docs ↗

The folder is the same in every client that implements the format — 46 of them — so if yours is not above, only the destination changes.

Before you install: this skill will not complete its job on a bare agent. It needs AGENTMAIL_API_KEY, which you have to obtain separately.

Reproduced in full from edupegoretti/fluidz-skills/blob/a2cf697e2e8ec2ea517d85496e2d5c7f5dc44cd3/skills/composites/newsletter-monitor/SKILL.md, which is licensed MIT (repository). 323 words, 13 headings.

Newsletter Monitor

Scan an AgentMail inbox for newsletter signals using configurable keyword campaigns. Designed for monitoring accounting industry newsletters for buying signals like acquisitions, Sage Intacct migrations, staffing challenges, and technology adoption.

Quick Start

# Set your API key
export AGENTMAIL_API_KEY="your_key_here"

# Scan inbox with all campaigns (summary view)
python3 skills/newsletter-monitor/scripts/scan_newsletters.py --output summary

# Scan specific campaign, last 7 days
python3 skills/newsletter-monitor/scripts/scan_newsletters.py --campaign acquisitions --days 7 --output summary

# JSON output for downstream processing
python3 skills/newsletter-monitor/scripts/scan_newsletters.py --output json --limit 50

Dependencies

pip3 install agentmail python-dotenv

Configuration

Keyword campaigns are defined in config/campaigns.json. Each campaign has a description and a list of keywords for case-insensitive substring matching.

Built-in campaigns:

  • acquisitions - CPA firm M&A activity
  • sage_intacct - Sage Intacct migration and implementation signals
  • staffing - Accounting talent and staffing challenges
  • technology - Accounting technology adoption

CLI Options

FlagDescriptionDefault
--campaign NAMERun only a specific campaignAll campaigns
--days NOnly scan emails from last N daysNo limit
--keywords "a,b,c"Custom keywords (overrides campaigns)Use campaigns.json
--output json|summaryOutput formatjson
--inbox ADDRESSOverride inbox addressAGENTMAIL_INBOX env or [email protected]
--limit NMax messages to fetch100

Output

JSON mode (default)

Returns an array of matched messages with:

  • message_id, from, subject, date
  • matched_campaigns - which campaigns triggered
  • matched_keywords - specific keywords found
  • context_snippets - 200-char window around each match
  • companies_mentioned - capitalized multi-word phrases near matches

Summary mode

Human-readable report showing matched emails grouped by campaign with snippets and detected companies.

Downstream Skills

When newsletter signals are found, chain to:

  • company-contact-finder - look up contacts at mentioned companies
  • accounting-news-monitor - combine with direct news monitoring for fuller signal coverage

Files bundled with it

These load only when the skill asks for them, so they cost nothing until it runs.

Other skills for the same job

Different authors, same problem. Matched on the words in the skill name, across every library in the catalogue except this one.

Need help setting it up?

This page tells you what newsletter-monitor does and what it needs. Cheetah builds the agent setup it runs inside: data, CRM, sequencing and the guardrails.

Book a call →

The directory stays free. There is nothing gated behind this.