AgriciDaniel/claude-blog / skills/blog-discourse
blog-discourse
VerifiedResearch 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".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.1 KB |
| scripts/discourse_research.py | script | 2.7 KB |
scripts/discourse_research.py
View on GitHub#!/usr/bin/env python3
"""Thin wrapper that runs the core discourse brief builder (scripts/discourse_research.py).
There is one implementation. This file only locates the core script and
forwards the command line, so the flags, the input validation, the output-path
checks, the atomic write and the exit codes are identical to the core:
python3 discourse_research.py --input results.json --topic "AI SEO"
[--days N] [--output DISCOURSE.md] [--format {markdown,json}]
[--decomposition questions.txt]
The core script is found at ``CLAUDE_BLOG_SCRIPTS_DIR`` when that variable
names an absolute directory, otherwise at ``<skills dir>/../scripts`` relative
to this file (the plugin layout and the standalone ``~/.claude`` layout both
satisfy this). If it cannot be found the wrapper exits 2 with a pointer.
"""
from __future__ import annotations
import importlib.util
import os
import sys
from pathlib import Path
_CORE = None
def core_path() -> Path:
"""Return the core script path (not yet verified to exist)."""
override = os.environ.get("CLAUDE_BLOG_SCRIPTS_DIR")
if override:
base = Path(override)
if not base.is_absolute() or ".." in base.parts:
raise ValueError("CLAUDE_BLOG_SCRIPTS_DIR must be a resolved absolute path")
else:
base = Path(__file__).resolve().parents[3] / "scripts"
return base / "discourse_research.py"
def load_core():
"""Import the core implementation once and return the module."""
global _CORE
if _CORE is not None:
return _CORE
path = core_path()
if not path.is_file() or path.resolve() == Path(__file__).resolve():
raise FileNotFoundError(path)
spec = importlib.util.spec_from_file_location("claude_blog_discourse_research_core", path)
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
_CORE = module
return module
def main(argv: list[str] | None = None) -> int:
try:
core = load_core()
except (FileNotFoundError, ValueError) as exc:
print(
"ERROR: this is a thin wrapper and the core scripts/discourse_research.py "
f"was not found ({exc}). Run the core script from the claude-blog "
"install directly, or set CLAUDE_BLOG_SCRIPTS_DIR to its absolute "
"scripts directory.",
file=sys.stderr,
)
return 2
if argv is not None:
# The core parses sys.argv itself; present the forwarded arguments to it.
saved = sys.argv
sys.argv = [saved[0], *argv]
try:
return core.main()
finally:
sys.argv = saved
return core.main()
if __name__ == "__main__":
sys.exit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |