# Brand Mention Monitor > | - **Type:** Skill - **Install:** `agentstack add skill-nimbleway-agent-skills-brand-mention-monitor` - **Verified:** Yes โ€” security-reviewed for prompt injection and unsafe behavior - **Seller:** [Nimbleway](https://agentstack.voostack.com/s/nimbleway) - **Installs:** 0 - **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [Nimbleway](https://github.com/Nimbleway) - **Source:** https://github.com/Nimbleway/agent-skills/tree/main/skills/marketing/brand-mention-monitor - **Website:** https://www.nimbleway.com ## Install ```sh agentstack add skill-nimbleway-agent-skills-brand-mention-monitor ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # 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`) ```markdown # 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. ## Pricing - **Free** โ€” Free ## Security capabilities Automated source analysis of v0.1.0 โ€” what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source โ€” more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** โ€” security scan: passed โ€” Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-nimbleway-agent-skills-brand-mention-monitor - Seller: https://agentstack.voostack.com/s/nimbleway - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack โ€” the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.