linear-sync

Installation
SKILL.md
Contains Shell Commands

This skill contains shell command directives (!`command`) that may execute system commands. Review carefully before installing.

Linear Sync Workflow

This system keeps Linear and GitHub in sync automatically. Linear API queries go through the linear-sync subagent (foreground), while simple mutations use linear-api.sh directly via Bash.

Session Start Behavior

At the start of every session, the linear-session-start hook fires and checks the repo:

  • Linked repo: The hook injects config context (workspace, project, team, label, formats, last_issue if any, stale branch warnings, and pre-fetched digest if due). Follow the session kickoff directive below.
  • Opted-out repo (workspace: "none"): The hook is silent. Do nothing related to Linear.
  • Unregistered repo: The hook injects a [LINEAR-SETUP] directive. Follow the setup wizard rules below. If a .linear-sync-template.json is found, the hook also injects [LINEAR-TEMPLATE] with defaults to pre-fill.
  • Broken workspace reference: The hook injects a [LINEAR-SETUP] directive to reconfigure or opt out.

Session Kickoff (Linked Repos)

When the hook injects config context for a linked repo:

Step 1: Digest and stale branches

Related skills

More from b-open-io/prompts

Installs
6
GitHub Stars
12
First Seen
Feb 27, 2026