sync-plan-issue

Create or update GitHub issues from structured plan summaries using the GitHub CLI.

2|Updated Dec 20, 2020
One-click install
npx skills add https://github.com/buvis/home --skill sync-plan-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-plan-issue
Source: https://github.com/buvis/home/tree/main/.claude/skills/sync-plan-issue
Command: npx skills add https://github.com/buvis/home --skill sync-plan-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Planning conversations and documents often fail to convert into trackable work items. This Skill automatically creates or updates GitHub issues from structured plan summaries, keeping execution aligned with planning.

Core Features & Use Cases

  • Create a new GitHub issue from the current plan summary based on Linear Method + Shape Up artifacts.
  • Update an existing issue with the latest plan details to maintain alignment among teammates.
  • Accept plan sources from conversation outputs, local plan files (dev/local/plans/), or PRD artifacts (dev/local/prds/wip/).

Quick Start

Trigger the sync to create or update a GitHub issue from the current plan.

Frequently Asked Questions about sync-plan-issue

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

FAQPage Schema
How do I create GitHub issues from a plan summary?

You can create GitHub issues from a plan by triggering this Skill, which parses Problem, Appetite, Solution, Scope, and Tasks fields from your structured plan summary and uses the GitHub CLI to generate the issues automatically.

Can I update existing GitHub issues with changes from my local plan files?

Yes, you can update existing GitHub issues with changes from local plan files. This Skill syncs the latest plan details from sources like dev/local/plans/ to maintain alignment among teammates by updating the corresponding issue via the GitHub CLI.

What plan formats are supported for syncing to GitHub issues?

Supported plan formats for syncing to GitHub issues include conversation outputs, local plan files stored in dev/local/plans/, and PRD artifacts located in dev/local/prds/wip/. The Skill parses a Plan Summary template to extract structured planning data.

Do I need authenticated GitHub access to automate issue creation from PRDs?

Yes, authenticated GitHub access is required to automate issue creation from PRDs. This Skill relies on the GitHub CLI to interact with your repositories, necessitating proper authentication to create or update issues from your planning artifacts.

What is the best way to convert Shape Up artifacts into trackable GitHub issues?

The best way to convert Shape Up artifacts into trackable GitHub issues is using this Skill, which applies a Plan Summary template to parse Linear Method and Shape Up components and automatically generates or updates issues via the GitHub CLI.