DE

design-to-issues

Converts approved design plan sections into trackable GitHub issue epics.

Install

mkdir -p .claude/skills/design-to-issues && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12282" && unzip -o skill.zip -d .claude/skills/design-to-issues && rm skill.zip

Installs to .claude/skills/design-to-issues

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Creates a GitHub epic and child issues from a design document's implementation plan. Use when a design doc has a reviewed plan section ready to be converted into trackable work.
177 chars✓ has a “when” trigger
Advanced

Key capabilities

  • →Read a design document to identify project name and plan section
  • →Draft a GitHub epic issue body from the design document
  • →Create a GitHub epic issue
  • →Create child GitHub issues for non-deferred plan items
  • →Update the epic issue with actual child issue numbers

How it works

The skill reads a design document, extracts the project plan, drafts an epic issue body, creates the epic, and then delegates to sub-agents to create child issues for each non-deferred plan item. Finally, it updates the epic with the created issue numbers.

Inputs & outputs

You give it
A path to a design document (e.g., `docs/designs/theming.md`)
You get back
A GitHub epic issue URL and a summary table of created child issues

When to use design-to-issues

  • →Turning design docs into issues
  • →Managing project implementation tasks
  • →Creating github epics

About design-to-issues

Reads design documents to extract project plans and converts them into GitHub epics with linked child tasks. This helps maintain parity between design intent and implementation work.

Creates a GitHub epic and child issues from a design document's implementation plan. Use when a design doc has a reviewed plan section ready to be converted into trackable work.

When not to use it

  • →When the design document lacks a reviewed, approved plan section
  • →When `gh` CLI is not authenticated
  • →When the user has not reviewed and approved the plan in the design doc

Prerequisites

gh CLI authenticated

Limitations

  • →Requires a reviewed and approved plan section in the design document.
  • →Does not create issues for deferred items.
  • →Dependencies between issues are mentioned in context, not enforced via GitHub's project tooling.

How it compares

This skill automates the conversion of a design document's implementation plan into a structured GitHub epic with linked child issues, ensuring design intent is translated into trackable work more efficiently than manual issue creation.

Compared to similar skills

design-to-issues side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
design-to-issues (this skill)07moNo flagsAdvanced
linear-ticket18moNo flagsIntermediate
team-routing18moReviewIntermediate
team-workflow03moNo flagsAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry