Linear

What it does

Example prompts

• “/linear”

Requirements

• A Bash shell
• A credential in LINEAR_API_KEY
• A credential in TEAM_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1linear_get_issue to find the issue's team.id.
2. 2linear_get_workflow_states with that team_id to enumerate the team's states.
3. 3Pick the state by matching its name (case-insensitive) or type (unstarted, started, completed, canceled, triage, backlog).
4. 4linear_update_issue_state with the issue identifier and the resolved state_id.

What it can do on your machine

Read from SKILL.md and the folder at commit 3c608d8. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 7 files in scripts/ (Shell), which the agent can run.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • linear.app

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • TEAM_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Linear loads about 1.9k tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 754 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~29

When it runs · the whole SKILL.md, loaded when a task matches

~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from initializ/forge at commit 3c608d8, republished under its Apache-2.0 licence (© initializ). 754 words, ~1,908 tokens.

name

linear

description

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

icon

📋

category

project-management

tags

linear, issue-tracking, tickets, workflow

{
  "identifier": "ENG-123",
  "title": "...",
  "description": "...",
  "state": { "id": "...", "name": "In Progress", "type": "started" },
  "assignee": { "email": "...", "name": "..." },
  "team": { "id": "...", "key": "ENG", "name": "Engineering" },
  "labels": ["bug", "p1"],
  "priority": 2,
  "url": "https://linear.app/..."
}

{
  "count": 3,
  "issues": [
    { "identifier": "ENG-1", "title": "...", "state": "Todo", "assignee_email": "...", "url": "..." }
  ]
}

{
  "team_id": "...",
  "states": [
    { "id": "...", "name": "Todo",        "type": "unstarted", "position": 0 },
    { "id": "...", "name": "In Progress", "type": "started",   "position": 1 },
    { "id": "...", "name": "Done",        "type": "completed", "position": 2 }
  ]
}

{
  "success": true,
  "identifier": "ENG-123",
  "state": { "id": "...", "name": "In Progress", "type": "started" }
}

{
  "success": true,
  "comment": { "id": "...", "url": "https://linear.app/...", "created_at": "2026-05-20T..." }
}

© initializ, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts) in forge-skills/local/embedded/linear of initializ/forge.

• SKILL.md
• scripts/common.sh
• scripts/linear-add-comment.sh
• scripts/linear-get-issue.sh
• scripts/linear-get-workflow-states.sh
• scripts/linear-list-my-issues.sh
• scripts/linear-search-issues.sh
• scripts/linear-update-issue-state.sh

Open the folder on GitHubat commit 3c608d8