Agent skill

Linear Issue Workflow

by lobehub in lobehub/lobehub

Handles Linear issues for the team: reading details and images, checking sub-issues, marking progress, labeling AI-created issues and writing completion comments.

Custom licenceAuto-check passedProductivity & Automation

Install Linear Issue Workflow

skills CLI
$ npx skills add lobehub/lobehub --skill linear -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lobehub/lobehub linear --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lobehub/lobehub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/linear .claude/skills/linear && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
linear
GitHub stars
83k
Token cost
~1.5k tokens
SKILL.md length
819 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
Custom licence

At a glance

Handles Linear issues for the team: reading details and images, checking sub-issues, marking progress, labeling AI-created issues and writing completion comments.

  • Works in 5 steps: Prefix titles with an ordering index → Nest sub-issues by logical parent-child,… → Sub-issue creation order is dictated by… → …
  • Picking up a Linear issue to plan or implement it
  • SKILL.md covers Workflow, Creating Issues, Language and Creating Sub-issue Trees, plus 1 more section
  • Calls claude and bun

What it does

The skill governs how an agent works with Linear. It starts by discovering the available Linear tools, including deferred ones, and picking them by capability rather than by a fixed name, reporting a missing capability only after discovery. The workflow retrieves the issue, reads any images because screenshots often carry key context, checks for sub-issues, marks the issue In Progress when planning or implementing so teammates know it is owned, and follows a per-issue completion routine before moving to the next issue.

New issues get a claude code label so the team can audit AI-generated issues, and they are assigned to the authenticated user unless you say otherwise. Issue text follows the language of the conversation, Chinese or English, with technical terms, paths and code left in their original form, including when titles are edited. A further section covers creating trees of sub-issues.

When your agent uses it

  • Picking up a Linear issue to plan or implement it
  • Creating issues or sub-issue trees from a discussion
  • Posting a completion comment and updating an issue's status

Example prompts

  • “Start work on the Linear issue I just linked. Read it and its screenshots and check for sub-issues.”
  • “Create a parent issue and three sub-issues for the file upload rework.”
  • “Mark the issue done and add a completion comment linking the pull request.”

Requirements

  • A Linear connection or MCP tools that the agent can discover

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Prefix titles with an ordering index
  2. Nest sub-issues by logical parent-child, not flat under the root
  3. Sub-issue creation order is dictated by blockedBy
  4. Respect dependency order
  5. Keep each sub-issue description self-contained

What it can do on your machine

Read from SKILL.md and the folder at commit 1863542. 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

    Shell commands in SKILL.md call:

    • claude
    • bun

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Linear Issue Workflow loads about 1.5k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 819 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 819 words (~1,518 tokens).

“Before using Linear workflows, discover the available Linear tools, including deferred tools, and inspect their current schemas. Select tools by capability (issue lookup, images, sub-issues, create/update, comments), not a fixed MCP prefix or historical tool name. Report a missing capability…”

— opening of SKILL.md by lobehub, Custom licence
name
linear
user-invocable
false

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/linear of lobehub/lobehub.

Open the folder on GitHubat commit 1863542

Compare with similar skills

Linear Issue Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Linear Issue Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linear Issue Workflow this skilllobehub/lobehub83k—~1.5kAutomated safety check: PassCustom licence
Linearkv0906/pm-kit138—~1.9kAutomated safety check: NotesMIT
LinearAlexAI-MCP/hermes-CCC135—~916Automated safety check: PassMIT
Linear Claude Skillaiskillstore/marketplace4305 repos~3.6kAutomated safety check: NotesNone
Linear 2sundial-org/awesome-openclaw-skills663—~797Automated safety check: PassNone
Orca Linear Ticket Workflowstablyai/orca87k1 repos~522Automated safety check: PassMIT

