linear-issue-create

Create Linear issues from PROGRESS.md plans and update plan files with issue URLs.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/djalmaaraujo/claude-code-plugins --skill linear-issue-create
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-issue-create
Source: https://github.com/djalmaaraujo/claude-code-plugins/tree/main/plugins/planner/skills/linear-issue-create
Command: npx skills add https://github.com/djalmaaraujo/claude-code-plugins --skill linear-issue-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates turning plan files into Linear issues and updates plan files with issue URLs, reducing manual creation work and follow-up tracking.

Core Features & Use Cases

  • Read plans from plans/PROGRESS.md to identify candidate plans.
  • List Linear teams and prompt for target team selection.
  • Create Linear issues for selected plans with plan content as the description.
  • Update plan files with linear_issue URLs after creation. Use case examples: When a roadmap is maintained in plans/PROGRESS.md, this skill can batch-create issues and link back.

Quick Start

Use this skill to select plan entries in PROGRESS.md and generate corresponding Linear issues, then annotate each plan with its issue URL.

Frequently Asked Questions about linear-issue-create

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

FAQPage Schema
How do I batch-create Linear issues from a markdown plan file?

Batch-creating Linear issues from a markdown plan file involves reading plans/PROGRESS.md, prompting for target team selection, and generating issues via the Linear MCP server. The skill then updates the plan file by annotating each entry with its corresponding Linear issue URL.

How does syncing Linear issue URLs back to project plans work?

Syncing Linear issue URLs back to project plans works by creating issues from selected plan content and then writing the returned linear_issue URLs directly into the original plans/PROGRESS.md file. This ensures your local markdown roadmap stays linked to the tracking system.

Do I need the Linear MCP server to create issues from PROGRESS.md?

Yes, you need the Linear MCP server available to create issues from PROGRESS.md. The skill explicitly validates Linear MCP availability before reading the plan file and uses the mcp__linear-server__create_issue function to interact with your Linear workspace.

Can I select specific plans from PROGRESS.md to create Linear issues?

Yes, you can select specific plans from PROGRESS.md to create Linear issues. The skill reads the file to identify candidate plans and prompts you for plan selection, ensuring only the chosen roadmap entries are transformed into Linear issues.

What is the best way to automate project management issue tracking from markdown?

Automating project management issue tracking from markdown is best handled by using a skill that parses plans/PROGRESS.md, creates Linear issues via MCP integration, and writes the issue URLs back into the file. This eliminates manual creation work and maintains bidirectional links.

What are the limitations of automating Linear issue creation from markdown files?

Limitations of automating Linear issue creation from markdown files include strict dependence on the plans/PROGRESS.md file structure for parsing and the requirement of a valid Linear MCP connection. The skill cannot create issues if the MCP server is unavailable or the plan format is unrecognized.