Linear

Read Linear issues, transition state, and post comments. The entry point for ticket-driven agent workflows.

230 stars 17 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add initializ/forge --skill linear
Manual install
git clone --depth 1 https://github.com/initializ/forge.git /tmp/forge
mkdir -p ~/.claude/skills
cp -r /tmp/forge/forge-skills/local/embedded/linear ~/.claude/skills/linear

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Linear Skill

You can read, search, and update Linear issues, list workflow states, and post comments. Use this skill as the entry point for ticket-driven workflows — turn `ENG-123` into a structured payload, transition state, comment on progress.

## When to use this skill

- The user references a Linear issue by identifier (`ENG-123`, `OPS-7`, etc.).
- The user asks for "my tickets" / "open issues" / "what's assigned to me".
- An automation needs to mark work started, post a PR link as a comment, or move a ticket through workflow states.

## Issue identifier format

Linear identifiers look like `<TEAM_KEY>-<NUMBER>` — `ENG-123`, `OPS-7`. They are **not** GraphQL UUIDs. The Linear API accepts both forms on `issue(id:)`, so always pass the human identifier the user gave you. Never invent or normalise identifiers — use them verbatim.

## State transition pattern (hard rule)

You MUST call `linear_get_workflow_states` first and use the resolved `id` when calling `linear_update_issue_state`. State IDs are per-team UUIDs; state names like `"Todo"` or `"In Progress"` are not portable across teams and cannot be passed to `linear_update_issue_state` directly.

Workflow:

1. `linear_get_issue` to find the issue's `team.id`.
2. `linear_get_workflow_states` with that `team_id` to enumerate the team's states.
3. Pick the state by matching its `name` (case-insensitive) or `type` (`unstarted`, `started`, `completed`, `canceled`, `triage`, `backlog`).
Read the full skill on GitHub

Details

Skill name
linear
Path
forge-skills/local/embedded/linear/SKILL.md
License
Apache-2.0
Repo updated
17 November 2026

FAQ

What does the Linear skill do?

Read Linear issues, transition state, and post comments. The entry point for ticket-driven agent workflows.

How do I install the Linear skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add initializ/forge --skill linear. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Linear popular?

It lives in initializ/forge, which has 230 GitHub stars and 17 forks.

Related skills

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.