linear-plan-mode

Create and update Linear issues from plan file changes during Claude Code plan mode.

2|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/jclfocused/claude-agents --skill linear-plan-mode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-plan-mode
Source: https://github.com/jclfocused/claude-agents/tree/main/skills/linear-plan-mode
Command: npx skills add https://github.com/jclfocused/claude-agents --skill linear-plan-mode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that feature plans created in Claude Code's plan mode are accurately and automatically maintained in Linear, a project management tool, preventing desynchronization and manual overhead.

Core Features & Use Cases

  • Automated Issue Creation: Creates parent and sub-issues in Linear directly from plan file changes.
  • Real-time Synchronization: Updates Linear issues as the plan evolves, reflecting new sections, modifications, or cancellations.
  • Structured Planning: Enforces specific formats for Linear issues (parent and sub-issues) including labels, statuses, and descriptions with Mermaid diagrams.
  • Use Case: When planning a new software feature, this Skill will automatically create a "Feature Root" issue in Linear and then generate corresponding sub-issues for each development step (e.g., backend API, frontend UI) as they are defined in the plan file.

Quick Start

Use the linear-plan-mode skill to create a new feature plan in Linear.

Frequently Asked Questions about linear-plan-mode

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

FAQPage Schema
How do I automatically sync Claude Code plan files with Linear issues?

You can sync plan files with Linear issues by using a skill that automatically creates and updates parent and sub-issues in Linear based on changes made to the plan file during Claude Code's plan mode.

What is the best way to maintain feature plans in Linear without manual overhead?

The best way to maintain feature plans in Linear without manual overhead is to automate issue creation and real-time synchronization directly from your planning environment, ensuring statuses and labels stay updated as the plan evolves.

Do I need MCP tools to create Linear issues from Claude Code plan mode?

Yes, integrating with MCP tools is required for this skill to perform direct Linear operations, such as creating parent and sub-issues, updating statuses, and applying labels within the plan mode environment.

Can I enforce specific status and labeling conventions for Linear parent and sub-issues?

Yes, the skill enforces structured planning formats for Linear issues, automatically applying specific statuses, labels, and descriptions including Mermaid diagrams to both parent and sub-issues during synchronization.

How does plan mode handle cancelled or modified development steps in Linear?

When a development step is modified or cancelled in the plan file, the skill performs real-time synchronization to update or cancel the corresponding Linear issues, preventing desynchronization.