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
- Repository
- jeremylongshore/tons-of-skills-marketplace
- 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
- 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.
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.
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
- Analyze query complexity and scope
- Check for mode indicators in request
- Consider time/depth tradeoffs
- Select appropriate mode
Phase 2: Research Execution
Quick Mode:
- Identify 3-5 authoritative sources
- Extract key facts and findings
- Synthesize into concise summary
Swarm Mode:
- Search across multiple source types:
- Academic journals
- News sources
- Industry reports
- Government data
- Expert opinions
- Cross-reference findings
- Identify consensus and disagreements
- Synthesize comprehensive report
Hive Mode:
- Decompose topic into 5 sub-questions
- Assign each to specialized focus:
- Historical/Background
- Current State/Data
- Theoretical/Conceptual
- Practical/Applied
- Future/Emerging
- Research each independently
- Integrate findings
- Resolve contradictions
- Produce unified report
Phase 3: Quality Assurance
- Verify all claims are sourced
- Check for balanced perspectives
- Ensure logical flow
- Format citations properly
Phase 4: Delivery
- Save report to output location
- 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
- Content Seo Analyzes page-level traffic performance, classifies rising and declining content, identifies gaps, and recommends data-backed content strategy from Umami analytics. Use when evaluating which content drives results or deciding what to publish next. Trigger with \"analyze content performance\", \"what should I publish next\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Contract Test Validate API contracts with consumer-driven testing and OpenAPI validation Slash Command · jeremylongshore/tons-of-skills-marketplace
- Continue Execute the next step in the current session Slash Command · jeremylongshore/tons-of-skills-marketplace
- Contract Test Validator API contract testing with Pact, OpenAPI validation, and consumer-driven contract verification Plugin · jeremylongshore/tons-of-skills-marketplace
- Geepers System Diag Full-depth infrastructure health check for dr.eamer.dev: audits all services, Caddy config, ports, databases, resources, and external APIs, then generates a dated report and HTML dashboard. Use when something feels wrong or before major changes. Trigger with \"run system diagnostic\", \"full infrastructure audit\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Geepers Status Logs work accomplishments by analyzing git commits and agent reports, then regenerates the HTML status dashboard and JSON data file with cross-project activity tracking. Use when ending a work session or checking recent progress across projects. Trigger with \"log today's work\", \"update the status dashboard\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Geepers System Help Reference guide for the complete geepers agent suite — maps every agent to its purpose and generates an HTML index. Use when unsure which agent to use or to regenerate documentation. Trigger with "which geepers agent", "show me all agents". Subagent · jeremylongshore/tons-of-skills-marketplace
- Geepers Snippets Harvests reusable code patterns from projects into a categorized snippet library, deduplicates existing entries, and updates the searchable JSON index and HTML GUI. Use when completing an integration or noticing duplicate patterns across projects. Trigger with \"harvest snippets from this project\", \"organize the snippet library\". Subagent · jeremylongshore/tons-of-skills-marketplace