linear-sync

Pull Linear issues and generate a local read-only snapshot in docs/LINEAR_SNAPSHOT.md.

6|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/opmau/claude-code-framework --skill linear-sync-opmau
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-sync
Source: https://github.com/opmau/claude-code-framework/tree/main/templates/.claude/skills/linear-sync
Command: npx skills add https://github.com/opmau/claude-code-framework --skill linear-sync-opmau

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams maintain a lightweight, local snapshot of Linear issues to reference without continually querying the remote system.

Core Features & Use Cases

  • Read-only local snapshot: generation of docs/LINEAR_SNAPSHOT.md from Linear data.
  • Status-based grouping: Active Bugs, In Progress, Upcoming, Recently Completed to reflect current work.
  • Team-aware syncing: supports optional team key to filter issues and tailor snapshots.

Quick Start

Regenerate the local Linear snapshot by invoking the /linear-sync command.

Frequently Asked Questions about linear-sync

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

FAQPage Schema
How do I generate a local snapshot of Linear issues?

To create a local snapshot of Linear issues, you need a tool that pulls current bugs, in-progress work, and upcoming items, writing them into a local read-only markdown file for fast offline reference.

What is the best way to view current Linear issues without continuous remote queries?

The best way to view current Linear issues without continuous remote queries is to sync them into a lightweight local snapshot grouped by status, such as Active Bugs, In Progress, Upcoming, and Recently Completed.

Do I need the Linear CLI installed to sync issues locally?

Yes, you need the Linear CLI installed and authenticated to sync issues locally, as the synchronization process queries Linear data through the CLI to build the local snapshot file.

Can I filter the Linear snapshot to only include issues for a specific team?

Yes, you can filter the Linear snapshot for a specific team by providing an optional team key, which tailors the generated local snapshot to only include issues assigned to that team.

Where does the synced Linear issue snapshot data get saved?

The synced Linear issue snapshot data gets saved locally to a markdown file named docs/LINEAR_SNAPSHOT.md, providing a read-only view of your current work, active bugs, and upcoming items.