joelhooks/swarm-cli
packages/opencode-swarm-plugin/claude-plugin/skills/swarm-cli/SKILL.md
Swarm CLI commands for workers - hivemind memory, hive tasks, swarmmail coordination. Use when working in a swarm context. Covers: swarm memory (find/store/get/stats), swarm cells (query/create/update/close), and coordination commands.
$ install --global
skillsauthnpx skillsauth add joelhooks/swarm-tools swarm-cliInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 6, 2026, 9:33 AM53.2s1 file scanned
SKILL.md
- name:
- swarm-cli
- description:
- |
- Use when working in a swarm context. Covers:
- swarm memory (find/store/get/stats),
Swarm CLI Quick Reference
Memory (Hivemind)
swarm memory find "query" # Semantic search for learnings
swarm memory find "query" --fts # Full-text search fallback
swarm memory store "info" --tags x # Store a learning
swarm memory get <id> # Get specific memory
swarm memory stats # Check memory health
When to query:
- BEFORE starting any task - check for existing solutions
- When stuck - search for similar problems
- Before major decisions - find past rationale
When to store:
- Solved a tricky bug (>15min debugging)
- Found a project-specific pattern
- Discovered a tool/library gotcha
- Made an architectural decision
Task Tracking (Hive)
swarm hive ready # Get next unblocked task
swarm hive query --status open # List open tasks
swarm hive create "title" --type bug --priority 1
swarm hive update <id> --status in_progress
swarm hive close <id> "summary" # Close completed task
swarm tree # Visualize task hierarchy
Coordination (Swarm Mail)
swarm mail inbox # Check for messages
swarm mail send "coordinator" "Subject" "Body"
swarm mail reserve file.ts # Reserve file for editing
swarm mail release # Release all reservations
Progress & Checkpoints
swarm progress 50 "message" # Report 50% progress
swarm checkpoint # Save context before risky ops
swarm complete "summary" # Mark task done (releases locks)
Analytics
swarm compliance # Check tool usage stats
swarm history # Recent swarm activity
swarm dashboard # Live worker status UI
Core Workflow
swarm memory find "<task keywords>"- Check for existing solutionsswarm hive ready- Get your taskswarm mail reserve <files>- Lock your files- Do the work (TDD: red → green → refactor)
swarm progress 50 "message"- Report milestonesswarm memory store "learning" --tags "domain"- Store discoveriesswarm complete "summary"- Finish and release locks
Tips
- Query before coding - 90% of problems have been solved before
- Store actionable learnings - Include WHY, not just WHAT
- Reserve files early - Prevents edit conflicts with other workers
- Report progress - Silent workers look stuck
- Checkpoint before risky ops - Saves context for recovery
Related Skills
joelhooks/testing-patterns
development
VerifiedTrustedCommunity
Patterns for testing code effectively. Use when breaking dependencies for testability, adding tests to existing code, understanding unfamiliar code through characterization tests, or deciding how to structure tests. Covers seams, dependency injection, test doubles, and safe refactoring techniques from Michael Feathers.
613SKILL.mdUpdated Apr 6, 2026
joelhooks/system-design
tools
VerifiedTrustedCommunity
Principles for building reusable coding systems. Use when designing modules, APIs, CLIs, or any code meant to be used by others. Based on "A Philosophy of Software Design" by John Ousterhout. Covers deep modules, complexity management, and design red flags.
613SKILL.mdUpdated Apr 6, 2026
joelhooks/swarm-coordination
development
VerifiedTrustedCommunity
Multi-agent coordination patterns for OpenCode swarm workflows. Use when working on complex tasks that benefit from parallelization, when coordinating multiple agents, or when managing task decomposition. Do NOT use for simple single-agent tasks.
613SKILL.mdUpdated Apr 6, 2026
joelhooks/skill-generator
development
VerifiedTrustedCommunity
Meta-skill for generating new skills with proper format and structure. Use when creating new skills for the swarm system or when agents need to generate skill scaffolds. Ensures skills follow conventions (frontmatter format, directory structure, bundled resources).
613SKILL.mdUpdated Apr 6, 2026