Brand Mention Monitor

Brand Mention Monitor

Scans the web and social media for brand mentions, scores each one on reach, velocity, sentiment, and risk-topic match, and surfaces the ones that need attention — bucketed into Crisis / Watch / Engage / Log with a suggested owner.

---

Onboarding message

When this skill is triggered for the first time in a session, send this message:

> 👋 Brand Mention Monitor is ready. > > This skill scans Reddit, X, LinkedIn, Instagram, TikTok, YouTube, blogs, news, and review platforms for mentions of your brand — scoring each one across reach, velocity, sentiment, and risk so you see what matters before it spirals, and telling you exactly who should respond and how fast. > > To start, just say: > "Monitor mentions of [brand name]" > > Or try: > - "What are people saying about [brand] this week?" > - "Run a brand sweep for [brand] — last 30 days" > - "Find high-risk mentions of [brand]" > - "How does [brand] compare to [competitor] in the conversation?" > > Would you like me to save your preferences so I skip the questions next time?

---

Preflight

Follow the transport selection and standard preflight from references/nimble-playbook.md: pick CLI vs MCP at session start, then run the parallel preflight calls (date, profile, memory index) simultaneously. Tag every Nimble CLI call: nimble --client-source skill-brand-mention-monitor .

From the profile (~/.nimble/business-profile.json): load brand name, competitors, routing preferences, and last_runs.brand-mention-monitor for date windowing. Pre-populate setup questions so the user confirms rather than re-enters. If no profile exists, follow the first-run onboarding flow in references/profile-and-onboarding.md and create a stub after the first run. Check ~/.nimble/memory/index.md to understand what mention data already exists before sweeping.

---

How to start

Before asking anything, do two quick research steps:

Step A — Resolve brand variants automatically: Search for the brand the user named to discover all alternate spellings, hashtags, product names, handles, and common misspellings. Do not ask the user for this. Use what you find to build a comprehensive search term list for the sweep.

• Search: "[brand name]" official name OR handle OR "also known as" OR hashtag
• Check the brand's main product names and any sub-brands that get mentioned independently
• For brands with common-word names, find the disambiguating terms (industry, founder, domain) so the sweep doesn't pull unrelated noise
• Add all confirmed variants to your search queries silently — the user never needs to see this step

Step B — Profile the brand automatically: Search to establish the brand's industry, business model (B2B/B2C), geography, language, and audience before asking the user. This selects the market-specific source profile (see Step 0) and calibrates scoring — what counts as "high reach" differs for a niche B2B tool vs a consumer app with millions of users. Surface what you find and fold it into the confirmation question rather than asking blind.

• Search: "[brand name]" company OR product industry OR category
• Determine: B2B vs B2C, industry vertical, primary geography/language, rough audience size
• Use this to pick the source profile and the default risk-topic dictionary for the industry

Then ask in a single message:

> "Before I run — just confirming a few things: > 1. Brand: I found [brand] — a [category] [B2B/B2C] company targeting [audience]. Is that right, and any competitors to track alongside it? > 2. Date range: How far back should I look? (default: last 7 days — or give me a window like 'June 1–15' or 'since the launch') > 3. Depth: Quick scan (faster) or deep sweep (more thorough, more sources)? (default: deep) > 4. Routing: When I find a Crisis-tier mention, who should I flag it for? (default: marketing team — or name a PR lead, legal, founder, etc.)"

Output is always the triage console rendered directly in Claude. Do not ask about format or output options.

Exceptions — skip asking entirely if:

• The user provided all the above in their initial message
• The user has run this skill before in the session (use prior config)

Defaults if user says "just run it":

• Date range: last 7 days
• Depth: deep
• Risk topics: auto-detected for the industry
• Routing: flag to marketing team

Disambiguation: If the brand name is ambiguous after research, confirm before proceeding: > "Just to confirm — by [brand], do you mean [Option A] or [Option B]?"

---

Step 0 — Source profile (market-specific, not fixed list)

This is the most important configuration step. Source selection must match where the brand's audience actually talks. Do not scan all platforms equally — weight the channels that matter for this company type.

B2B enterprise software / SaaS

Primary (run every pass): LinkedIn, G2, Capterra, Hacker News, r/sysadmin, r/devops, r/[category], trade press (InfoQ, TechCrunch, ZDNet, The Register), Glassdoor (employee signal) Secondary: Reddit broad, X/Twitter (exec accounts, analysts), Medium/Substack Deprioritize: TikTok, Instagram, Facebook (low-signal for B2B buyers)

Consumer brand / e-commerce

Primary (run every pass): TikTok, Instagram, X/Twitter, Reddit, YouTube, Facebook, Trustpilot, Google Play / App Store Secondary: News press, blogs, Pinterest Deprioritize: HN, LinkedIn (low signal for consumer sentiment), trade press

Regulated industry (finance, healthcare, pharma, insurance)

Primary: News press (Reuters, AP, Bloomberg, sector-specific), regulatory watchdog sites, journalist Twitter accounts, LinkedIn exec commentary, formal review platforms (BBB, Consumer Financial Protection Bureau) Secondary: Reddit, X, forums Deprioritize: TikTok, Instagram (reputational risk from user-gen content is lower priority than press/regulatory)

