research.autonomous.swarm

Orchestrates parallel autonomous agents with distinct exploration strategies for LLM hyperparameter research.

Updated May 9, 2026
One-click install
npx skills add https://github.com/0h-n0/auto-research --skill research-autonomous-swarm-0h-n0
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research.autonomous.swarm
Source: https://github.com/0h-n0/auto-research/tree/main/skills/research.autonomous.swarm
Command: npx skills add https://github.com/0h-n0/auto-research --skill research-autonomous-swarm-0h-n0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Single-agent autonomous hill-climbing for LLM experiments gets stuck in local optima, repeats the same failure patterns, and leaves most of the search space unexplored. This Skill runs N agents in parallel, each with a different exploration strategy, so overnight research covers a wider search space and escapes local optima. ## Core Features & Use Cases - Multi-agent parallel exploration: Spawns N agents (default 3) in isolated workspaces under .research/<slug>/swarm/agent_<id>/tinker/, each running the autonomous tinker loop with its own strategy. - Five exploration strategies: depth-explore (model scale), lr-explore (optimization), arch-explore (structural ideas like RoPE/RMSNorm/SwiGLU), batch-explore (throughput vs gradient noise), and random-restart (uniform sampling to escape local optima). - File-based orchestration: swarm_orchestrate.sh periodically aggregates each agent's BEST.json into SHARED_BEST.json and SWARM_RESULTS.md using flock-based locking and atomic writes, with optional cross-pollination via a shared best_train.py snapshot. - Use Case: Launch a 3-agent overnight swarm on a language-model pretraining task where one agent tunes depth/width, another sweeps learning rates, and a third tries architectural variants, then read the aggregated SWARM_RESULTS.md to find the global best configuration. ## Quick Start Initialize a 3-agent research swarm for my project slug and start each agent's autonomous tinker loop with its assigned exploration strategy.

Frequently Asked Questions about research.autonomous.swarm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run multiple autonomous LLM research agents in parallel?▼

Run swarm_init.sh with your project slug and agent count to scaffold one tinker workspace per agent, then launch each agent's tinker_run.sh loop with its own --workspace path. Each agent follows a strategy-specific program.md and works independently.

What exploration strategies does a multi-agent research swarm use?▼

Five strategies are defined: depth-explore for model scale, lr-explore for optimization hyperparameters, arch-explore for structural changes like RoPE or RMSNorm, batch-explore for throughput tradeoffs, and random-restart for uniform sampling to escape local optima.

How do parallel agents share results without race conditions?▼

Agents write only inside their own agent_<id> directory using atomic tmp-plus-rename writes and append-only logs. The orchestrator holds an flock on orchestrator.lock while reading all BEST.json files and writing SHARED_BEST.json, so concurrent cron runs safely skip.

When should I use a swarm instead of a single autonomous tinker agent?▼

Use the swarm when a single agent's hill-climbing gets stuck in local optima or you want broader search-space coverage overnight. Single-agent mode is simpler and cheaper; the swarm multiplies compute cost by the agent count.

What happens if one swarm agent diverges or fails?▼

A diverging agent does not affect the others since workspaces are isolated. The orchestrator flags agents with 30 consecutive diverged iterations in its aggregation output and prompts human review, while remaining agents continue exploring.