diff --git a/.agents/skills/social/references/listening-sources-template.md b/.agents/skills/social/references/listening-sources-template.md new file mode 100644 index 0000000..286ca03 --- /dev/null +++ b/.agents/skills/social/references/listening-sources-template.md @@ -0,0 +1,123 @@ +# Listening Sources — Template + +Copy this file to `.agents/listening-sources.md` in your project (or `.claude/listening-sources.md`) and fill in the brackets. Claude reads it when running the [listening workflow](listening.md). + +Delete sections you don't use. Keep this short and current — stale sources are worse than no sources. + +--- + +## What We're Listening For + +**Brand / product:** [Your product name] +**Category:** [e.g., "AI writing assistant", "Postgres GUI"] +**Goal:** [e.g., "find people switching from Notion", "engage with B2B SaaS founders 50-200 employees"] + +## ICP (for scoring) + +Used by the [scoring rubric](listening.md#scoring-rubric) to judge ICP fit. + +- **Role:** [e.g., "founder, head of marketing, marketing ops lead"] +- **Company stage:** [e.g., "seed to Series B SaaS, 10-200 employees"] +- **Industry:** [e.g., "B2B SaaS, infra, devtools"] +- **Signals they're a fit:** [e.g., "writes about GTM, runs paid ads, recently raised"] + +--- + +## Target Accounts + +Engage with **every** post from these accounts when relevant. Keep this list to 20-50 max. + +### LinkedIn (browser-driven — use dev-browser to view feed) +- [Name] — `linkedin.com/in/handle` +- [Name] — `linkedin.com/in/handle` + +### X / Twitter (browser-driven) +- [@handle] +- [@handle] + +### Reddit +- u/[username] +- u/[username] + +### Bluesky +- [handle.bsky.social] + +### Blogs / Newsletters (RSS) +- [Name] — `https://example.com/feed/` +- [Name] — `https://example.substack.com/feed` + +### YouTube channels (RSS) +- [Name] — channel ID `UCxxxxxxxx` + +--- + +## Keywords (intent signals) + +Search across all platforms. Claude runs these through Reddit, HN, Bluesky on the [daily loop](listening.md#the-daily-triage-loop). + +### High-intent (someone shopping or switching) +- `"alternative to [competitor]"` +- `"looking for a [category] tool"` +- `"recommend a [category]"` +- `"switching from [competitor]"` +- `"frustrated with [competitor]"` + +### Problem signals (someone in pain) +- `"[category] is so [bad/hard/expensive]"` +- `"why is [category] [problem]"` +- `"hate [pain point]"` + +### Brand mentions +- `"[your brand]"` +- `"[your brand misspelling]"` +- `"[your domain]"` + +### Competitor mentions (monitor for switching language) +- `"[competitor 1]"` +- `"[competitor 2]"` + +--- + +## Subreddits + +Pulled via Reddit JSON API on the daily loop. + +- r/SaaS +- r/Entrepreneur +- r/[your niche, e.g., "marketing", "devtools"] +- r/[adjacent community] + +--- + +## Saved Searches (manual / browser-driven) + +URLs Claude opens via dev-browser to scan. + +### LinkedIn Sales Navigator +- [Search name] — `https://linkedin.com/sales/search/people?...` + +### LinkedIn (regular) +- Posts hashtag — `https://linkedin.com/feed/hashtag/yourtopic/` + +### X advanced search +- [Search name] — `https://x.com/search?q=...&f=live` + +--- + +## Do Not Engage + +Save yourself the regret. + +- Accounts known for bad-faith dunking: [@handle], [@handle] +- Blocked brands / competitors who'll screenshot: [list] +- Topics to avoid: [politics, [your founder's hot takes], etc.] + +--- + +## Notes for Claude + +- When asked for "today's top 10," output in the format defined in [listening.md](listening.md#the-daily-triage-loop) +- For LinkedIn and X, use dev-browser with the persistent session (user is logged in) +- For everything else, use the curl recipes in [listening.md](listening.md#sources--light-tooling-curl-recipes) +- Default lookback: 24h. User can override. +- Always ask before posting — output drafts, user approves and posts manually