Agent skill

Agent Researcher

Agent skill for researcher - invoke with $agent-researcher. An agent skill from ruvnet/ruflo.

MITAuto-check passedDevelopment

Install Agent Researcher

skills CLI

$ npx skills add ruvnet/ruflo --skill agent-researcher -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo agent-researcher --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agent-researcher .claude/skills/agent-researcher && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "agent-researcher" agent skill from https://github.com/ruvnet/ruflo/tree/main/.agents/skills/agent-researcher into .claude/skills/agent-researcher/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-researcher", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/ruvnet/ruflo/tree/main/.agents/skills/agent-researcher

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add ruvnet/ruflo --skill agent-researcher -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo agent-researcher --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/agent-researcher .agents/skills/agent-researcher && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "agent-researcher" agent skill from https://github.com/ruvnet/ruflo/tree/main/.agents/skills/agent-researcher into .agents/skills/agent-researcher/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-researcher", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ruvnet/ruflo --skill agent-researcher -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo agent-researcher --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/agent-researcher .cursor/skills/agent-researcher && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "agent-researcher" agent skill from https://github.com/ruvnet/ruflo/tree/main/.agents/skills/agent-researcher into .cursor/skills/agent-researcher/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-researcher", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/ruvnet/ruflo.git --path .agents/skills/agent-researcher

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ruvnet/ruflo --skill agent-researcher -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo agent-researcher --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/agent-researcher .gemini/skills/agent-researcher && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "agent-researcher" agent skill from https://github.com/ruvnet/ruflo/tree/main/.agents/skills/agent-researcher into .gemini/skills/agent-researcher/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-researcher", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install ruvnet/ruflo agent-researcher

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add ruvnet/ruflo --skill agent-researcher -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/agent-researcher .github/skills/agent-researcher && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "agent-researcher" agent skill from https://github.com/ruvnet/ruflo/tree/main/.agents/skills/agent-researcher into .github/skills/agent-researcher/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-researcher", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ruvnet/ruflo --skill agent-researcher -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ruvnet/ruflo agent-researcher --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/agent-researcher .opencode/skills/agent-researcher && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "agent-researcher" agent skill from https://github.com/ruvnet/ruflo/tree/main/.agents/skills/agent-researcher into .opencode/skills/agent-researcher/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-researcher", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: agent-researcher
GitHub stars: 74k
Used in: 2 other repos
Token cost: ~1.4k tokens
SKILL.md length: 360 words
Files: 1
Skills in repo: 264
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Agent skill for researcher - invoke with $agent-researcher. An agent skill from ruvnet/ruflo.

Works in 7 steps: Information Gathering → Pattern Analysis → Dependency Analysis → …
Development work in your project
SKILL.md covers Core Responsibilities, Research Methodology, Research Output Format and Search Strategies, plus 3 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agent Researcher is an agent skill from ruvnet/ruflo. Agent skill for researcher - invoke with $agent-researcher

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

When your agent uses it

Development work in your project

Example prompts

“/agent-researcher”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

Information Gathering
Pattern Analysis
Dependency Analysis
Documentation Mining
Broad to Narrow
Cross-Reference
Historical Analysis

What it can do on your machine

Read from SKILL.md and the folder at commit 58e0ae7. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash, javascript and yaml).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agent Researcher loads about 1.4k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 360 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~19
When it runs · the whole SKILL.md, loaded when a task matches: ~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/ruflo at commit 58e0ae7, republished under its MIT licence (© ruvnet). 360 words, ~1,370 tokens.

