agentleFS
brennantimbrennantim/claude-skills/recon/SKILL.md

recon

Skill0 starsChanged 9 months agoMITView on GitHub

Multi-source reconnaissance combining X/Twitter trends, Reddit community analysis, and web search into a synthesized intelligence brief. Use when asked to research trends, analyze communities, scan discussions, gather intelligence, or run recon on any topic.

  • Reads credentials
  • Installs packages

32 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use reporting, osint and 3 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • GitHubSkill

    reporting

    Report formatting guidelines for gh-aw workflows (header levels, collapsible details, run-ID links)

    Also in 3 projects that use this

  • JosBen74Skill

    osint

    OSINT-sökning och informationsinhämtning från öppna källor för Länsstyrelsen VG

    Also in 4 projects that use this

  • samklee1Skill

    web-pentest

    Orchestrates authorized web app pentesting on Kali Linux using Opus sub-agents with difficulty-aware planning (TDA/EGATS), browser-first exploration, iterative verification, two-layer review (per-sub-agent + phase-level), optional cross-model gap audit (GPT/codex via codex-plugin-cc), and enforced KB updates. Trigger on: pentesting, penetration testing, web app security assessment, vulnerability assessment, OWASP testing, PTES, attack surface mapping, API security testing, pentest reporting, or 'help me test this app'. NOT for network-only pentesting, malware analysis, reverse engineering, or CTFs.

    Also in 3 projects that use this

  • SentrySkill

    create-pr

    Create pull requests following Sentry conventions. Use when opening PRs, writing PR descriptions, or preparing changes for review. Follows Sentry's code review guidelines.

    Also in 3 projects that use this

  • NVIDIASkill

    research

    Before designing a feature, research how comparable libraries solve the problem, check best practices, known pitfalls, and upstream changes. Use when starting a new feature, investigating an unfamiliar area, or the user asks to research something.

    Also in 3 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

15 rules. 0 are common, 9 are distinctive, and 6 are very specific to this project.

  • 0

    Common

    Most of the 27 edited versions we read keep these.

  • 9

    Distinctive

    This author's own choices. Worth a look.

  • 6

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run domain-specific reconnaissance across X/Twitter, Reddit, and web search, then synthesize findings into an actionable intelligence brief.

    line 10
  2. Very specific:

    Create recon-config.json in your project root (see config guide for schema and examples)

    line 15
  3. Very specific:

    Read recon-config.json from project root.

    line 54
  4. Very specific:

    If $ARGUMENTS has a topic: auto-generate queries for that topic (skip config)

    line 55
  5. Distinctive:

    If no topic: offer to create a config interactively using config-guide.md

    line 56
  6. Distinctive:

    Check which sources to run:

    line 60
  7. Very specific:

    Start with config sources.*.enabled flags

    line 61
  8. Distinctive:

    Web: Always available (uses WebSearch tool).

    line 66
  9. Distinctive:

    If no sources are available, tell the user what to install and exit.

    line 68
  10. Distinctive:

    After all source agents complete, launch the synthesis agent:

    line 173
  11. Very specific:

    After synthesis completes, read {output_dir}/synthesis.md and display the executive summary to the user:

    line 191
  12. Very specific:

    When $ARGUMENTS contains a topic (not a flag):

    line 215
  13. Distinctive:

    Use the topic as the domain context

    line 217
  14. Distinctive:

    Run the standard workflow

    line 223
  15. Distinctive:

    No setup needed — uses Claude's built-in WebSearch tool.

    line 240

“Common” is measured: kept by at least 6 in 10 of the 27 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Multi-Source Recon

Run domain-specific reconnaissance across X/Twitter, Reddit, and web search, then synthesize findings into an actionable intelligence brief.

Quick Start

Config-driven (recommended):

  1. Create recon-config.json in your project root (see config guide for schema and examples)
  2. Run /recon

Ad-hoc (no config needed):

  • /recon AI coding assistants — auto-generates queries from the topic
  • /recon --sources reddit,web — specific sources only

Arguments

ArgumentDescriptionDefault
$ARGUMENTS (positional)Ad-hoc topic to researchUses config queries
--sources x,reddit,webWhich sources to runAll enabled in config
--days NOverride lookback periodConfig value or 7

Scripts

X Search (scripts/x_search.py)

python3 ~/.claude/skills/recon/scripts/x_search.py --query "QUERY" [--handles h1,h2] [--days 7] [--output FILE]

Requires: pip install xai-sdk + XAI_API_KEY env var. Results cached 24h in $TMPDIR/recon-cache/.

Sandbox note: X API calls may need dangerouslyDisableSandbox: true on the Bash command due to DNS resolution in sandboxed environments.

Reddit Search (scripts/reddit_search.py)

python3 ~/.claude/skills/recon/scripts/reddit_search.py --subreddits SUB1,SUB2 --sort hot,rising,top --limit 20 [--deep-dive 5] [--output FILE]

Requires: pip install redditwarp. No API keys needed (unauthenticated public access). Outputs structured JSON.

Workflow

1. Load Configuration

