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

project-board-sync

Synchronize AI swarm tasks with GitHub Projects boards for visual tracking and coordination.

70.1k|8.4k|Updated Jun 2, 2025
Search Tags:#Automation#swarm coordination#Kanban#sprint tracking#GitHub projects#board sync#Task Management
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill project-board-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-board-sync
Source: https://github.com/ruvnet/claude-flow/tree/main/.agents/skills/agent-project-board-sync
Command: npx skills add https://github.com/ruvnet/claude-flow --skill project-board-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeping AI swarm task progress in sync with GitHub Projects boards requires manual card updates, status mapping, and progress reporting, which fragments visibility across teams and agents.

Core Features & Use Cases

  • Bidirectional Board Sync: Map swarm task statuses to GitHub Project columns and automatically move cards as tasks progress.
  • Automation & Assignment: Auto-assign cards to agents using load-balanced strategies and trigger smart card transitions on events like merged PRs or passing tests.
  • Analytics & Reporting: Generate burndown charts, velocity metrics, standup reports, and sprint summaries from board data.
  • Use Case: A team running a multi-agent coding swarm connects it to a GitHub Project so every task the swarm creates, updates, or completes is reflected on the board in real time, with sprint velocity tracked automatically.

Quick Start

Ask the agent to initialize a GitHub Projects board connection and sync the current swarm's tasks to it with bidirectional status mapping.

Frequently Asked Questions about project-board-sync

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

FAQPage Schema
How do I sync AI agent tasks with a GitHub Projects board?▼

Initialize the connection with board-init using your project ID, then run board-sync with a status mapping that pairs swarm task states like in_progress to board columns like In Progress. Cards move automatically as task states change.

How to auto-assign GitHub Project cards to AI agents?▼

Use the board-auto-assign command with a strategy such as load-balanced, which considers agent expertise, current workload, and availability. The skill updates card assignees on the board after assignment.

Does GitHub Projects sync require the GitHub CLI?▼

Yes, the skill runs pre-hooks that verify gh CLI authentication and API access before executing. It uses gh project, gh issue, and gh api commands to read and modify project boards.

Can I sync multiple GitHub Projects boards across organizations?▼

Yes, the multi-board-sync and cross-org-sync commands support syncing boards across repositories and organizations with custom field mappings and configurable conflict resolution such as source-wins.

Why is my GitHub board sync failing or out of date?▼

Common causes include missing gh CLI authentication, insufficient project permissions, webhook misconfiguration, or API rate limits. Run board-diagnose to check permissions, webhooks, and rate limits and to surface sync conflicts.

Related Skills

Explore More Software Engineering Skills→
nateanatea
4

github-project-management

Coordinate GitHub project management tasks across issues, boards, and sprints using swarm orchestration.

Community
Intermediate
harnessharness
80

sei-analytics

Analyze sprint analytics and investment allocation from Harness SEI MCP.

Official
Advanced
mrgeoffrichmrgeoffrich
3

ship-it

Merge reviewed GitHub pull requests and update issue statuses.

Community
Intermediate
qiphonqiphon
2

github-project-management

Automates GitHub issue triage, board synchronization, sprint planning via swarm scripts.

Community
Advanced