# Linear Issue Sync

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

- Skill: `itseffi/linear-issue-sync-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add itseffi/linear-issue-sync-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/itseffi/linear-issue-sync-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: itseffi (https://skillmd.com/u/itseffi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/itseffi/linear-issue-sync-2

---


# 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:

```yaml
---
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