القائمة
Gather source material for the radio show from any content source — web, HN, GitHub, papers, or general topics.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | research |
| description | Gather source material for the radio show from any content source — web, HN, GitHub, papers, or general topics. |
Gather source material for the radio show based on the user's prompt. The research strategy is agent-driven — you decide how to gather content based on what the user asks for.
All research scripts live in skills/research/scripts/ and output to {workspace}/data/research/. They use only Python stdlib — no dependencies.
| Script | Command | Source |
|---|---|---|
fetch_hn.py | python3 skills/research/scripts/fetch_hn.py --workspace ./workspace --top 6 | Hacker News |
fetch_github.py | python3 skills/research/scripts/fetch_github.py --repo owner/repo --workspace ./workspace | GitHub repos |
fetch_url.py | python3 skills/research/scripts/fetch_url.py --url https://... --workspace ./workspace | Any URL |
Phase 1: Scan — grab top 10 story titles, scores, and comment counts (fast, no deep-diving):
python3 skills/research/scripts/fetch_hn.py --workspace ./workspace --mode scan --top 10
Output: {workspace}/data/research/hn-scan.md — a list of stories with IDs.
You read this file, pick the 2-3 most interesting stories for radio, then run phase 2.
When picking stories, SKIP anything related to politics, race, religion, international conflicts, historical controversies, gender/culture wars, or immigration. Stick to tech, programming, AI/ML, open source, science, startups, and developer culture.
Phase 2: Deep-dive — fetch full comment threads for the stories you picked:
python3 skills/research/scripts/fetch_hn.py --workspace ./workspace --mode deep-dive --stories 43210987,43209876
Output: {workspace}/data/research/hacker-news.md — full stories with top comments.
| Argument | Default | Description |
|---|---|---|
--workspace | workspace | Root workspace directory |
--mode | (required) | scan or deep-dive |
--top | 10 | Number of stories to scan (scan mode only) |
--stories | (required for deep-dive) | Comma-separated story IDs |
python3 skills/research/scripts/fetch_github.py --repo googleapis/python-genai --workspace ./workspace
Accepts owner/repo or a full GitHub URL (https://github.com/owner/repo).
| Argument | Default | Description |
|---|---|---|
--repo | (required) | GitHub repo (owner/repo or full URL) |
--workspace | workspace | Root workspace directory |
--releases | 5 | Number of releases to fetch |
--issues | 8 | Number of top issues to fetch |
What it does:
{workspace}/data/research/github.mdUses the GitHub REST API directly — no auth needed for public repos.
python3 skills/research/scripts/fetch_url.py --url https://example.com/blog-post --workspace ./workspace
| Argument | Default | Description |
|---|---|---|
--url | (required) | URL to fetch content from |
--workspace | workspace | Root workspace directory |
--max-chars | 8000 | Max chars to extract |
What it does:
{workspace}/data/research/url_<safe_name>.mdWorks for blog posts, documentation pages, arXiv abstracts, news articles, etc.
If the user provides a topic without a specific source:
{workspace}/data/research/{workspace}/data/research/When reviewing the research output, identify:
Guides the agent on how to handle git operations and generate .patch files instead of submitting PRs.
Guides the agent on how to read and search GitHub issues to understand the repository's problems.
Records and appends every user-agent customer support interaction to the memory.md log in the workspace.
Scans a website deeply, converting HTML pages to markdown, respecting robots.txt, and updating the snapshots log.
Exposes a 100% local, offline PDF batch extraction utility (extract_to_markdown.py) that isolates invoices under invoices/ and translates PDFs into clean Markdown files for LLM-native parsing.
Reconcile loaded expenses against the pre-parsed invoice database, flagging discrepancies like amount mismatches, missing invoices, and merchant mismatches locally.