linear-sync

Synchronize Linear issues with GitHub via GraphQL API and CLI.

1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/crystal-peak/linear-sync --skill linear-sync-crystal-peak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-sync
Source: https://github.com/crystal-peak/linear-sync/tree/main/skills/linear-sync
Command: npx skills add https://github.com/crystal-peak/linear-sync --skill linear-sync-crystal-peak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the synchronization between Linear issues and GitHub, streamlining development workflows by enforcing consistent tracking of commits, branches, and pull requests.

Core Features & Use Cases

  • Automated Workflow Enforcement: Ensures issue IDs are present in commits, branches, and PRs.
  • Seamless Syncing: Automatically updates GitHub issues after pushes and PR creations.
  • Issue Management: Facilitates issue creation, status updates, and progress commenting.
  • Use Case: When you create a new branch for a Linear issue like ENG-123, this Skill automatically names the branch correctly (e.g., user/ENG-123-fix-bug) and ensures your commits reference the issue ID. After pushing, it can offer to post a progress update to the Linear issue.

Quick Start

Use the linear-sync skill to resume your last Linear issue in the current repository.

Frequently Asked Questions about linear-sync

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

FAQPage Schema
How do I sync Linear issues with GitHub automatically?

To sync Linear issues with GitHub automatically, this Skill uses hooks and a subagent to enforce commit, branch, and PR naming conventions. It connects the Linear GraphQL API with GitHub CLI to manage issue creation and status updates seamlessly.

What does automated Linear GitHub integration enforce in my workflow?

Automated Linear GitHub integration enforces consistent tracking by requiring Linear issue IDs in your commit messages, branch names, and pull requests. This ensures every code change is directly linked to its corresponding project task.

Can I automatically update Linear issue status from a GitHub push?

Yes, you can automatically update Linear issue status from a GitHub push. After pushing commits, the Skill can offer to post progress comments and update the issue status directly via the Linear GraphQL API.

Do I need the GitHub CLI to manage Linear issues in my repository?

Yes, you need the GitHub CLI installed to manage Linear issues in your repository using this Skill. It relies on the GitHub CLI alongside the Linear GraphQL API to automate branch naming and pull request tracking.

How do I link a new Git branch to a specific Linear issue ID?

To link a new Git branch to a Linear issue ID, the Skill automatically formats your branch name to include the issue identifier, such as `user/ENG-123-fix-bug`. This enforces naming conventions and ensures proper tracking.

What is the best way to track Linear issue progress in GitHub pull requests?

The best way to track Linear issue progress in GitHub pull requests is by enforcing issue ID references in PR titles and commits. This Skill automates that tracking by updating issue statuses and posting progress comments via hooks.