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.