skills.rest
ruvnet
ruvnetCOMMUNITY
Explore all skills by this author →
Website𝕏@ruvGitHub

agent-swarm-issue

Converts GitHub issues into coordinated multi-agent swarm tasks with decomposition and progress tracking.

70.1k|8.4k|Updated Jun 2, 2025
Search Tags:#task decomposition#triage#Automation#gitHub#SWARM#Multi-Agent#Issue tracking
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill agent-swarm-issue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-swarm-issue
Source: https://github.com/ruvnet/claude-flow/tree/main/.agents/skills/agent-swarm-issue
Command: npx skills add https://github.com/ruvnet/claude-flow --skill agent-swarm-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing complex GitHub issues manually requires breaking them into subtasks, assigning work, and tracking progress across contributors. This Skill automates that by transforming issues into coordinated multi-agent swarm tasks with automatic decomposition and status updates.

Core Features & Use Cases

  • Issue-to-Swarm Conversion: Initialize a swarm from any GitHub issue using gh CLI data, with automatic topology selection and agent assignment based on issue content.
  • Task Decomposition & Subtasks: Break issues into prioritized subtasks, update the issue body with checklists, and create linked child issues for high-priority work.
  • Progress Tracking & Automation: Post progress summaries as issue comments, update labels based on completion, triage unlabeled issues, detect duplicates, and auto-close stale issues.
  • Use Case: A maintainer labels an issue "swarm-ready"; the swarm analyzes it, spawns coder/tester/analyst agents, decomposes the work into a checklist, and posts progress updates until the issue is ready for review.

Quick Start

Ask the agent to initialize a swarm from GitHub issue number 456 with automatic task decomposition and agent assignment.

Frequently Asked Questions about agent-swarm-issue

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

FAQPage Schema
How do I convert a GitHub issue into a swarm task?▼

Fetch the issue data with gh issue view, then run npx ruv-swarm github issue-init with the issue number and flags like --auto-decompose and --assign-agents. The swarm analyzes the content and spawns appropriate agents.

How to automatically break a GitHub issue into subtasks?▼

Use npx ruv-swarm github issue-decompose with the issue number and --max-subtasks to generate prioritized subtasks. The skill updates the issue body with a checklist and can create linked child issues for high-priority items.

Can swarm agents update issue progress automatically?▼

Yes, the skill posts progress summaries as issue comments showing completion percentage, completed and remaining tasks, and updates labels like ready-for-review when completion reaches 100 percent.

What swarm topologies are supported for issue processing?▼

The skill supports mesh, hierarchical, ring, and star topologies. Hierarchical suits critical bug investigations, mesh fits feature implementation, and ring works for sequential tasks like documentation updates.

Does this handle stale or duplicate GitHub issues?▼

Yes, it can analyze issues inactive for 30 days to close, keep, or request more information, and it includes duplicate detection with a configurable similarity threshold to link or close duplicates.

Related Skills

Explore More Software Engineering Skills→
ChatGPT-KBChatGPT-KB

triage

Applies type, effort, priority, and area labels to GitHub issues.

Official
Advanced
open-horizon-labsopen-horizon-labs
3

oh-task

Automate GitHub issue completion from branch worktree to pull request.

Official
Advanced
JoeyJoziahJoeyJoziah

github-project-management

Organize GitHub issues, project boards, and sprint workflows.

Community
Advanced
thomfilgthomfilg

create-jira-consensus

Automate Jira task creation through multi-agent consensus with parallel and sequential iterations.

Community
Advanced