Linear Issue Creator

Linear Issue Creator

Create issues in Linear using the Linear MCP with a 1 main issue + N sub-issues structure.

---

Core Principles

| Aspect | Main Issue | Sub-Issue | |---|---|---| | Perspective | Business / user perspective | Developer / engineer perspective | | Unit | One feature or problem | One PR-completable task | | Key question | "What changes for the user?" | "What code do we change?" | | Labels | None | Exactly 2 (1 area + 1 type) | | Status mgmt | Auto-completes when all sub-issues are done | Transitions individually |

---

Workflow Selection

Before gathering requirements, determine the workflow type:

| Workflow | When to use | Description | |---|---|---| | Generic | Code tasks: feature, bug, refactor, etc. | Use existing flow as-is | | PRD Pipeline | Issues requiring a PRD (product requirements doc) or feature spec | Apply content skill principles for high-quality descriptions |

• Generic → proceed to Issue Creation Workflow section below
• PRD Pipeline → proceed to PRD Pipeline Workflow section below

If the user doesn't specify, infer from the work description. Ask if unclear.

---

Mandatory Rules (Never Skip)

1. Project Linking

Every issue (main + sub) must be linked to a project via the project parameter.

2. Title Prefix

Every issue title must start with [ProjectName].

Examples:

• [corral] Implement global hotkey system
• [corral] Configure Tauri global hotkey plugin

3. Labeling (Sub-Issues Only)

Each sub-issue must have exactly 2 labels. The main issue has no labels.

Area label (pick exactly 1):

• Back-end
• Front-end

Type label (pick exactly 1):

• Bug — Bug fix
• Chore — Build, config, dependency maintenance
• Docs — Documentation
• Perf — Performance improvement
• Refactor — Code refactoring (no behavior change)
• Feature — New feature or feature update

4. Team

Always use "private" as the team when creating issues.

---

Issue Creation Workflow

Step 1: Gather Requirements

Confirm the following with the user:

1. Project: Which project (coin-agent, home-page, corral, intellij-jsoninja, etc.)
2. Work description: What to build, fix, or change
3. Area: Back-end / Front-end
4. Type: Bug / Chore / Docs / Perf / Refactor / Feature

If the user has already provided sufficient information, proceed directly. Otherwise, ask.

Step 2: Create the Main Issue

Call Linear:save_issue to create the main issue.

Parameters:

title: "[ProjectName] Main title"
team: "private"
project: "project-name"
description: (use template below)
priority: appropriate priority (1=Urgent, 2=High, 3=Normal, 4=Low)

Use the main issue description template from references/templates.md.

Do NOT assign any labels to the main issue.

Step 3: Create Sub-Issues

Use the main issue's ID as parentId for each sub-issue.

Parameters:

title: "[ProjectName] Sub-task title"
team: "private"
project: "project-name"
parentId: "main issue ID or identifier"
labels: ["area-label", "type-label"]   ← always exactly 2
description: (use template below)
priority: appropriate priority

Use the sub-issue description template from references/templates.md.

Step 4: Link Dependencies

If sub-issues depend on each other, connect them with blockedBy.

Linear:save_issue (update)
  id: "dependent issue identifier"
  blockedBy: ["prerequisite issue identifier"]

Step 5: Report Results

Summarize all created issues for the user:

• Main issue identifier + title + URL
• Sub-issue list (identifier, title, 2 labels, dependencies)

---

For a full flow example, see references/templates.md.

---

PRD Pipeline Workflow

Workflow for producing PRD-quality (product requirements document) issue descriptions. Applies principles from four content skills (content-strategy, content-production, content-humanizer, copy-editing) during the description writing process.

Fixed context:

• Target audience: Fullstack developers
• Language: Korean
• Tone: Professional (explaining to a peer developer — professional without being overly formal)

PRD Step 1: Gather Requirements + Select Pattern

Collect the same information as Generic Step 1 (Project, Work description, Area, Type). Additionally confirm:

1. PRD topic: What the PRD is about
2. Current state: Topic only, draft exists, or nearly complete
3. Auto-select pattern:

| Pattern | Starting state | Content skill stages to apply | |---|---|---| | A. Blank → Complete | Topic only | content-strategy → content-production → content-humanizer → copy-editing | | B. Draft → Complete | Draft exists | content-humanizer → copy-editing | | C. Polish only | Nearly complete | copy-editing |

PRD Step 2: Write Descriptions (Per-Pattern Process)

Apply the applicable stages in order to write issue descriptions. See references/prd-pipeline.md for the detailed guide.

Pattern A (Blank → Complete) — All 4 stages:

1. content-strategy principles: Plan the PRD structure

• Derive required sections from the target audience's perspective (feature overview, technical requirements, API specs, data models, non-functional requirements, etc.)
• Determine technical depth and scope for each section
• Establish sub-issue decomposition strategy

1. content-production principles: Draft the descriptions

• Write technical requirements at an implementation-ready level of specificity
• Make Acceptance Criteria measurable
• Define per-sub-issue Done Criteria at code level
• Use concrete numbers/specs instead of vague terms ("improve," "optimize")

1. content-humanizer principles: Remove AI patterns

• Eliminate repetitive phrasing (e.g., same sentence structure repeated)
• Remove unnecessary qualifiers ("very important," "essential," "critical")
• Replace with expressions developers actually use
• Deliberately vary sentence length

1. copy-editing principles: Run PRD-relevant Seven Sweeps checks

• Clarity: No ambiguous requirements
• Specificity: Concrete numbers, endpoints, data types specified
• So What: Each requirement explains "why it's needed"
• Prove It: Technical claims have backing (benchmarks, references, etc.)

Pattern B (Draft → Complete): Apply stages 3-4 only Pattern C (Polish only): Apply stage 4 only

PRD Step 3: Create Main Issue

Same as Generic Step 2 — call Linear:save_issue. Use the PRD Main Issue Description Template from references/templates.md.

PRD Step 4: Create Sub-Issues

Same as Generic Step 3 — create sub-issues. Use the PRD Sub-Issue Description Template from references/templates.md.

PRD Step 5: Link Dependencies + Report Results

Same as Generic Steps 4-5.

---

Pre-Creation Checklist

Verify before creating any issue:

Common:

• [ ] Is the project specified?
• [ ] Do all issue titles start with [ProjectName]?
• [ ] Does the main issue have no labels?
• [ ] Does every sub-issue have exactly 2 labels (1 area + 1 type)?
• [ ] Does each sub-issue's parentId point to the main issue?
• [ ] Are all issues linked to the project via project?
• [ ] Are inter-sub-issue dependencies defined?

PRD Pipeline additional checks (when PRD workflow is selected):

• [ ] Is the pattern (A/B/C) determined?
• [ ] Has the description passed through all content skill stages for the selected pattern?
• [ ] Is it written in Korean?
• [ ] Is the Professional tone maintained?
• [ ] Are concrete specs included with no vague expressions?
• [ ] Are AI patterns (repetitive phrasing, excessive qualifiers) removed?

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: buYoung
• Source: buYoung/skills
• License: MIT

Install and usage instructions live in the source repository linked above.