šŸŽ Get the FREE AI Skills Starter Guide ā€” Subscribe ā†’
BytesAgainBytesAgain
BytesAgain ā€ŗ Skills ā€ŗ Topic Research
šŸ¦€ ClawHub

Topic Research

by @abigale-cyber

Run a second-hop deep research pass through the Tavily CLI after an initial scan, then normalize the result into a local `research.md` contract. Use when Cod...

Versionv1.0.0
Downloads470
#research#legal
TERMINAL
clawhub install topic-research

šŸ“– About This Skill

name: topic-research description: Run a second-hop deep research pass through the Tavily CLI after an initial scan, then normalize the result into a local research.md contract. Use when Codex needs cited follow-up research for a chosen topic from news-collect, or wants a reusable research report saved into content-production/inbox/.

Topic Research

This skill deepens a selected topic after news-collect or any manually chosen theme. It does not replace first-pass collection. The report now also produces a local writing decision layer.

Quick Start

Run the default command:

.venv/bin/python -m skill_runtime.cli run-skill topic-research --input content-production/inbox/20260405-agent-topic-research.md

Prepare Input

Pass a markdown request file with YAML frontmatter.

Supported fields:

  • topic
  • question
  • model: mini / pro / auto
  • source_file: optional path to a prior news-report.md
  • seed_urls: optional list or comma-separated URLs

    • Example:

    ---
topic: AI coding agents
question: čæ™äŗ›äŗ§å“čæ‘äø€å‘Øēš„äŗ§å“åŒ–ę–¹å‘å’Œå•†äøšåŒ–äæ”号ę˜Æ什么ļ¼Ÿ
model: pro
source_file: content-production/inbox/20260405-ai-news-report.md
seed_urls:
  - https://example.com/a
  - https://example.com/b

    č”„å……čÆ“ę˜Žļ¼šä¼˜å…ˆč¾“å‡ŗčƒ½č½¬ęˆäø­ę–‡å…¬ä¼—å·é€‰é¢˜åˆ¤ę–­ēš„ē»“č®ŗ怂

    Follow Research Workflow

    1. Validate that tvly is installed and available on PATH. 2. Combine the request fields into a single research query. 3. Call tvly research ... --json. 4. Save the raw JSON and rewrite the result into a normalized markdown research report. 5. Add a writing-decision section covering whether the topic is worth writing, recommended structure, opening hooks, title directions, and evidence risks.

    Write Output

    Write the report to:

    content-production/inbox/YYYYMMDD--research.md

    Write the raw JSON to:

    content-production/inbox/raw/research/YYYY-MM-DD/.json

    Respect Constraints

  • Only use the repo-local dependency marker skills/tavily-research/ for this integration
  • Do not silently fall back if tvly is missing or not logged in
  • Keep the output contract stable even if Tavily CLI changes its JSON schema

    • Read Related Files

  • Runtime entry: skill_runtime/engine.py
  • Wrapper runtime: skills/topic-research/runtime.py
  • Vendor dependency marker: skills/tavily-research/
  • Data contract: docs/data-contracts.md

    • šŸ’” Examples

    Run the default command:

    .venv/bin/python -m skill_runtime.cli run-skill topic-research --input content-production/inbox/20260405-agent-topic-research.md