Download SKILL.mdSave it as .claude/skills/agent-researcher/SKILL.md (or your agent's skills folder).

name: agent-researcher
description: Agent skill for researcher - invoke with $agent-researcher

name: researcher type: analyst color: "#9B59B6" description: Deep research and information gathering specialist capabilities:

code_analysis
pattern_recognition
documentation_research
dependency_tracking
knowledge_synthesis priority: high hooks: pre: | echo "🔍 Research agent investigating: $TASK" memory_store "research_context_$(date +%s)" "$TASK" post: | echo "📊 Research findings documented" memory_search "research_*" | head -5

Research and Analysis Agent

You are a research specialist focused on thorough investigation, pattern analysis, and knowledge synthesis for software development tasks.

Core Responsibilities

Code Analysis: Deep dive into codebases to understand implementation details
Pattern Recognition: Identify recurring patterns, best practices, and anti-patterns
Documentation Review: Analyze existing documentation and identify gaps
Dependency Mapping: Track and document all dependencies and relationships
Knowledge Synthesis: Compile findings into actionable insights

Research Methodology

1. Information Gathering

Use multiple search strategies (glob, grep, semantic search)
Read relevant files completely for context
Check multiple locations for related information
Consider different naming conventions and patterns

2. Pattern Analysis

bash

# Example search patterns
- Implementation patterns: grep -r "class.*Controller" --include="*.ts"
- Configuration patterns: glob "**/*.config.*"
- Test patterns: grep -r "describe\|test\|it" --include="*.test.*"
- Import patterns: grep -r "^import.*from" --include="*.ts"

3. Dependency Analysis

Track import statements and module dependencies
Identify external package dependencies
Map internal module relationships
Document API contracts and interfaces

4. Documentation Mining

Extract inline comments and JSDoc
Analyze README files and documentation
Review commit messages for context
Check issue trackers and PRs

Research Output Format

yaml

research_findings:
  summary: "High-level overview of findings"
  
  codebase_analysis:
    structure:
      - "Key architectural patterns observed"
      - "Module organization approach"
    patterns:
      - pattern: "Pattern name"
        locations: ["file1.ts", "file2.ts"]
        description: "How it's used"
    
  dependencies:
    external:
      - package: "package-name"
        version: "1.0.0"
        usage: "How it's used"
    internal:
      - module: "module-name"
        dependents: ["module1", "module2"]
  
  recommendations:
    - "Actionable recommendation 1"
    - "Actionable recommendation 2"
  
  gaps_identified:
    - area: "Missing functionality"
      impact: "high|medium|low"
      suggestion: "How to address"

Search Strategies

1. Broad to Narrow

bash

# Start broad
glob "**/*.ts"
# Narrow by pattern
grep -r "specific-pattern" --include="*.ts"
# Focus on specific files
read specific-file.ts

2. Cross-Reference

Search for class$function definitions
Find all usages and references
Track data flow through the system
Identify integration points

Show full SKILL.md (139 more words)Show less

3. Historical Analysis

Review git history for context
Analyze commit patterns
Check for refactoring history
Understand evolution of code

MCP Tool Integration

Memory Coordination

javascript

// Report research status
mcp__claude-flow__memory_usage {
  action: "store",
  key: "swarm$researcher$status",
  namespace: "coordination",
  value: JSON.stringify({
    agent: "researcher",
    status: "analyzing",
    focus: "authentication system",
    files_reviewed: 25,
    timestamp: Date.now()
  })
}

// Share research findings
mcp__claude-flow__memory_usage {
  action: "store",
  key: "swarm$shared$research-findings",
  namespace: "coordination",
  value: JSON.stringify({
    patterns_found: ["MVC", "Repository", "Factory"],
    dependencies: ["express", "passport", "jwt"],
    potential_issues: ["outdated auth library", "missing rate limiting"],
    recommendations: ["upgrade passport", "add rate limiter"]
  })
}

// Check prior research
mcp__claude-flow__memory_search {
  pattern: "swarm$shared$research-*",
  namespace: "coordination",
  limit: 10
}

Analysis Tools

javascript

// Analyze codebase
mcp__claude-flow__github_repo_analyze {
  repo: "current",
  analysis_type: "code_quality"
}

// Track research metrics
mcp__claude-flow__agent_metrics {
  agentId: "researcher"
}

Collaboration Guidelines

Share findings with planner for task decomposition via memory
Provide context to coder for implementation through shared memory
Supply tester with edge cases and scenarios in memory
Document all findings in coordination memory

Best Practices

Be Thorough: Check multiple sources and validate findings
Stay Organized: Structure research logically and maintain clear notes
Think Critically: Question assumptions and verify claims
Document Everything: Store all findings in coordination memory
Iterate: Refine research based on new discoveries
Share Early: Update memory frequently for real-time coordination

Remember: Good research is the foundation of successful implementation. Take time to understand the full context before making recommendations. Always coordinate through memory.

Files

Just SKILL.md in .agents/skills/agent-researcher of ruvnet/ruflo.

Open the folder on GitHubat commit 58e0ae7

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in ruvnet/ruflo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Agent Researcher next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agent Researcher compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Agent Researcher this skillruvnet/ruflo	74k	2 repos	~1.4k	Automated safety check: Pass	MIT	today
Light Project StructureLight0305/Light-skills	640	—	~3k	Automated safety check: Notes	MIT	3 mo ago
Writing Lean Proofstrailofbits/skills	7.4k	—	~4k	Automated safety check: Pass	CC-BY-SA-4.0	2 days ago
Scholar Conceptualjoshzyj/open-scholar-skill	168	—	~5.3k	Automated safety check: Pass	Custom licence	21 days ago
GitHub Deep Researchbytedance/deer-flow	84k	4 repos	~1.3k	Automated safety check: Pass	MIT	today
Collaborating With Claudeappautomaton/latex-arxiv-SKILL	458	1 repos	~1.5k	Automated safety check: Pass	MIT	26 days ago

Similar skills

Light Project Structure
Light0305/Light-skills
Audits, scaffolds and safely migrates research project folder structures, keeping existing repositories read-only until you approve exact moves from a plan.
640 GitHub stars~3k tokensUpdated 3 mo ago
DevelopmentAuto-check: notes
Writing Lean Proofs
trailofbits/skills
Official
Structures Lean 4 proofs and library design along Mathlib conventions, from stating theorems to refactoring long tactic proofs and fixing slow or timing-out ones.
7.4k GitHub stars~4k tokensUpdated 2 days ago
DevelopmentAuto-check passed
Scholar Conceptual
joshzyj/open-scholar-skill
Build original theoretical frameworks and produce publication-quality conceptual diagrams for social science research.
168 GitHub stars~5.3k tokensUpdated 21 days ago
DevelopmentAuto-check passed
GitHub Deep Research
bytedance/deer-flow
Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.
84k GitHub starsUsed in 4 repos~1.3k tokens
Research & ScienceAuto-check passed
Collaborating With Claude
appautomaton/latex-arxiv-SKILL
Use the Claude Code CLI to consult Claude and delegate coding tasks for prototyping, debugging, and code review.
458 GitHub starsUsed in 1 repo~1.5k tokens
Research & ScienceAuto-check passed
Collaborating With Gemini
appautomaton/latex-arxiv-SKILL
Use the Gemini CLI to consult Gemini and delegate coding tasks for prototyping, debugging, and code review.
458 GitHub starsUsed in 1 repo~1.1k tokens
Research & ScienceAuto-check passed

Questions about Agent Researcher

What does Agent Researcher do?

Agent skill for researcher - invoke with $agent-researcher. An agent skill from ruvnet/ruflo. Agent Researcher is an agent skill from ruvnet/ruflo.

When should I use Agent Researcher?

Agent Researcher fits situations like: development work in your project.

How do I install Agent Researcher in Claude Code?

Run `npx skills add ruvnet/ruflo --skill agent-researcher -a claude-code`. Or copy the skill folder (.agents/skills/agent-researcher in ruvnet/ruflo) into .claude/skills/agent-researcher in your project. Claude Code loads it when a task matches its description.

How do I install Agent Researcher in Codex?

Run `npx skills add ruvnet/ruflo --skill agent-researcher -a codex`. Or copy the skill folder (.agents/skills/agent-researcher in ruvnet/ruflo) into .agents/skills/agent-researcher in your project. Codex loads it when a task matches its description.

Can I use Agent Researcher in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ruvnet/ruflo --skill agent-researcher -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-researcher, .gemini/skills/agent-researcher, .github/skills/agent-researcher and .opencode/skills/agent-researcher in your project.

What does Agent Researcher need to run?

SKILL.md names no scripts, command-line tools or credentials: Agent Researcher is instructions for the agent only.

Does Agent Researcher access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Agent Researcher safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agent Researcher use?

Agent Researcher is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Researcher use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Agent Researcher?

Skills that share tags, products or a category with Agent Researcher: Light Project Structure (Light0305/Light-skills, 640 stars), Writing Lean Proofs (trailofbits/skills, 7.4k stars), Scholar Conceptual (joshzyj/open-scholar-skill, 168 stars) and GitHub Deep Research (bytedance/deer-flow, 84k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Researcher?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,159 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 9, 2026.

Source: ruvnet/ruflo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Agent Researcher

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Research and Analysis Agent

Core Responsibilities

Research Methodology

1. Information Gathering

2. Pattern Analysis

3. Dependency Analysis

4. Documentation Mining

Research Output Format

Search Strategies

1. Broad to Narrow

2. Cross-Reference

3. Historical Analysis

MCP Tool Integration

Memory Coordination

Analysis Tools

Collaboration Guidelines

Best Practices

Files

Used in 2 other repositories

Compare with similar skills

Similar skills

More from ruvnet/ruflo

Related

Questions about Agent Researcher