| name | scry |
| version | 1.0.0 |
| description | Research any topic across 26+ sources: Reddit, X, YouTube, GitHub, HN, Bluesky, ArXiv, Dev.to, Polymarket, and more. The most comprehensive research skill available. |
| argument-hint | scry AI agents, scry best Claude Code skills, scry bitcoin ETF --deep |
| allowed-tools | Bash, Read, Write, WebSearch |
| homepage | https://github.com/khalidsh/scry-skill |
| user-invocable | true |
SCRY v1.0 — Research Any Topic Across 26+ Sources
Search Reddit, X, YouTube, GitHub, Hacker News, Bluesky, Dev.to, ArXiv, Polymarket, Stack Overflow, Product Hunt, Mastodon, Wikipedia, GDELT, CoinGecko, SEC EDGAR, TikTok, Instagram, HuggingFace, Substack, and more. Surface what people are discussing, building, citing, betting on, and debating right now.
CRITICAL: Parse User Intent
Before doing anything, parse the user's input for:
- TOPIC: What they want to learn about
- TARGET TOOL (if specified): Where they'll use the prompts
- QUERY TYPE:
- RECOMMENDATIONS — "best X", "top X" → wants a LIST
- NEWS — "what's happening with X" → wants current events
- PROMPTING — "X prompts" → wants techniques + copy-paste prompts
- GENERAL — anything else → wants broad understanding
- DOMAIN: Auto-detected or user-specified
- tech — programming, AI, software, frameworks
- science — research, papers, experiments
- finance — stocks, earnings, markets
- crypto — blockchain, tokens, DeFi
- news — politics, geopolitics, events
- entertainment — movies, music, gaming, social
- general — everything else
Store these variables:
TOPIC = [extracted topic]TARGET_TOOL = [extracted tool, or "unknown"]QUERY_TYPE = [RECOMMENDATIONS | NEWS | PROMPTING | GENERAL]DOMAIN = [auto-detected or user-specified]
DISPLAY your parsing:
I'll research {TOPIC} across 26+ sources to find what's been discussed in the last 30 days.
Parsed intent:
- TOPIC = {TOPIC}
- DOMAIN = {DOMAIN}
- QUERY_TYPE = {QUERY_TYPE}
- TARGET_TOOL = {TARGET_TOOL or "unknown"}
Research typically takes 1-3 minutes. Starting now.
Research Execution
Step 1: Run the SCRY script (FOREGROUND — do NOT background this)
CRITICAL: Run in FOREGROUND with 5-minute timeout. Read the ENTIRE output.
for dir in \
"." \
"${CLAUDE_PLUGIN_ROOT:-}" \
"$HOME/.claude/skills/scry" \
"$HOME/.agents/skills/scry"; do
[ -n "$dir" ] && [ -f "$dir/scripts/scry.py" ] && SKILL_ROOT="$dir" && break
done
if [ -z "${SKILL_ROOT:-}" ]; then
echo "ERROR: Could not find scripts/scry.py" >&2
exit 1
fi
python3 "${SKILL_ROOT}/scripts/scry.py" "$ARGUMENTS" --emit=compact
Use a timeout of 300000 (5 minutes) on the Bash call.
The script will automatically:
- Detect your domain (tech/science/finance/crypto/news/entertainment/general)
- Discover available API keys and binaries
- Search all available sources in parallel
- Score results with domain-aware weights
- Deduplicate and cross-link across sources
- Detect conflicts between sources
- Output a comprehensive research report
Read the ENTIRE output. It contains sections for every source that returned results.
Add --domain=DOMAIN if you detected the domain in intent parsing.
Add --deep if the user asked for comprehensive results.
Step 2: WebSearch Supplement
After the script finishes, do WebSearch to supplement with blogs, tutorials, and news.
Choose queries based on QUERY_TYPE:
- RECOMMENDATIONS:
best {TOPIC} recommendations, {TOPIC} list examples
- NEWS:
{TOPIC} news 2026, {TOPIC} announcement update
- PROMPTING:
{TOPIC} prompts examples 2026, {TOPIC} techniques tips
- GENERAL:
{TOPIC} 2026, {TOPIC} discussion
Exclude reddit.com, x.com, twitter.com (covered by script).
Judge Agent: Synthesize All Sources
Ground your synthesis in the ACTUAL research content, not pre-existing knowledge.
- Weight sources by domain relevance (tech: GitHub/HN/SO highest; science: ArXiv/S2 highest; etc.)
- Cross-platform signals are strongest — items with
[also on: ...] tags are most important
- Note conflicts between sources (flagged in the output)
- Extract top 3-5 actionable insights
CITATION RULES
- Cite sparingly: 1-2 per topic, 1 per pattern
- Priority: @handles > r/subreddits > YouTube channels > GitHub repos > HN > ArXiv > web
- Never paste raw URLs — use source names
- BAD: "per https://arxiv.org/abs/..." → GOOD: "per ArXiv"
- BAD: "per @x, @y, @z" → GOOD: "per @x" (pick strongest)
If QUERY_TYPE = RECOMMENDATIONS
Extract SPECIFIC NAMES — products, tools, repos, people. Count mentions. List by popularity.
Display Format
FIRST — What I learned:
What I learned:
**{Topic 1}** — [1-2 sentences, per @handle or r/sub]
**{Topic 2}** — [1-2 sentences, per @handle or r/sub]
KEY PATTERNS from the research:
1. [Pattern] — per @handle
2. [Pattern] — per r/sub
3. [Pattern] — per GitHub repo
THEN — Stats (copy EXACTLY, replacing placeholders):
The script outputs a stats block — display it as-is. If it doesn't appear, build one:
---
✅ All agents reported back!
├─ 🟡 HN: {N} stories │ {N} points │ {N} comments
├─ 🦞 Lobsters: {N} items │ {N} points
├─ 📝 Dev.to: {N} articles │ {N} reactions
├─ 🐙 GitHub: {N} repos │ {N}★
├─ 🦋 Bluesky: {N} posts │ {N} likes
├─ 🟠 Reddit: {N} threads │ {N} upvotes
├─ 🔵 X: {N} posts │ {N} likes
├─ 🔴 YouTube: {N} videos │ {N} views
├─ 📄 ArXiv: {N} papers │ {N} citations
├─ 📊 Polymarket: {N} markets │ {odds summary}
├─ 🌐 Web: {N} pages — Source, Source, Source
└─ 🗣️ Top voices: @handle1, @handle2 │ r/sub1, r/sub2
---
Omit any source line that returned 0 results.
LAST — Invitation (adapt to QUERY_TYPE):
Include 2-3 SPECIFIC suggestions based on research findings.
WAIT FOR USER'S RESPONSE
After showing results, STOP and wait.
WHEN USER RESPONDS
- Question → Answer from research (no new searches)
- Go deeper → Elaborate using findings
- Create something → Write a tailored prompt
- Different topic → Run new research
Agent Mode (--agent flag)
If --agent in ARGUMENTS:
- Skip intro display
- Skip AskUserQuestion calls
- Run research + output report
- Stop (no follow-up invitation)
Security & Permissions
What this skill does:
- Searches 26+ public APIs and RSS feeds for research data
- Runs
gh CLI for GitHub search (uses your existing auth)
- Runs
yt-dlp for YouTube search (public data)
- Optionally uses ScrapeCreators API for TikTok/Instagram
- Stores cached results in ~/.cache/scry/ (24h TTL)
What this skill does NOT do:
- Does not post, like, or modify content on any platform
- Does not access private accounts or data
- Does not share API keys between providers
- Does not write to any external service
Bundled scripts: scripts/scry.py (orchestrator), scripts/lib/ (shared utilities + source modules)
