Blog Discourse
Research what people are actually saying about a topic in the last 30 days across...
Install
npx skills add AgriciDaniel/claude-blog --skill blog-discourse -g -a claude-code -y- Repository
- AgriciDaniel/claude-blog2.6k
- Category
- Writing
- Updated
- 6d ago
- License
- MIT
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- Yes, review before use
What it does
Research what people are actually saying about a topic in the last 30 days across Reddit, X / Twitter, YouTube, Hacker News, dev.to, Medium, and other public discourse platforms. API-free; uses WebSearch with platform-targeted site operators plus recency filters. Produces DISCOURSE.md (a structured brief) and JSON output the writer can consume. Complements blog-researcher (which focuses on authority sources) with a recency-and-engagement lens. Not for verifying statistics (blog-factcheck) or gathering authority sources. Use when user says "blog discourse", "discourse research", "what are people saying about", "research what people are saying", "voice of customer", "social listening", "30-day research", "trend research", "what's the discussion on", "real-time research", "practitioner discourse", "/blog discourse".
Blog Discourse: Real Discourse Research, API-Free
Bundled paths below use host Markdown substitution of ${CLAUDE_SKILL_DIR};
it is not an exported shell variable. Resolve them before execution, quote
paths, and refuse nonabsolute overrides. Pass blog_reference_root resolved
from ${CLAUDE_SKILL_DIR}/../blog/references, blog_template_root from
${CLAUDE_SKILL_DIR}/../blog/templates, and needed sibling roots to agents.
Read the main reference orchestration-details.md before loading project
context; pass only its helper-fenced output to downstream agents.
Produces DISCOURSE.md: a structured brief of what practitioners said about <topic> on the public web in the last 30 days. It is the recency + engagement lens that blog-researcher (authority-first) lacks, asking what practitioners and customers are actually saying about this topic right now.
Adapted from the methodology of last30days-skill (Matt Van Horn, MIT, https://github.com/mvanhorn/last30days-skill). The upstream uses platform APIs; this sub-skill uses WebSearch with platform-targeted site operators. No API keys required.
Commands
| Command | Purpose |
|---|---|
/blog discourse <topic> | Produce a discourse brief at project-root DISCOURSE.md |
/blog discourse <topic> --days 90 | Widen the freshness window from 30 to 90 days |
/blog discourse <topic> --input results.json | Skip search; build the brief from a pre-gathered results file. The flag name matches scripts/discourse_research.py --input directly. |
/blog discourse <topic> --output path.md | Write markdown to a chosen output path and print structured JSON without markdown to stdout. |
/blog discourse <topic> --format json | Print the full JSON brief to stdout when no --output path is used. |
/blog discourse <topic> --decomposition questions.txt | Pass newline-delimited decomposition questions into the helper. |
