skills.rest
wellmaintained
wellmaintainedOFFICIAL
Explore all skills by this author →
WebsiteGitHub

beads-bridge

Aggregate Beads epics across repositories using GitHub Projects v2 and Shortcut.

Updated Aug 23, 2026
Search Tags:#automation#project management#github#beads#issue tracking#multi-repo#dependency graph#shortcut
One-click install
npx skills add https://github.com/wellmaintained/skills --skill beads-bridge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: beads-bridge
Source: https://github.com/wellmaintained/skills/tree/main/plugins/beads-bridge
Command: npx skills add https://github.com/wellmaintained/skills --skill beads-bridge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Node.js, bd, curl, wget, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill eliminates the chaos of tracking projects across multiple repositories and different project management tools. It automates the aggregation of progress, generation of dependency diagrams, and detection of new work, freeing project managers and tech leads from manual updates and ensuring unified visibility across complex software initiatives.

Core Features & Use Cases

  • Multi-Repository Progress Aggregation: Automatically combine task completion data from Beads-tracked issues across numerous repositories into a single, coherent view, saving hours of manual data compilation.
  • Automated PM Tool Sync: Post real-time progress updates, including completion metrics and Mermaid diagrams, directly to GitHub Issues/Projects or Shortcut Stories, keeping stakeholders informed without manual effort.
  • Visual Dependency Mapping: Generate clear Mermaid diagrams that illustrate task relationships and highlight blockers, making complex project structures easy to understand and proactively manage.
  • Use Case: A tech lead overseeing a large feature spanning frontend, backend, and mobile teams (each in separate repos) can use this skill to get an aggregated status, identify cross-repo blockers, and automatically update the main GitHub issue without ever leaving Claude, ensuring consistent and up-to-date project visibility.

Quick Start

  1. Install the plugin: /plugin install beads-bridge@wellmaintained
  2. Authenticate with GitHub or Shortcut: beads-bridge auth github
  3. Link your Beads epic to an external issue: bd update myproject-e1 --external-ref "github:your-org/your-repo#123"
  4. Ask Claude for status: "What's the status of GitHub issue #123?"

Frequently Asked Questions about beads-bridge

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

FAQPage Schema
How do I aggregate project status across multiple GitHub repositories?▼

Aggregate project status across multiple repositories by running beads-bridge to combine Beads-tracked issues from each repo into a single unified view. Link your epic to a GitHub issue using the external-ref flag, then query the aggregated status through Claude to see completion metrics across all repos without manual compilation.

Can I automatically sync project progress to GitHub Projects and Shortcut?▼

Yes, beads-bridge automatically posts real-time progress updates, completion metrics, and Mermaid diagrams directly to GitHub Issues, GitHub Projects v2, or Shortcut Stories. After authenticating and linking your Beads epic to an external issue, progress syncs without manual effort.

How do I visualize dependencies and blockers across multiple repositories?▼

Generate visual dependency maps by running beads-bridge to produce Mermaid diagrams that illustrate task relationships and highlight cross-repo blockers. The diagrams are posted directly to your GitHub issue or Shortcut story, making complex project structures transparent to your team.

What setup is required to track issues across frontend, backend, and mobile repositories?▼

Install Node.js and beads-bridge, authenticate with GitHub or Shortcut, ensure the bd CLI and curl are available on your PATH, then link each repository's Beads epic to a central GitHub issue or Shortcut story using external-ref. Run queries from your project root to aggregate status across all repos.

Does beads-bridge work with both GitHub and Shortcut, or do I have to choose?▼

beads-bridge supports backend detection for both GitHub and Shortcut. Authenticate with whichever platform you use, link your Beads epic to an issue or story in that platform, and beads-bridge will aggregate and sync progress accordingly—no tool switching required.

What if I'm using GitHub but some teams track in Shortcut?▼

beads-bridge detects your backend (GitHub or Shortcut) at runtime based on your authentication and the external-ref you configure. To coordinate teams across platforms, use the aggregation output from beads-bridge as a single source of truth and manually post updates to the non-primary tool, or authenticate with both and maintain parallel issue links.

Related Skills

Explore More Software Engineering Skills→
musical-basicsmusical-basics

github-auth

Configure GitHub authentication using personal access tokens, SSH keys, or gh CLI login.

Community
Intermediate
breethomasbreethomas
16

now-next-later

Organize projects into Now, Next, and Later roadmaps with markdown or mermaid exports.

Community
Intermediate
PatkikPatkik

mermaid-diagrams

Create Mermaid diagrams from plain text for architectures, workflows, and data models.

Community
Advanced
itechmeatitechmeat
22

beads

Track AI agent tasks with git-backed issue management.

Community
Intermediate