linear-story

Format a structured story spec into a Linear-ready issue template.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/maestria-co/ai-playbook --skill linear-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-story
Source: https://github.com/maestria-co/ai-playbook/tree/main/skills/linear-story
Command: npx skills add https://github.com/maestria-co/ai-playbook --skill linear-story

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structured story specs are often scattered and require manual formatting to fit Linear's issue template. This skill formats the input into a complete Linear-ready ticket, ensuring consistency and faster handoffs to the product-manager workflow.

Core Features & Use Cases

  • Formats a structured story spec into Linear's issue fields (Title, Team, Assignee, Priority, etc.) and builds a comprehensive Description with sections for Story, Problem Statement, Acceptance Criteria, Technical Notes, Dependencies, Open Questions.
  • Validates presence of User story, acceptance criteria, technical notes, and open questions, and surfaces gaps as inferred Open Questions.
  • Produces a single Markdown block suitable for pasting into Linear or creating a new Linear issue.

Quick Start

Provide a structured story spec and run this skill to format it into a Linear-ready issue.

Frequently Asked Questions about linear-story

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

FAQPage Schema
How do I format a user story spec into a Linear issue?

To format a user story spec into a Linear issue, provide your structured story spec including acceptance criteria and technical notes. The skill packages this input into a Markdown block matching Linear's issue template with Title, Priority, Labels, and Description sections.

What is needed to create a Linear-ready ticket from a story spec?

Creating a Linear-ready ticket requires a structured story spec containing your user story, acceptance criteria, technical notes, dependencies, and open questions. The formatter validates these components and surfaces gaps as inferred open questions within the final Markdown output.

Can I use this to generate Linear tickets for product management workflows?

Yes, you can use this to generate Linear tickets for product management workflows. It ingests structured story specs and outputs a single Markdown block suitable for pasting directly into Linear, ensuring consistent formatting and faster handoffs.

Does the Linear issue formatter include fields for cycle and priority?

Yes, the Linear issue formatter includes fields for cycle and priority. The generated Markdown template contains standard Linear fields like Title, Team, Assignee, Priority, Estimate, Cycle/Sprint, Labels, and Status alongside detailed description sections.

What happens if my story spec is missing acceptance criteria or open questions?

If your story spec is missing acceptance criteria or open questions, the formatter validates the input and surfaces those gaps. Missing elements are automatically generated and highlighted as inferred open questions in the final Linear issue template.

How to package technical notes and dependencies into a Linear ticket?

To package technical notes and dependencies into a Linear ticket, input your raw structured spec. The formatter maps these details into the Description section and builds a comprehensive Technical Notes and Dependencies block within the Markdown output.