Regional / non-English brand

Primary: Local-language news, regional forums and social platforms (e.g. Weibo for China, VK for Russia, Naver for Korea), local-language Twitter/Instagram Secondary: English-language global platforms only if relevant Note: Use Nimble locale and country parameters to surface local-language results

Startup / developer tool

Primary: HN, Reddit (r/programming, r/webdev, r/[category]), GitHub discussions, Dev.to, X/Twitter (developer influencers), ProductHunt Secondary: LinkedIn, Medium, TechCrunch

---

Step 1 — Mention sweep

For deep sweeps, fan out across source tiers using parallel sub-agents (max 4 concurrent) via the Agent tool — one agent per source group (e.g., social, review platforms, news, community). Follow the parallel-gathering pattern in references/nimble-playbook.md. Always include a fallback: if a sub-agent fails, continue with remaining agents and note the gap in the output.

Run sources matching the brand's profile (Step 0). Use --search-depth lite for discovery; use --search-depth deep for full content on high-score candidates. Apply --start-date / --end-date from the user's date range on every search call. Tag every call: nimble --client-source skill-brand-mention-monitor search ...

Core queries (run for every brand type)

• "[brand name]" site:reddit.com
• "[brand name]" site:x.com
• "[brand name]" news
• "[brand name]" review OR complaint OR "doesn't work" — risk sweep
• "[brand name]" love OR recommend OR "game changer" — opportunity sweep
• Nimble focus:"social" query "[brand name]" — broad social

Risk-specific queries (run every pass)

Build from the risk topic dictionary for this brand type plus any user-specified topics:

• "[brand name]" [risk topic 1]
• "[brand name]" [risk topic 2]
• "[brand name]" lawsuit OR legal OR "class action"
• "[brand name]" outage OR "not working" OR down (for SaaS/tech)
• "[brand name]" recall OR safety OR "side effects" (for consumer/pharma)
• "[brand name]" scam OR fraud OR fake

Velocity check (run on high-score candidates — re-runs only)

For any mention that scored above 50 on a previous run, re-fetch the post to compare engagement counts. If this is a first-pass sweep with no prior baseline, skip hourly-rate velocity scoring — proxy signals only (see Step 2 velocity gating rules).

---

Step 2 — Scoring each mention (four dimensions)

Score every mention 0–100 on each dimension, then compute composite.

Reach / Visibility (0–100)

How many people can see this? | Signal | Points | |---|---| | 500K+ followers / major publication | +35 | | 100K–500K followers | +25 | | 10K–100K followers | +15 | | 1K–10K followers | +8 | | Under 1K | +3 | | Thread with 100+ replies/comments | +20 | | Post going viral (100+ reposts in ` with no dependency. Keep these script tags.

Source URL rule: Every mention must include ↗ source with the exact article/post URL from Nimble. Never use a homepage.

• CORRECT: https://reddit.com/r/SaaS/comments/abc123/title
• CORRECT: https://x.com/username/status/1234567890
• WRONG: https://reddit.com WRONG: https://x.com

---

Markdown output spec (brand-mention-monitor-{YYYY-MM-DD}.md)

# Brand Mention Monitor — [Brand Name]
**Date range:** [DATE RANGE]
**Generated:** [TIMESTAMP]
**Total mentions:** [N]
**Sources searched:** [list]

## TL;DR
[2–4 lines: total mentions · tier breakdown (X Crisis · Y Watch · Z Engage) · the single most urgent item + its response window]

## Crisis tier (80–100) — respond  "Save preferences? I'll remember [brand], source profile, risk topics, and routing so future runs skip setup."

Say **"change settings"** to update anytime.

---

## Re-run behavior

For date window calculation, follow the Smart Date Windowing pattern in `references/nimble-playbook.md` — use `last_runs.brand-mention-monitor` from the profile.

> "Sweeping for new mentions since [last run]. Anything to add to the watch list?"

Net-new mentions only. Crisis and Watch items carry forward until marked handled.

---

## End-of-run next steps

After delivering the triage console and confirming distribution, suggest the most relevant follow-on action based on what the sweep surfaced:

- **If any Watch or Crisis mentions came from competitors framing your brand negatively:** → "Want to go deeper on what competitors are saying about you? Try the `competitor-positioning` skill — it maps competitor messaging, positioning gaps, and attack vectors in detail."
- **If the brand appeared in funding, hiring, or M&A context:** → "There are signals here that go beyond brand sentiment — the `competitor-intel` skill tracks business moves, hiring signals, and strategic shifts that could affect your market position."
- **If the sweep found mostly positive mentions worth amplifying:** → "Some of these are worth turning into content or outreach — the `competitor-positioning` skill can help you identify the messaging angles your audience is already responding to."
- **If this is the first run (no prior memory):** → "Run this again in 7 days to get velocity data and start seeing trends. I'll have a baseline for comparison on the next pass."

Present only the suggestions relevant to this run — do not list all four if only one applies.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Nimbleway](https://github.com/Nimbleway)
- **Source:** [Nimbleway/agent-skills](https://github.com/Nimbleway/agent-skills)
- **License:** MIT
- **Homepage:** https://www.nimbleway.com

Install and usage instructions live in the source repository linked above.