Similar skills

  • Linear

    kv0906/pm-kit

    Interact with Linear for issue tracking — search, create, sync, and link issues to vault notes.

    138 GitHub stars~1.9k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check: notes
  • Linear

    AlexAI-MCP/hermes-CCC

    Linear project management — create issues, manage cycles, update projects, and query team progress via Linear API or MCP.

    135 GitHub stars~916 tokensUpdated 6 mo ago
    Backend & APIsAuto-check passed
  • Linear Claude Skill

    aiskillstore/marketplace

    Manage Linear issues, projects, and teams. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 5 repos~3.6k tokens
    Product & Project ManagementAuto-check: notes
  • Linear 2

    sundial-org/awesome-openclaw-skills

    Manage Linear projects, issues, and tasks via the Linear API.

    663 GitHub stars~797 tokensUpdated 7 mo ago
    Product & Project ManagementAuto-check passed
  • Linear ticket work through Orca's CLI. Use when working from a linked Linear issue, finishing work with a PR/MR link and a completion comment, moving a ticket…

    87k GitHub starsUsed in 1 repo~522 tokens
    Productivity & AutomationAuto-check passed
  • Linear ticket work through Orca's CLI. Use when working from a linked Linear issue, finishing work with a PR/MR link and a completion comment, moving a ticket…

    87k GitHub stars~558 tokensUpdated today
    Productivity & AutomationAuto-check passed

More from lobehub/lobehub

All 50 skills in this repo
  • Builds single-file interactive HTML prototypes rendered with the real LobeHub UI components and written as production-style React, so they can later be split into files.

    83k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Verifies a delivery end to end by driving the real product on a CLI, web, desktop or iOS Simulator surface, capturing evidence and publishing a round with the lh CLI.

    83k GitHub stars~9.7k tokensUpdated today
    Auto-check passed
  • Git Worktree Cleanup

    lobehub/lobehub

    Audits stale Git worktrees and branches with a bundled script, classifies each one, and deletes only after you approve the exact candidates.

    83k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Maintains LobeHub's model-backed alint rule set: writing rules, removing false positives against real code, deciding warn versus error and tracking token cost.

    83k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Guides building LobeHub builtin agent tools, from the manifest and execution runtime to executors, chat UI renders and registry wiring.

    83k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Explains how LobeHub client code fetches data through services, SWR store hooks and cache keys, and when to avoid useEffect fetching or duplicated state.

    83k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Questions about Linear Issue Workflow

What does Linear Issue Workflow do?

Handles Linear issues for the team: reading details and images, checking sub-issues, marking progress, labeling AI-created issues and writing completion comments. The skill governs how an agent works with Linear. It starts by discovering the available Linear tools, including deferred ones, and picking them by capability rather than by a fixed name, reporting a missing capability only after discovery.

When should I use Linear Issue Workflow?

Linear Issue Workflow fits situations like: picking up a Linear issue to plan or implement it; creating issues or sub-issue trees from a discussion; posting a completion comment and updating an issue's status.

How do I install Linear Issue Workflow in Claude Code?

Run `npx skills add lobehub/lobehub --skill linear -a claude-code`. Or copy the skill folder (.agents/skills/linear in lobehub/lobehub) into .claude/skills/linear in your project. Claude Code loads it when a task matches its description.

How do I install Linear Issue Workflow in Codex?

Run `npx skills add lobehub/lobehub --skill linear -a codex`. Or copy the skill folder (.agents/skills/linear in lobehub/lobehub) into .agents/skills/linear in your project. Codex loads it when a task matches its description.

Can I use Linear Issue Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lobehub/lobehub --skill linear -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/linear, .gemini/skills/linear, .github/skills/linear and .opencode/skills/linear in your project.

What does Linear Issue Workflow need to run?

Going by SKILL.md and its folder, Linear Issue Workflow needs the command-line tools its instructions call (claude and bun). Our summary lists: A Linear connection or MCP tools that the agent can discover.

Does Linear Issue Workflow access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Linear Issue Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Linear Issue Workflow use?

Linear Issue Workflow has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Linear Issue Workflow use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Linear Issue Workflow?

Skills that share tags, products or a category with Linear Issue Workflow: Linear (kv0906/pm-kit, 138 stars), Linear (AlexAI-MCP/hermes-CCC, 135 stars), Linear Claude Skill (aiskillstore/marketplace, 430 stars) and Linear 2 (sundial-org/awesome-openclaw-skills, 663 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear Issue Workflow?

lobehub (a GitHub organization) maintains it in lobehub/lobehub, which has 83,023 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 7, 2026.

Source: lobehub/lobehub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.