create-linear-issue

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.

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.

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.

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.

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.