opsx-plan-to-issues

Convert OpenSpec tasks.md files into plan.json and GitHub issues.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/ConductionNL/decidesk --skill opsx-plan-to-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opsx-plan-to-issues
Source: https://github.com/ConductionNL/decidesk/tree/main/.claude/skills/opsx-plan-to-issues
Command: npx skills add https://github.com/ConductionNL/decidesk --skill opsx-plan-to-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts OpenSpec changes' tasks.md into a structured plan.json and creates GitHub issues to enable progress tracking across teams.

Core Features & Use Cases

  • Parse tasks.md into a JSON plan with change, tasks, acceptance criteria, and file references.
  • Create GitHub issues with a standardized title and a body that summarizes the change, lists delta specs, and includes a Task checklist with acceptance criteria.
  • Update the corresponding openspec/changes/<change-name>/plan.json with the created tracking_issue, enabling traceability.
  • Validate prerequisites (tasks.md presence, GitHub authentication), derive repo/app labels, and skip already-tracked changes.

Quick Start

Run the plan-to-issues command to convert your OpenSpec tasks into GitHub issues for progress tracking.

Frequently Asked Questions about opsx-plan-to-issues

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

FAQPage Schema
How do I convert OpenSpec tasks.md into GitHub issues?

To convert OpenSpec tasks.md into GitHub issues, run the plan-to-issues command to parse tasks into a structured plan.json and automatically create corresponding GitHub issues with task checkboxes and acceptance criteria for progress tracking.

Why does the plan-to-issues process skip certain OpenSpec changes?

The plan-to-issues process skips OpenSpec changes that lack a tasks.md file, have already been tracked in an existing plan.json, or fail prerequisite checks like GitHub authentication and required repository labels.

How do I track OpenSpec change progress in GitHub?

You track OpenSpec change progress in GitHub by generating issues linked to a plan.json file. The Skill updates each change's plan.json with a tracking_issue reference, ensuring traceability between your specs and GitHub.

Do I need GitHub authentication to generate issues from OpenSpec?

Yes, you need GitHub authentication to generate issues from OpenSpec. The Skill verifies authentication and ensures required repository labels exist before creating issues and updating your plan.json files.

What's included in GitHub issues generated from OpenSpec tasks?

GitHub issues generated from OpenSpec tasks include a standardized title, a summary of the change, listed delta specs, and a task checklist with acceptance criteria, all linked back to the plan.json via a tracking_issue.