linear-issue-sync

Sync Linear issues with local tasks. Use during daily planning or when user asks about Linear issues.

SKILL.md

GitHub

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