hoangnb24/swarming
plugins/khuym/skills/swarming/SKILL.md
Use when validating approves execution. Orchestrates bounded Codex workers, local reservations, worker results, rescues, and phase handoff. Tends the swarm but never implements beads directly.
$ install --global
skillsauthnpx skillsauth add hoangnb24/skills swarmingInstall 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: May 3, 2026, 3:19 AM183.4s6 files scanned
SKILL.md
- name:
- swarming
- description:
- Use when validating approves execution. Orchestrates bounded Codex workers, local reservations, worker results, rescues, and phase handoff. Tends the swarm but never implements beads directly.
- version:
- 1.0
- role:
- orchestrator
- ecosystem:
- khuym
- position:
- 5-of-9
- upstream:
- validating
- downstream:
- reviewing
- kind:
- command
- command:
- bv
- missing_effect:
- unavailable
- reason:
- Live graph triage is required to route and supervise workers.
Swarming
If .khuym/onboarding.json is missing or stale for the current repo, stop and invoke khuym:using-khuym before continuing.
You are the orchestrator. Launch workers, monitor coordination, handle escalations, and keep the swarm moving. Do not implement beads directly; spawned workers use khuym:executing.
Coordination Substrate
Same-session swarming uses:
- beads and
bvfor work selection and graph state - Codex subagents for bounded parallel execution
.khuym/reservations.jsonfor local file ownership- the parent Codex thread for
[DONE],[BLOCKED],[HANDOFF], and[NOOP]results
No external mail server is required for the default path.
When to Use
Invoke after khuym:validating says: Validation complete. Current phase passes. Invoke khuym:swarming skill.
Prerequisites:
- current-phase beads are approved and open
EPIC_IDis knownnode .codex/khuym_status.mjs --jsonhas been run when availablehistory/learnings/critical-patterns.mdhas been read when present
Operating Contract
- Confirm readiness with
bv --robot-triage --graph-root <EPIC_ID>. - Sweep expired reservations.
- Choose each ready bead parent-side, then spawn bounded worker subagents with
references/swarming-reference.md. - Record
agent_id,agent_nickname, bead, and status in.khuym/state.json. - Tend the live graph, reservations, and worker results until the phase is clean.
- Write
.khuym/HANDOFF.jsonbefore pausing near context limits. - Run final graph, reservation, and quality checks before handing off.
Load references/swarming-reference.md for spawn context, tend-loop rules, result templates, handoff content, and red flags.
Hard Rules
- Never spawn workers before validation approves execution.
- Never let workers pick beads themselves; pass one explicit
assigned_bead_idfrom the orchestrator. - Never let workers edit without local reservations.
- Do not resolve file conflicts by asking workers to be careful; adjust reservations or bead scope.
- Silence alone is not failure. Do not send routine mid-flight
send_input(...)check-ins. - Reserve interrupts for explicit user aborts or confirmed deadlocks where the user wants preemption.
- If context usage passes roughly 65%, write
.khuym/HANDOFF.jsonand pause safely.
Completion Signal
Swarming is complete when either:
- the current phase is executed and the workflow returns to planning for the next phase, or
- the final phase is executed and the user can be told:
Swarm execution complete for the final phase. Invoke khuym:reviewing.
Reference Files
| File | When to Load |
|---|---|
| references/swarming-reference.md | Orchestration flow, worker prompt, result formats |
| .khuym/state.json | Runtime worker and phase state |
| .khuym/HANDOFF.json | Pause/resume artifact |
Related Skills
hoangnb24/smart-commits
tools
VerifiedTrustedCommunity
Use when the user asks to commit everything, smart commit, group commits, organize staged or unstaged changes, create logical commits, push current work, or preserve a clean commit stack from an existing working tree.
215SKILL.mdUpdated May 21, 2026
hoangnb24/using-khuym
development
VerifiedTrustedCommunity
Use when starting or resuming any Khuym project session, choosing the next Khuym skill, running go mode, checking onboarding/scout state, or enforcing workflow gates. Bootstrap meta-skill for routing across the Khuym agentic development ecosystem.
215SKILL.mdUpdated Apr 18, 2026
hoangnb24/goal-griller
development
VerifiedTrustedCommunity
Use when the user wants to turn a rough idea, vague task, feature wish, bug-fix intent, or Codex /goal objective into a clear verifiable goal prompt. Use when the user mentions goal mode, /goal, set_goal, long-running autonomous Codex work, or asks to be interviewed/grilled before creating a goal.
213SKILL.mdUpdated May 19, 2026
hoangnb24/concept-game-builder
tools
VerifiedTrustedCommunity
Use when Codex should turn a concept, topic, tutorial, lesson, algorithm, system, workflow, or abstract idea into a playable browser game that teaches through interaction. Use for planning or implementing educational web games with the Game Studio plugin, including concept-to-mechanic translation, gameplay loop design, learning progression, and browser-game QA.
213SKILL.mdUpdated May 19, 2026