create-linear-issue

Transform planning documents into hierarchical Linear issues with linked parent-child relationships.

Updated Oct 15, 2025

Search Tags:#planning #linear #issues #acceptance-criteria #planning-docs

Ready to run

npx skills add https://github.com/kingler/v0-jetvision-assistant --skill create-linear-issue

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: create-linear-issue
Source: https://github.com/kingler/v0-jetvision-assistant/tree/main/.claude/skills/create-linear-issue
Command: npx skills add https://github.com/kingler/v0-jetvision-assistant --skill create-linear-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transform planning documents into a hierarchical set of Linear issues (Feature > Epic > User Story > Tasks) with controlled acceptance criteria to improve traceability and execution.

Core Features & Use Cases

Hierarchical generation: Feature > Epic > User Story > Tasks from a plan document.
Acceptance Criteria automation: Each user story includes Given-When-Then criteria in Gherkin format.
UAT integration: Optionally generates and links UAT instructions, saved to docs/uat when available.

Quick Start

Feed a plan document like docs/plans/2026-02-12-chat-session-load.md to this skill to generate a Feature > Epic > User Story > Tasks hierarchy with Given-When-Then acceptance criteria.

Frequently Asked Questions about create-linear-issue

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

FAQPage Schema

How do I turn planning docs into structured Linear issues?▼

To turn planning docs into structured Linear issues, feed a plan document from .claude/plans/ or docs/plans/ to generate a Feature > Epic > User Story > Tasks hierarchy with linked parent-child relationships and Given-When-Then acceptance criteria.

What is the hierarchy structure used for Linear issues from planning documents?▼

The hierarchy structure for Linear issues from planning documents follows a Feature > Epic > User Story > Tasks tree. This hierarchical generation ensures linked parent-child relationships are maintained for complete project traceability and execution tracking.

Do I need the Linear MCP configuration to generate issues from plan documents?▼

Yes, you need the Linear MCP configuration to generate issues from plan documents. The skill validates prerequisites such as Linear MCP configuration, required labels, and project scope before producing a ready-to-use issue structure with proper links.

How are acceptance criteria formatted when creating Linear issues?▼

Acceptance criteria are formatted in Given-When-Then Gherkin format when creating Linear issues. Each generated user story automatically includes these controlled acceptance criteria to improve traceability and execution validation throughout the project lifecycle.

Can I generate UAT instructions alongside Linear issues from planning docs?▼

Yes, you can generate UAT instructions alongside Linear issues from planning docs. The skill optionally generates and links UAT instructions, saving them to the docs/uat directory when available, ensuring complete testing integration.