start-phase

Creates GitHub Issues from PROJECT_PLAN.md phase tasks and writes issue links back.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/mobiustripper42/jig --skill start-phase-mobiustripper42
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-phase
Source: https://github.com/mobiustripper42/jig/tree/main/.claude/skills/start-phase
Command: npx skills add https://github.com/mobiustripper42/jig --skill start-phase-mobiustripper42

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually converting a project plan's phase tasks into tracked GitHub Issues is repetitive and error-prone, and keeping the plan file in sync with created issue numbers is easy to forget. ## Core Features & Use Cases - Phase Materialization: Parses a phase's task table from docs/PROJECT_PLAN.md and creates one GitHub Issue per task with phase:N and points:X labels. - Prerequisite Validation: Verifies gh authentication, repo context, clean git working tree, and required labels before creating anything. - Plan Synchronization: Writes created issue numbers back into PROJECT_PLAN.md as links, then commits and pushes the update. - Use Case: At the start of Phase 2 of a sprint, run the skill to turn ten planned tasks into ten labeled GitHub Issues, with the plan file automatically updated to reference each issue. ## Quick Start Ask the assistant to run /start-phase with a phase number to materialize that phase from PROJECT_PLAN.md into GitHub Issues.

Frequently Asked Questions about start-phase

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

FAQPage Schema
How do I create GitHub Issues from a Markdown project plan?

Run /start-phase with a phase number to parse the task table in docs/PROJECT_PLAN.md and create one GitHub Issue per task via gh issue create. Each issue gets phase:N and points:X labels, and issue links are written back into the plan file.

How to bulk create GitHub issues with labels using gh CLI?

Use gh issue create with --title, --body, and --label flags for each task. This skill automates that loop, applying phase:N and points:X labels and generating a structured body with task ID, points, and acceptance criteria.

What prerequisites are needed before running start-phase?

You need an authenticated gh CLI (gh auth status), a GitHub repository context, and a clean git working tree. The skill also checks for required labels like phase:N, points:X, and blocked, creating any that are missing.

What happens if gh issue create fails partway through?

The skill surfaces the failure, lists which issues were already created, and asks whether to retry or abort. This prevents duplicate issues and lets you recover manually before the plan file is updated.

Does start-phase modify PROJECT_PLAN.md after issues are created?

Yes, it replaces each task's status cell with a link to the created issue, then commits and pushes the change. After this one-time write, the file is treated as read-only until the /retro skill runs at phase end.