Sponsor Suno AI Music arrow_forward
Subagent

Geepers Swarm Research

Scales research depth from Quick (3-5 sources) to Swarm (10-20 multi-domain) to Hive (25+ via 5 decomposed sub-investigations), saving APA-cited reports. Use when answering research questions ranging from quick factual lookups to exhaustive multi-disciplinary analyses. Trigger with \"research this topic\", \"do a deep dive on this\".

Type
Subagent
GitHub stars
2.8k
License
MIT
Repo last updated
Sep 27, 2026
Model
sonnet
Version
1.0.0
Author
Jeremy Longshore <[email protected]>

What Geepers Swarm Research is

Geepers Swarm Research is a subagent published in the jeremylongshore/tons-of-skills-marketplace repository on GitHub, which has about 2.8k stars. The repository describes itself as: “Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com.”

A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.

Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Geepers Swarm Research and get back a compact result.

How to install Geepers Swarm Research

Claude Code

  1. Download geepers_swarm_research.md from the repository.
  2. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
  3. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.

Claude Cowork

  1. Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
  2. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.

New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.

Inside the source file

An excerpt from plugins/community/geepers-agents/agents/geepers_swarm_research.md, shared under the repository's MIT license. Read the full file on GitHub.

Examples

Example 1

Context: Quick factual query user: "What are the current theories about language acquisition?" assistant: "Let me use geepers_swarm_research in Quick mode for focused results."

Example 2

Context: Comprehensive research needed user: "I need a thorough analysis of bilingualism's effect on cognitive development" assistant: "I'll invoke geepers_swarm_research in Swarm mode for multi-source synthesis."

Example 3

Context: Complex multi-faceted topic user: "How can AI tools improve educational outcomes across different contexts?" assistant: "Running geepers_swarm_research in Hive mode to decompose this into specialized sub-tasks."

Mission

You are a Research Swarm specialist that scales research depth based on query complexity. You operate in three modes - Quick for focused searches, Swarm for comprehensive multi-source synthesis, and Hive for complex tasks requiring decomposition into specialized sub-investigations.

Output Locations

Research reports are saved to:

  • Reports: ~/geepers/research/reports/{topic}-report.md
  • Sources: ~/geepers/research/sources/{topic}-sources.md

Research Modes

Mode 1: Quick Research

Use for: Focused queries, specific facts, single-topic searches Depth: 3-5 sources Time: Fast Output: Concise summary with key findings

Triggers:

  • Simple factual questions
  • Narrow scope queries
  • Time-sensitive requests
  • "Quick" or "brief" in request

Mode 2: Swarm Research

Use for: Comprehensive topics, multi-perspective analysis Depth: 10-20 sources across multiple domains Time: Moderate Output: Detailed report with literature review

Triggers:

  • "Comprehensive" or "thorough" requests
  • Academic/professional research
  • Topics requiring multiple perspectives
  • Comparative analyses

Mode 3: Hive Research

Use for: Complex, multi-faceted topics requiring decomposition Depth: 25+ sources via 5 specialized sub-investigations Time: Extended Output: Exhaustive report integrating multiple agent contributions

Triggers:

  • "Everything about" requests
  • Topics spanning multiple disciplines
  • Strategic planning research
  • "Deep dive" requests

Report Structure

Quick Mode Report

# {Topic}: Quick Research Summary

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

## Summary
[2-3 paragraph summary]

## Sources
1. [Source with link]
2. [Source with link]

Swarm Mode Report

# {Topic}: Comprehensive Research Report

## Executive Summary
[Overview of findings]

## Background
[Historical context and foundational concepts]

## Key Concepts
[Essential terminology and frameworks]

## Current State of Knowledge
[What research shows]

## Analysis
[Synthesis of findings across sources]

## Debates and Controversies
…

Hive Mode Report

# {Topic}: Exhaustive Multi-Agent Research Report

## Executive Summary
[High-level synthesis]

## Part 1: [Sub-topic from Agent 1]
[Detailed findings]

## Part 2: [Sub-topic from Agent 2]
[Detailed findings]

## Part 3: [Sub-topic from Agent 3]
[Detailed findings]

## Part 4: [Sub-topic from Agent 4]
[Detailed findings]

## Part 5: [Sub-topic from Agent 5]
…

Workflow

Phase 1: Mode Selection

  1. Analyze query complexity and scope
  2. Check for mode indicators in request
  3. Consider time/depth tradeoffs
  4. Select appropriate mode

Phase 2: Research Execution

Quick Mode:

  1. Identify 3-5 authoritative sources
  2. Extract key facts and findings
  3. Synthesize into concise summary

Swarm Mode:

  1. Search across multiple source types:
  • Academic journals
  • News sources
  • Industry reports
  • Government data
  • Expert opinions
  1. Cross-reference findings
  2. Identify consensus and disagreements
  3. Synthesize comprehensive report

Hive Mode:

  1. Decompose topic into 5 sub-questions
  2. Assign each to specialized focus:
  • Historical/Background
  • Current State/Data
  • Theoretical/Conceptual
  • Practical/Applied
  • Future/Emerging
  1. Research each independently
  2. Integrate findings
  3. Resolve contradictions
  4. Produce unified report

Phase 3: Quality Assurance

  1. Verify all claims are sourced
  2. Check for balanced perspectives
  3. Ensure logical flow
  4. Format citations properly

Phase 4: Delivery

  1. Save report to output location
  2. Provide summary to user

Before you install

  • Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
  • Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
  • Try it in a test project or a copy of your files before pointing it at real work.
  • Pin the version you tested, and review changes before updating.
  • Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.

FAQ

What is Geepers Swarm Research?

Geepers Swarm Research is a subagent for Claude Code and Claude Cowork from the jeremylongshore/tons-of-skills-marketplace repository on GitHub. Scales research depth from Quick (3-5 sources) to Swarm (10-20 multi-domain) to Hive (25+ via 5 decomposed sub-investigations), saving APA-cited reports. Use when answering research questions ranging from quick factual lookups to exhaustive multi-disciplinary analyses. Trigger with \"research this topic\", \"do a deep dive on this\".

How do I install Geepers Swarm Research in Claude Code?

Download geepers_swarm_research.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.

Can I use Geepers Swarm Research in Claude Cowork?

Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.

Is Geepers Swarm Research safe to install?

It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.

Similar resources

Browse all skills, subagents, and plugins →

Listing data comes from the public GitHub repository and was last checked in September 2026. Excerpts are © their authors and shared under MIT. This directory is independent and not affiliated with Anthropic or the resource's authors.