Skip to main content Home Creators ruvnet ruview github-project-management
github-project-management Comprehensive GitHub project management with swarm-coordinated issue tracking, project board automation, and sprint planning
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/ruvnet/RuView --skill github-project-managementThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository
Related occupations SOC
Based on SOC occupation classification
name github-project-management title GitHub Project Management version 2.0.0 category github description Comprehensive GitHub project management with swarm-coordinated issue tracking, project board automation, and sprint planning author Claude Code tags ["github","project-management","issue-tracking","project-boards","sprint-planning","agile","swarm-coordination"] difficulty intermediate prerequisites ["GitHub CLI (gh) installed and authenticated","ruv-swarm or claude-flow MCP server configured","Repository access permissions"] tools_required ["mcp__github__*","mcp__claude-flow__*","Bash","Read","Write","TodoWrite"] related_skills ["github-pr-workflow","github-release-management","sparc-orchestrator"] estimated_time 30-45 minutes
GitHub Project Management
Overview
A comprehensive skill for managing GitHub projects using AI swarm coordination. This skill combines intelligent issue management, automated project board synchronization, and swarm-based coordination for efficient project delivery.
Quick Start
Basic Issue Creation with Swarm Coordination
gh issue create \
--title "Feature: Advanced Authentication" \
--body "Implement OAuth2 with social login..." \
--label "enhancement,swarm-ready"
npx claude-flow@alpha hooks pre-task --description "Feature implementation"
Project Board Quick Setup
PROJECT_ID=$(gh project list --owner @me --format json | \
jq -r '.projects[0].id' )
npx ruv-swarm github board-init \
--project-id "$PROJECT_ID " \
--sync-mode "bidirectional"
Core Capabilities
1. Issue Management & Triage
Automated Issue Creation Single Issue with Swarm Coordination
mcp__claude-flow__swarm_init { topology : "star" , maxAgents : 3 }
mcp__claude-flow__agent_spawn { type : "coordinator" , name : "Issue Coordinator" }
mcp__claude-flow__agent_spawn { type : "researcher" , name : "Requirements Analyst" }
mcp__claude-flow__agent_spawn { type : "coder" , name : "Implementation Planner" }
mcp__github__create_issue {
owner
"org"
repo
"repository"
title
"Integration Review: Complete system integration"
body
`## 🔄 Integration Review
### Overview
Comprehensive review and integration between components.
### Objectives
- [ ] Verify dependencies and imports
- [ ] Ensure API integration
- [ ] Check hook system integration
- [ ] Validate data systems alignment
### Swarm Coordination
This issue will be managed by coordinated swarm agents for optimal progress tracking.`
labels
"integration"
"review"
"enhancement"
assignees
"username"
task
"Monitor and coordinate issue progress with automated updates"
strategy
"adaptive"
priority
"medium"
Batch Issue Creation
gh issue create \
--title "Feature: Advanced GitHub Integration" \
--body "Implement comprehensive GitHub workflow automation..." \
--label "feature,github,high-priority"
gh issue create \
--title "Bug: Merge conflicts in integration branch" \
--body "Resolve merge conflicts..." \
--label "bug,integration,urgent"
gh issue create \
--title "Documentation: Update integration guides" \
--body "Update all documentation..." \
--label "documentation,integration"
Issue-to-Swarm Conversion Transform Issues into Swarm Tasks
ISSUE_DATA=$(gh issue view 456 --json title,body,labels,assignees,comments)
npx ruv-swarm github issue-to-swarm 456 \
--issue-data "$ISSUE_DATA " \
--auto-decompose \
--assign-agents
ISSUES=$(gh issue list --label "swarm-ready" --json number,title,body,labels)
npx ruv-swarm github issues-batch \
--issues "$ISSUES " \
--parallel
echo "$ISSUES " | jq -r '.[].number' | while read -r num; do
gh issue edit $num --add-label "swarm-processing"
done
Issue Comment Commands
Execute swarm operations via issue comments:
<!-- In issue comment -->
/swarm analyze
/swarm decompose 5
/swarm assign @agent-coder
/swarm estimate
/swarm start
Automated Issue Triage Auto-Label Based on Content
{
"rules" : [
{
"keywords" : ["bug" , "error" , "broken" ],
"labels" : ["bug" , "swarm-debugger" ],
"agents" : ["debugger" , "tester" ]
},
{
"keywords" : ["feature" , "implement" , "add" ],
"labels" : ["enhancement" , "swarm-feature" ],
"agents" : ["architect" , "coder" , "tester" ]
},
{
"keywords" : ["slow" , "performance" , "optimize" ],
"labels" : ["performance" , "swarm-optimizer" ],
"agents" : ["analyst" , "optimizer" ]
}
]
}
Automated Triage System
npx ruv-swarm github triage \
--unlabeled \
--analyze-content \
--suggest-labels \
--assign-priority
npx ruv-swarm github find-duplicates \
--threshold 0.8 \
--link-related \
--close-duplicates
Task Decomposition & Progress Tracking Break Down Issues into Subtasks
ISSUE_BODY=$(gh issue view 456 --json body --jq '.body' )
SUBTASKS=$(npx ruv-swarm github issue-decompose 456 \
--body "$ISSUE_BODY " \
--max-subtasks 10 \
--assign-priorities)
CHECKLIST=$(echo "$SUBTASKS " | jq -r '.tasks[] | "- [ ] " + .description' )
UPDATED_BODY="$ISSUE_BODY
## Subtasks
$CHECKLIST "
gh issue edit 456 --body "$UPDATED_BODY "
echo "$SUBTASKS " | jq -r '.tasks[] | select(.priority == "high")' | while read -r task; do
TITLE=$(echo "$task " | jq -r '.title' )
BODY=$(echo "$task " | jq -r '.description' )
gh issue create \
--title "$TITLE " \
--body "$BODY
Parent issue: #456" \
--label "subtask"
done
Automated Progress Updates
CURRENT=$(gh issue view 456 --json body,labels)
PROGRESS=$(npx ruv-swarm github issue-progress 456)
UPDATED_BODY=$(echo "$CURRENT " | jq -r '.body' | \
npx ruv-swarm github update-checklist --progress "$PROGRESS " )
gh issue edit 456 --body "$UPDATED_BODY "
SUMMARY=$(echo "$PROGRESS " | jq -r '
"## 📊 Progress Update
**Completion**: \(.completion)%
**ETA**: \(.eta)
### Completed Tasks
\(.completed | map("- ✅ " + .) | join("\n"))
### In Progress
\(.in_progress | map("- 🔄 " + .) | join("\n"))
### Remaining
\(.remaining | map("- ⏳ " + .) | join("\n"))
---
🤖 Automated update by swarm agent"' )
gh issue comment 456 --body "$SUMMARY "
if [[ $(echo "$PROGRESS " | jq -r '.completion' ) -eq 100 ]]; then
gh issue edit 456 --add-label "ready-for-review" --remove-label "in-progress"
fi
Stale Issue Management Auto-Close Stale Issues with Swarm Analysis
STALE_DATE=$(date -d '30 days ago' --iso-8601)
STALE_ISSUES=$(gh issue list --state open --json number,title,updatedAt,labels \
--jq ".[] | select(.updatedAt < \"$STALE_DATE \")" )
echo "$STALE_ISSUES " | jq -r '.number' | while read -r num; do
ISSUE=$(gh issue view $num --json title,body,comments,labels)
ACTION=$(npx ruv-swarm github analyze-stale \
--issue "$ISSUE " \
--suggest-action)
case "$ACTION " in
"close" )
gh issue comment $num --body "This issue has been inactive for 30 days and will be closed in 7 days if there's no further activity."
gh issue edit $num --add-label "stale"
;;
"keep" )
gh issue edit $num --remove-label "stale" 2>/dev/null || true
;;
"needs-info" )
gh issue comment $num --body "This issue needs more information. Please provide additional context or it may be closed as stale."
gh issue edit $num --add-label "needs-info"
;;
esac
done
gh issue list --label stale --state open --json number,updatedAt \
--jq ".[] | select(.updatedAt < \"$(date -d '37 days ago' --iso-8601) \") | .number" | \
while read -r num; do
gh issue close $num --comment "Closing due to inactivity. Feel free to reopen if this is still relevant."
done
2. Project Board Automation
Board Initialization & Configuration Connect Swarm to GitHub Project
PROJECT_ID=$(gh project list --owner @me --format json | \
jq -r '.projects[] | select(.title == "Development Board") | .id' )
npx ruv-swarm github board-init \
--project-id "$PROJECT_ID " \
--sync-mode "bidirectional" \
--create-views "swarm-status,agent-workload,priority"
gh project field-create $PROJECT_ID --owner @me \
--name "Swarm Status" \
--data-type "SINGLE_SELECT" \
--single-select-options "pending,in_progress,completed"
Board Mapping Configuration
version: 1
project:
name: "AI Development Board"
number: 1
mapping:
status:
pending: "Backlog"
assigned: "Ready"
in_progress: "In Progress"
review: "Review"
completed: "Done"
blocked: "Blocked"
agents:
coder: "🔧 Development"
tester: "🧪 Testing"
analyst: "📊 Analysis"
designer: "🎨 Design"
architect: "🏗️ Architecture"
priority:
critical: "🔴 Critical"
high: "🟡 High"
medium: "🟢 Medium"
low: "⚪ Low"
fields:
- name: "Agent Count"
type: number
source: task.agents.length
- name: "Complexity"
type: select
source: task.complexity
- name: "ETA"
type: date
source: task.estimatedCompletion
Task Synchronization Real-time Board Sync
npx ruv-swarm github board-sync \
--map-status '{
"todo": "To Do",
"in_progress": "In Progress",
"review": "Review",
"done": "Done"
}' \
--auto-move-cards \
--update-metadata
npx ruv-swarm github board-realtime \
--webhook-endpoint "https://api.example.com/github-sync" \
--update-frequency "immediate" \
--batch-updates false
Convert Issues to Project Cards
ISSUES=$(gh issue list --label "enhancement" --json number,title,body)
echo "$ISSUES " | jq -r '.[].number' | while read -r issue; do
gh project item-add $PROJECT_ID --owner @me --url "https://github.com/$GITHUB_REPOSITORY /issues/$issue "
done
npx ruv-swarm github board-import-issues \
--issues "$ISSUES " \
--add-to-column "Backlog" \
--parse-checklist \
--assign-agents
Smart Card Management Auto-Assignment
npx ruv-swarm github board-auto-assign \
--strategy "load-balanced" \
--consider "expertise,workload,availability" \
--update-cards
Intelligent Card State Transitions
npx ruv-swarm github board-smart-move \
--rules '{
"auto-progress": "when:all-subtasks-done",
"auto-review": "when:tests-pass",
"auto-done": "when:pr-merged"
}'
Bulk Operations
npx ruv-swarm github board-bulk \
--filter "status:blocked" \
--action "add-label:needs-attention" \
--notify-assignees
Custom Views & Dashboards View Configuration
{
"views" : [
{
"name" : "Swarm Overview" ,
"type" : "board" ,
"groupBy" : "status" ,
"filters" : ["is:open" ],
"sort" : "priority:desc"
},
{
"name" : "Agent Workload" ,
"type" : "table" ,
"groupBy" : "assignedAgent" ,
"columns" : ["title" , "status" , "priority" , "eta" ],
"sort" : "eta:asc"
},
{
"name" : "Sprint Progress" ,
"type" : "roadmap" ,
"dateField" : "eta" ,
"groupBy" : "milestone"
}
]
}
Dashboard Configuration
{
"dashboard" : {
"widgets" : [
{
"type" : "chart" ,
"title" : "Task Completion Rate" ,
"data" : "completed-per-day" ,
"visualization" : "line"
},
{
"type" : "gauge" ,
"title" : "Sprint Progress" ,
"data" : "sprint-completion" ,
"target" : 100
},
{
"type" : "heatmap" ,
"title" : "Agent Activity" ,
"data" : "agent-tasks-per-day"
}
]
}
}
3. Sprint Planning & Tracking
Sprint Management Initialize Sprint with Swarm Coordination
npx ruv-swarm github sprint-manage \
--sprint "Sprint 23" \
--auto-populate \
--capacity-planning \
--track-velocity
npx ruv-swarm github milestone-track \
--milestone "v2.0 Release" \
--update-board \
--show-dependencies \
--predict-completion
Agile Development Board Setup
npx ruv-swarm github agile-board \
--methodology "scrum" \
--sprint-length "2w" \
--ceremonies "planning,review,retro" \
--metrics "velocity,burndown"
Kanban Flow Board Setup
npx ruv-swarm github kanban-board \
--wip-limits '{
"In Progress": 5,
"Review": 3
}' \
--cycle-time-tracking \
--continuous-flow
Progress Tracking & Analytics Board Analytics
PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)
ISSUE_METRICS=$(echo "$PROJECT_DATA " | jq -r '.items[] | select(.content.type == "Issue")' | \
while read -r item; do
ISSUE_NUM=$(echo "$item " | jq -r '.content.number' )
gh issue view $ISSUE_NUM --json createdAt,closedAt,labels,assignees
done )
npx ruv-swarm github board-analytics \
--project-data "$PROJECT_DATA " \
--issue-metrics "$ISSUE_METRICS " \
--metrics "throughput,cycle-time,wip" \
--group-by "agent,priority,type" \
--time-range "30d" \
--export "dashboard"
Performance Reports
npx ruv-swarm github board-progress \
--show "burndown,velocity,cycle-time" \
--time-period "sprint" \
--export-metrics
npx ruv-swarm github board-report \
--type "sprint-summary" \
--format "markdown" \
--include "velocity,burndown,blockers" \
--distribute "slack,email"
KPI Tracking
npx ruv-swarm github board-kpis \
--metrics '[
"average-cycle-time",
"throughput-per-sprint",
"blocked-time-percentage",
"first-time-pass-rate"
]' \
--dashboard-url
npx ruv-swarm github team-metrics \
--board "Development" \
--per-member \
--include "velocity,quality,collaboration" \
--anonymous-option
Release Planning Release Coordination
npx ruv-swarm github release-plan-board \
--analyze-velocity \
--estimate-completion \
--identify-risks \
--optimize-scope
4. Advanced Coordination
Multi-Board Synchronization Cross-Board Sync
npx ruv-swarm github multi-board-sync \
--boards "Development,QA,Release" \
--sync-rules '{
"Development->QA": "when:ready-for-test",
"QA->Release": "when:tests-pass"
}'
npx ruv-swarm github cross-org-sync \
--source "org1/Project-A" \
--target "org2/Project-B" \
--field-mapping "custom" \
--conflict-resolution "source-wins"
Issue Dependencies & Epic Management Dependency Resolution
npx ruv-swarm github issue-deps 456 \
--resolve-order \
--parallel-safe \
--update-blocking
Epic Coordination
npx ruv-swarm github epic-swarm \
--epic 123 \
--child-issues "456,457,458" \
--orchestrate
Cross-Repository Coordination Multi-Repo Issue Management
npx ruv-swarm github cross-repo \
--issue "org/repo#456" \
--related "org/other-repo#123" \
--coordinate
Team Collaboration Work Distribution
npx ruv-swarm github board-distribute \
--strategy "skills-based" \
--balance-workload \
--respect-preferences \
--notify-assignments
Standup Automation
npx ruv-swarm github standup-report \
--team "frontend" \
--include "yesterday,today,blockers" \
--format "slack" \
--schedule "daily-9am"
Review Coordination
npx ruv-swarm github review-coordinate \
--board "Code Review" \
--assign-reviewers \
--track-feedback \
--ensure-coverage
Issue Templates
Integration Issue Template ## 🔄 Integration Task
### Overview
[Brief description of integration requirements]
### Objectives
- [ ] Component A integration
- [ ] Component B validation
- [ ] Testing and verification
- [ ] Documentation updates
### Integration Areas
#### Dependencies
- [ ] Package.json updates
- [ ] Version compatibility
- [ ] Import statements
#### Functionality
- [ ] Core feature integration
- [ ] API compatibility
- [ ] Performance validation
#### Testing
- [ ] Unit tests
- [ ] Integration tests
- [ ] End-to-end validation
### Swarm Coordination
- **Coordinator** : Overall progress tracking
- **Analyst** : Technical validation
- **Tester** : Quality assurance
- **Documenter** : Documentation updates
### Progress Tracking
Updates will be posted automatically by swarm agents during implementation.
---
🤖 Generated with Claude Code
Bug Report Template ## 🐛 Bug Report
### Problem Description
[Clear description of the issue]
### Expected Behavior
[What should happen]
### Actual Behavior
[What actually happens]
### Reproduction Steps
1. [Step 1]
2. [Step 2]
3. [Step 3]
### Environment
- Package: [package name and version]
- Node.js: [version]
- OS: [operating system]
### Investigation Plan
- [ ] Root cause analysis
- [ ] Fix implementation
- [ ] Testing and validation
- [ ] Regression testing
### Swarm Assignment
- **Debugger** : Issue investigation
- **Coder** : Fix implementation
- **Tester** : Validation and testing
---
🤖 Generated with Claude Code
Feature Request Template ## ✨ Feature Request
### Feature Description
[Clear description of the proposed feature]
### Use Cases
1. [Use case 1]
2. [Use case 2]
3. [Use case 3]
### Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3
### Implementation Approach
#### Design
- [ ] Architecture design
- [ ] API design
- [ ] UI/UX mockups
#### Development
- [ ] Core implementation
- [ ] Integration with existing features
- [ ] Performance optimization
#### Testing
- [ ] Unit tests
- [ ] Integration tests
- [ ] User acceptance testing
### Swarm Coordination
- **Architect** : Design and planning
- **Coder** : Implementation
- **Tester** : Quality assurance
- **Documenter** : Documentation
---
🤖 Generated with Claude Code
Swarm Task Template <!-- .github/ISSUE_TEMPLATE/swarm-task.yml -->
name: Swarm Task
description: Create a task for AI swarm processing
body:
- type: dropdown
id: topology
attributes:
label: Swarm Topology
options:
- mesh
- hierarchical
- ring
- star
- type: input
id: agents
attributes:
label: Required Agents
placeholder: "coder, tester, analyst"
- type: textarea
id: tasks
attributes:
label: Task Breakdown
placeholder: |
1. Task one description
2. Task two description
Workflow Integration
GitHub Actions for Issue Management
name: Issue Swarm Handler
on:
issues:
types: [opened , labeled , commented ]
jobs:
swarm-process:
runs-on: ubuntu-latest
steps:
- name: Process Issue
uses: ruvnet/swarm-action@v1
with:
command: |
if [[ "${{ github.event.label.name }}" == "swarm-ready" ]]; then
npx ruv-swarm github issue-init ${{ github.event.issue.number }}
fi
Board Integration Workflow
npx ruv-swarm github issue-board-sync \
--project "Development" \
--column-mapping '{
"To Do": "pending",
"In Progress": "active",
"Done": "completed"
}'
Specialized Issue Strategies
Bug Investigation Swarm
npx ruv-swarm github bug-swarm 456 \
--reproduce \
--isolate \
--fix \
--test
Feature Implementation Swarm
npx ruv-swarm github feature-swarm 456 \
--design \
--implement \
--document \
--demo
Technical Debt Refactoring
npx ruv-swarm github debt-swarm 456 \
--analyze-impact \
--plan-migration \
--execute \
--validate
Best Practices
1. Swarm-Coordinated Issue Management
Always initialize swarm for complex issues
Assign specialized agents based on issue type
Use memory for progress coordination
Regular automated progress updates
2. Board Organization
Clear column definitions with consistent naming
Systematic labeling strategy across repositories
Regular board grooming and maintenance
Well-defined automation rules
3. Data Integrity
Bidirectional sync validation
Conflict resolution strategies
Comprehensive audit trails
Regular backups of project data
4. Team Adoption
Comprehensive training materials
Clear, documented workflows
Regular team reviews and retrospectives
Active feedback loops for improvement
5. Smart Labeling and Organization
Consistent labeling strategy across repositories
Priority-based issue sorting and assignment
Milestone integration for project coordination
Agent-type to label mapping
6. Automated Progress Tracking
Regular automated updates with swarm coordination
Progress metrics and completion tracking
Cross-issue dependency management
Real-time status synchronization
Troubleshooting
Sync Issues
npx ruv-swarm github board-diagnose \
--check "permissions,webhooks,rate-limits" \
--test-sync \
--show-conflicts
Performance Optimization
npx ruv-swarm github board-optimize \
--analyze-size \
--archive-completed \
--index-fields \
--cache-views
Data Recovery
npx ruv-swarm github board-recover \
--backup-id "2024-01-15" \
--restore-cards \
--preserve-current \
--merge-conflicts
Metrics & Analytics
Performance Metrics
Issue creation and resolution times
Agent productivity metrics
Project milestone progress
Cross-repository coordination efficiency
Sprint velocity and burndown
Cycle time and throughput
Work-in-progress limits
Reporting Features
Weekly progress summaries
Agent performance analytics
Project health metrics
Integration success rates
Team collaboration metrics
Quality and defect tracking
Issue Resolution Time
npx ruv-swarm github issue-metrics \
--issue 456 \
--metrics "time-to-close,agent-efficiency,subtask-completion"
Swarm Effectiveness
npx ruv-swarm github effectiveness \
--issues "closed:>2024-01-01" \
--compare "with-swarm,without-swarm"
Security & Permissions
Command Authorization : Validate user permissions before executing commandsRate Limiting : Prevent spam and abuse of issue commandsAudit Logging : Track all swarm operations on issues and boardsData Privacy : Respect private repository settingsAccess Control : Proper GitHub permissions for board operationsWebhook Security : Secure webhook endpoints for real-time updates
Integration with Other Skills
Seamless Integration With:
github-pr-workflow - Link issues to pull requests automaticallygithub-release-management - Coordinate release issues and milestonessparc-orchestrator - Complex project coordination workflowssparc-tester - Automated testing workflows for issues
Complete Workflow Example
Full-Stack Feature Development
gh issue create \
--title "Feature: Real-time Collaboration" \
--body "$(cat <<EOF
## Feature: Real-time Collaboration
### Overview
Implement real-time collaboration features using WebSockets.
### Objectives
- [ ] WebSocket server setup
- [ ] Client-side integration
- [ ] Presence tracking
- [ ] Conflict resolution
- [ ] Testing and documentation
### Swarm Coordination
This feature will use mesh topology for parallel development.
EOF
) " \
--label "enhancement,swarm-ready,high-priority"
ISSUE_NUM=$(gh issue list --label "swarm-ready" --limit 1 --json number --jq '.[0].number' )
npx ruv-swarm github issue-init $ISSUE_NUM \
--topology mesh \
--auto-decompose \
--assign-agents "architect,coder,tester"
PROJECT_ID=$(gh project list --owner @me --format json | jq -r '.projects[0].id' )
gh project item-add $PROJECT_ID --owner @me \
--url "https://github.com/$GITHUB_REPOSITORY /issues/$ISSUE_NUM "
npx ruv-swarm github board-sync \
--auto-move-cards \
--update-metadata
npx ruv-swarm github issue-progress $ISSUE_NUM \
--auto-update-comments \
--notify-on-completion
Quick Reference Commands
gh issue create --title "..." --body "..." --label "..."
npx ruv-swarm github issue-init <number>
npx ruv-swarm github issue-decompose <number>
npx ruv-swarm github triage --unlabeled
npx ruv-swarm github board-init --project-id <id >
npx ruv-swarm github board-sync
npx ruv-swarm github board-analytics
npx ruv-swarm github sprint-manage --sprint "Sprint X"
npx ruv-swarm github milestone-track --milestone "vX.X"
npx ruv-swarm github issue-metrics --issue <number>
npx ruv-swarm github board-kpis
Additional Resources
Last Updated : 2025-10-19
Version : 2.0.0
Maintainer : Claude Code