Read recon-config.json from project root. If it doesn't exist:

  • If $ARGUMENTS has a topic: auto-generate queries for that topic (skip config)
  • If no topic: offer to create a config interactively using config-guide.md

2. Determine Sources

Check which sources to run:

  1. Start with config sources.*.enabled flags
  2. Override with --sources flag if provided
  3. Check availability:
    • X: Try import xai_sdk. If missing, print "Skipping X (run: pip install xai-sdk)" and skip.
    • Reddit: Try import redditwarp. If missing, print "Skipping Reddit (run: pip install redditwarp)" and skip.
    • Web: Always available (uses WebSearch tool).

If no sources are available, tell the user what to install and exit.

3. Create Output Directory

from datetime import datetime
import os
output_dir = f"recon/{datetime.now().strftime('%Y-%m-%d')}"
os.makedirs(output_dir, exist_ok=True)

4. Run Sources in Parallel

Launch enabled sources using the Agent tool. Run all available sources in parallel (single message, multiple Agent calls).

For X source — launch Agent:

subagent_type: general-purpose
prompt: |
  Run X/Twitter trend analysis.

  Script: python3 ~/.claude/skills/recon/scripts/x_search.py

  Config queries: {config.sources.x.queries}
  Handles: {config.sources.x.handles}
  Days: {config.sources.x.days}

  For each query in config, run the script and collect output.
  If there are multiple queries, run them sequentially and combine results.

  Write a structured report to: {output_dir}/x_trends_report.md

  Report format:
  # X/Twitter Trends Report
  **Date:** {date}

  ## Top Trending Topics
  ## Key Posts
  ## Emerging Questions
  ## Notable Debates
  ## Key Insights

  IMPORTANT: The Bash command running x_search.py may need dangerouslyDisableSandbox: true
  if you get DNS or network errors in the sandbox.

For Reddit source — launch Agent:

subagent_type: general-purpose
prompt: |
  Run Reddit community analysis.

  Script: python3 ~/.claude/skills/recon/scripts/reddit_search.py

  Subreddits: {config.sources.reddit.subreddits}
  Sort: {config.sources.reddit.sort}
  Limit: {config.sources.reddit.limit}
  Deep dive: {config.sources.reddit.deep_dive}

  Run the script and parse the JSON output. Then write an analysis report.

  Save to: {output_dir}/reddit_report.md

  Report format:
  # Reddit Community Report
  **Date:** {date}

  ## Hot Topics by Subreddit
  (For each subreddit: top posts with title, score, comments, brief analysis)

  ## Rising Discussions
  (Early signals gaining traction)

  ## Top Weekly Posts
  (What resonated most)

  ## Recurring Questions
  (Questions appearing across communities)

  ## Active Debates
  (Disagreements driving engagement)

  ## Deep Dive Highlights
  (Key insights from comment threads)

  ## Key Insights
  (Cross-subreddit patterns, engagement signals)

For Web source — launch Agent:

subagent_type: general-purpose
prompt: |
  Run web research analysis. Read the instructions at:
  ~/.claude/skills/recon/references/web-agent.md

  Config: {paste relevant config.sources.web section}
  Domain: {config.domain}
  Description: {config.description}

  Save report to: {output_dir}/web_report.md

5. Run Synthesis

After all source agents complete, launch the synthesis agent:

subagent_type: general-purpose
prompt: |
  Synthesize recon findings. Read the instructions at:
  ~/.claude/skills/recon/references/synthesis-agent.md

  Read all reports in: {output_dir}/
  Config domain: {config.domain}
  Config description: {config.description}
  Synthesis focus: {config.synthesis.focus}

  Save synthesis to: {output_dir}/synthesis.md

6. Display Summary

After synthesis completes, read {output_dir}/synthesis.md and display the executive summary to the user:

Recon Complete — {config.domain} — {date}

Sources: {list of sources that ran}
Output: {output_dir}/

{Paste executive summary from synthesis.md}

Key recommendations:
1. {First recommendation}
2. {Second recommendation}
3. {Third recommendation}

Full reports:
- {output_dir}/synthesis.md (cross-source analysis)
- {output_dir}/x_trends_report.md
- {output_dir}/reddit_report.md
- {output_dir}/web_report.md

Ad-Hoc Topic Mode

When $ARGUMENTS contains a topic (not a flag):

  1. Use the topic as the domain context
  2. Auto-generate appropriate queries:
    • X: "What are people discussing about {topic}? Trends, debates, questions."
    • Reddit: Infer 2-3 relevant subreddits from the topic
    • Web: Generate 3-4 search queries like "{topic} trends {year}", "{topic} community discussion", "{topic} latest developments"
  3. Set synthesis focus to "trend_monitoring"
  4. Run the standard workflow

Environment Setup

Required for X source

pip install xai-sdk
export XAI_API_KEY="your-key-here"  # Get at https://console.x.ai

Required for Reddit source

pip install redditwarp
# No API keys needed — uses public unauthenticated access

Web source

No setup needed — uses Claude's built-in WebSearch tool.

Install everything at once

pip install xai-sdk redditwarp

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.