openspec-to-beads

Convert OpenSpec artifacts into self-contained Beads issues with embedded context.

1|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/moogah/claude_skills --skill openspec-to-beads
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-to-beads
Source: https://github.com/moogah/claude_skills/tree/main/openspec-to-beads
Command: npx skills add https://github.com/moogah/claude_skills --skill openspec-to-beads

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec planning artifacts (proposal.md, design.md, tasks.md, specs/) often stay siloed or untracked, making it hard for teams to start implementation without repeated context-switching.

Core Features & Use Cases

  • Convert OpenSpec artifacts into self-contained Beads issues for implementation tracking.
  • Embed implementation steps, design context, acceptance criteria, and related background directly in each bead.
  • Use-case: Convert a completed design document into a series of beads representing tasks, owners, and milestones.

Quick Start

Create a beads task from an OpenSpec artifact that captures scope, rationale, and acceptance criteria.

Frequently Asked Questions about openspec-to-beads

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

FAQPage Schema
How do I convert OpenSpec planning artifacts into trackable tasks?

To convert OpenSpec planning artifacts into trackable tasks, you can transform design documents and specifications into self-contained issues that embed implementation steps, design rationale, and acceptance criteria directly for development tracking.

Why do I need to convert OpenSpec design documents into self-contained issues?

Converting OpenSpec design documents into self-contained issues prevents planning artifacts from staying siloed, reducing context-switching by embedding implementation steps, design context, and acceptance criteria directly within each trackable task.

What is the best way to turn a completed design document into implementation tasks?

The best way to turn a completed design document into implementation tasks is generating a series of trackable issues that capture scope, owners, milestones, and background context directly from your existing OpenSpec planning artifacts.

Can I track owners and milestones when converting OpenSpec artifacts to beads?

Yes, you can track owners and milestones when converting OpenSpec artifacts to beads by generating a series of issues from your completed design document that represent specific tasks, ownership, and project milestones.

Do I need completed OpenSpec planning artifacts before creating implementation tasks?

Yes, you need completed OpenSpec planning artifacts such as proposal, design, and specifications files before creating implementation tasks, because the conversion process embeds design rationale and acceptance criteria from those documents into each issue.

What context is included when converting OpenSpec artifacts to issue tracking?

When converting OpenSpec artifacts to issue tracking, the context included covers implementation steps, design rationale, related background, and acceptance criteria embedded directly within each self-contained issue to eliminate context-switching.