agentleFS
jord0-cmdjord0-cmd/jord0.skills/skills/RECON/SKILL.md

RECON

Skill1 starsChanged 8 months agoMITView on GitHub

Deep technical research that persists. Use when: exploring new technologies, investigating frameworks, comparative analysis of tools, understanding complex systems, or any research task that should be saved for future reference. Invokes Claude's built-in research agent and auto-saves results to a knowledge base for retrieval across sessions.

We split this skill into the rules it gives an agent

5 rules. 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 19 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before researching, RECON checks the knowledge base for existing reports on the topic.

    line 38
  2. Distinctive:

    Search multiple sources (web, documentation, repos)

    line 43
  3. Distinctive:

    When this skill is invoked:

    line 69
  4. Distinctive:

    Every RECON report follows this format:

    line 83
  5. Distinctive:

    Create the following directory structure:

    line 115

“Common” is measured: kept by at least 6 in 10 of the 19 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

RECON

Deep research. Persistent results. Never research the same thing twice.


Usage

/recon [topic]                     - Research a topic in depth
/recon --quick [topic]             - Quick overview (5-10 minutes)
/recon --deep [topic]              - Comprehensive investigation (30+ minutes)
/recon --compare [A] vs [B]       - Comparative analysis

What This Is

RECON is a research skill that produces thorough technical reports and automatically saves them to a local knowledge base. Next time you (or Claude) need the same information, it's already there — no redundant web searches, no lost research.


The Research Process

1. Check Existing Knowledge

Before researching, RECON checks the knowledge base for existing reports on the topic. If a relevant report exists, it surfaces that first and asks if an update is needed.

2. Conduct Research

Uses Claude's built-in technical-research-agent to:

  • Decompose the topic into subtopics
  • Search multiple sources (web, documentation, repos)
  • Synthesize findings into a structured report
  • Identify code examples and implementation patterns

3. Save Results

Reports are saved as markdown files to the knowledge base directory:

knowledge/
  research/
    2024-01-15_react-server-components.md
    2024-01-20_rust-vs-go-backends.md
    2024-02-01_vector-databases-comparison.md
  index.json    # Master index for search

4. Index for Future Retrieval

The report is indexed with:

  • Title, topic, date
  • Key technologies mentioned
  • Summary for quick scanning
  • Tags for semantic search

AUTO-EXECUTE Protocol

When this skill is invoked:

  1. Parse the topic from the user's message
  2. Check knowledge base — search knowledge/index.json for existing research
  3. If found: Display the existing report summary, ask if an update is needed
  4. If not found: Launch the technical-research-agent (Task tool, subagent_type: technical-research-agent)
  5. Save the report to knowledge/research/YYYY-MM-DD_<topic-slug>.md
  6. Update the index with metadata
  7. Summarize findings to the user

Report Structure

Every RECON report follows this format:

# [Topic]

## Summary
One-paragraph executive summary.

## Key Findings
- Finding 1
- Finding 2
- Finding 3

## Deep Dive
Detailed analysis with code examples where relevant.

## Comparison (if applicable)
| Feature | Option A | Option B |
|---------|----------|----------|
| ...     | ...      | ...      |

## Recommendations
What to use and why, given the context.

## Sources
Links to documentation, articles, repos referenced.

Knowledge Base Setup

Create the following directory structure:

knowledge/
  research/      # Research reports (markdown)
  references/    # Quick reference docs
  index.json     # Master index

The index.json schema:

{
  "entries": [
    {
      "id": "k-001",
      "title": "React Server Components Deep Dive",
      "file": "research/2024-01-15_react-server-components.md",
      "date": "2024-01-15",
      "tags": ["react", "rsc", "frontend", "server-components"],
      "summary": "One-line summary for quick scanning"
    }
  ]
}

When to Use

  • Evaluating a new framework or library
  • Comparing architectural approaches
  • Understanding a technology before prototyping
  • Any research you don't want to repeat next week

Prerequisites

  • Claude Code with Task tool access (the technical-research-agent is a built-in Claude Code subagent — no external setup needed)
  • File system access for knowledge base storage
  • Web search access for current information (WebSearch tool must be available)

Note: The technical-research-agent is part of Claude Code itself, not an external service. If you have Claude Code, you have the agent.


Research once. Remember forever.

Download now (ZIP)

  • Other versions23 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 23

    1. codexstar69/bug-hunter★ 546same name
    2. briiirussell/cybersecurity-skills★ 489same name
    3. gavraz/recon★ 263same name
    4. skyf0xx/gambit★ 29same name
    5. wycats/ai-plugin★ 19same name
    6. wycats/vscode-ai-plugin★ 19same name
    7. sophonfinance-wq/finance-automation-portfolio★ 16same name
    8. franco-bianco/claude-skills★ 4same name
    9. kekurttel/pentest-skills★ 4same name
    10. Roshu18/bearstrike-ai★ 4same name

    13 more not listed

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use reporting and osint.

    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

  • In this repository13 other files it gives its agents.

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.