Linear issue sync

Linear Issue Sync

Check Linear for assigned issues and sync with local task management.

Instructions

Step 1: Fetch Assigned Issues

Call linear_list_issues filtered to:

• Assigned to current user
• Status not "Done" or "Canceled"

Step 2: Compare with Local Tasks

Check Tasks/ for existing files with Linear references:

• Look for linear_id in YAML frontmatter
• Identify new issues not yet in Tasks/

Step 3: Present Summary

Linear Issues (5 active):

**High Priority**
- LIN-123: Fix authentication timeout [In Progress]
- LIN-124: Update API documentation [Todo]

**Normal Priority**  
- LIN-125: Refactor user service [Backlog]

2 issues not yet in local Tasks. Create them?

Step 4: Sync Options

Option	Description
Create all	Add all new issues as local tasks
Select specific	Choose which to sync
Skip	Continue without syncing

Step 5: Create Local Tasks

For each issue to sync, create task file:

---
title: [Issue title]
category: technical
priority: [Map from Linear priority]
status: n
linear_id: LIN-XXX
---

Example Flow

User: "What should I work on today?"

Agent:

1. Fetches Linear issues
2. Compares with local tasks
3. "You have 3 new Linear issues..."
4. Offers to create local tasks
5. Continues with planning

Notes

• Map Linear priorities to P0-P3
• Keep linear_id in frontmatter for bidirectional sync
• Update Linear status when local task completes

When to Use

Use this skill when the task directly matches the workflow described above.

When Not to Use

Do not use this skill when the request is unrelated, low-stakes, or better handled by a simpler direct response.