New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Linear

by emanuelcasco in emanuelcasco/pi-mono-extensions

Access Linear project management data using native pi tools — issues, projects, teams, users, comments, file uploads, cycles, labels, workflow states, and documents.

MITAuto-check passedBackend & APIs

Install Linear

skills CLI
$ npx skills add emanuelcasco/pi-mono-extensions --skill linear -a claude-code

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

GitHub CLI
$ gh skill install emanuelcasco/pi-mono-extensions 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/emanuelcasco/pi-mono-extensions.git skills-src && mkdir -p .claude/skills && cp -r skills-src/extensions/linear/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
106
Token cost
~1.2k tokens
SKILL.md length
546 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Access Linear project management data using native pi tools — issues, projects, teams, users, comments, file uploads, cycles, labels, workflow states, and documents.

  • Tasks that involve File uploads and storage
  • SKILL.md covers Critical Rules, Authentication, Tool Workflow and Available Tool Groups, plus 4 more sections
  • Reaches uploads.linear.app; needs LINEAR_API_KEY
  • Tasks that involve Project management

What it does

Linear is an agent skill from emanuelcasco/pi-mono-extensions. Access Linear project management data using native pi tools — issues, projects, teams, users, comments, file uploads, cycles, labels, workflow states, and documents. Requires a Linear personal API key.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering File uploads and storage and Project management. It works with Linear. The repository describes itself as: Collection of pi-mono extensions. The licence is MIT.

When your agent uses it

  • Tasks that involve File uploads and storage
  • Tasks that involve Project management

Example prompts

  • “/linear”

Requirements

  • A credential in LINEAR_API_KEY

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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:

    • uploads.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:

    • LINEAR_API_KEY

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

Context cost

Linear loads about 1.2k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 546 words of instructions outside code blocks.

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

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

The full file from emanuelcasco/pi-mono-extensions at commit e4e047a, republished under its MIT licence (© emanuelcasco). 546 words, ~1,243 tokens.

Download SKILL.mdSave it as .claude/skills/linear/SKILL.md (or your agent's skills folder).
name
linear
description
Access Linear project management data using native pi tools — issues, projects, teams, users, comments, file uploads, cycles, labels, workflow states, and documents. Requires a Linear personal API key.

Linear Integration

Use the native linear_* tools to read and write Linear data through the Linear GraphQL API.

Critical Rules

  • Never ask the user to paste a Linear API key in chat.
  • Never expose the API key inline in shell commands.
  • Before updating an issue or commenting, use linear_get_issue to verify the target.
  • Before uploading a file to an issue comment, use linear_get_issue to verify the target.
  • When IDs are unknown, use linear_workspace_metadata first.

Authentication

The tools read the key from an in-memory override, LINEAR_API_KEY, or ~/.pi/agent/auth.json at .linear.key.

If auth is missing, invalid, or expired, do not ask the user to paste the key in chat. Use the native linear_configure_auth tool or ask the user to run /linear-auth --force. The prompt is masked and the key is stored by the extension without returning it to the model.

Tool Workflow

  • Use linear_configure_auth only when auth is missing, invalid, expired, or the user asks to update the key.
  • Use linear_workspace_metadata first when team/project/state/label/user IDs are unknown.
  • Use linear_search_issues for keyword lookup.
  • Use linear_get_issue before updating or commenting.
  • Use linear_get_issue to inspect Linear issues; Markdown images embedded in the issue description are automatically included when the active model supports image input.
  • If linear_get_issue reports description images were skipped because the current model does not support images, ask the user to switch to a vision-capable model before interpreting screenshots.
  • Use linear_list_issues for filtered issue lists by team, assignee, status, or limit.
  • Use linear_create_issue to create issues once the team ID is known.
  • Use linear_update_issue to change title, description, priority, state, or assignee.
  • Use linear_create_comment to add Markdown context to an issue.
  • Use linear_upload_file to upload a local image, video, or generic file and get a Linear asset URL.
  • Use linear_upload_file_to_issue_comment to upload a local file and comment on a verified issue in one step.

Available Tool Groups

Workspace and users
  • linear_whoami
  • linear_workspace_metadata
  • linear_list_teams
  • linear_get_team
  • linear_list_users
  • linear_get_user
Issues
  • linear_list_issues
  • linear_search_issues
  • linear_get_issue
  • linear_list_my_issues
  • linear_create_issue
  • linear_update_issue
Projects, states, labels, cycles, documents
  • linear_list_projects
  • linear_get_project
  • linear_list_issue_statuses
  • linear_get_issue_status
  • linear_list_labels
  • linear_list_cycles
  • linear_list_documents
  • linear_get_document
Show full SKILL.md (213 more words)Show less
Comments
  • linear_list_comments
  • linear_create_comment
  • linear_configure_auth
Files
  • linear_upload_file
  • linear_upload_file_to_issue_comment

Issue Description Images

  • Linear issue screenshots embedded in descriptions are Markdown images, not necessarily GraphQL attachment objects.
  • linear_get_issue parses description Markdown image links like ![Screenshot](https://uploads.linear.app/...).
  • When the active model supports image input, linear_get_issue downloads private Linear image URLs in memory with Linear auth and attaches native image blocks to the result.
  • When the active model is text-only, image downloads are skipped and the tool returns a note plus image metadata.
  • Description images are not written to disk by default.

File Upload Notes

  • Upload tools accept local file paths only; they do not read folders recursively.
  • Tool results include sanitized metadata and the Linear asset URL, not file bytes, signed upload URLs, or upload headers.
  • Images are suitable for Markdown image embeds: ![alt text](assetUrl).
  • Videos and other files should generally be linked: [filename](assetUrl).
  • linear_upload_file_to_issue_comment creates image Markdown automatically for image content types and link Markdown for other content types.
  • commentBody may include {url} or {markdown} placeholders; otherwise generated file Markdown is appended to the comment body.

Priority Values

ValueLabel
0No priority
1Urgent
2High
3Medium
4Low

Issue Status Types

TypeMeaning
backlogNot yet started, in backlog
triageNeeds triage
unstartedNot yet started
startedIn progress
completedDone
canceledWon't do

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

Files

Just SKILL.md in extensions/linear/skills/linear of emanuelcasco/pi-mono-extensions.

Open the folder on GitHubat commit e4e047a

Compare with similar skills

Linear 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linear this skillemanuelcasco/pi-mono-extensions106—~1.2kAutomated safety check: PassMIT
Linearletta-ai/lettabot326—~583Automated safety check: PassApache-2.0
LinearAlexAI-MCP/hermes-CCC135—~916Automated safety check: PassMIT
LinearOpenHands/extensions157—~1.9kAutomated safety check: PassMIT
Linearkv0906/pm-kit138—~1.9kAutomated safety check: NotesMIT
Linear Issue Workflowlobehub/lobehub83k—~1.5kAutomated safety check: PassCustom licence

Similar skills

  • Linear

    letta-ai/lettabot

    Manage Linear issues via GraphQL API. An agent skill from letta-ai/lettabot.

    326 GitHub stars~583 tokensUpdated 4 mo ago
    Backend & APIsAuto-check passed

  • 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

    OpenHands/extensions

    Interact with Linear project management - query issues, update status, create tickets, and manage workflows using the Linear GraphQL API.

    157 GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed

  • 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 Issue Workflow

    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.

    83k GitHub stars~1.5k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Gsd Integration Checker

    allgpt-co/QuickVoice

    Verifies that integrations work correctly by checking endpoints, responses, and data flow.

    488 GitHub stars~2.8k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

More from emanuelcasco/pi-mono-extensions

  • Release

    emanuelcasco/pi-mono-extensions

    Release a new version of pi-extensions: bump individual package versions (independent mode), update CHANGELOGs and READMEs, create per-package git tags, publish a GitHub release, and publish…

    106 GitHub stars~2.3k tokensUpdated 1 mo ago
    Auto-check passed

  • Figma

    emanuelcasco/pi-mono-extensions

    Access Figma design files using native pi tools — read LLM-ready summaries, explanations, implementation context, screenshots, components, styles, variables, and design tokens.

    106 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed

  • Web Search

    emanuelcasco/pi-mono-extensions

    Search the web and read page content using native pi tools — DuckDuckGo search results, web page fetching, and Mozilla Readability extraction.

    106 GitHub stars~513 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Linear

What does Linear do?

Access Linear project management data using native pi tools — issues, projects, teams, users, comments, file uploads, cycles, labels, workflow states, and documents. Linear is an agent skill from emanuelcasco/pi-mono-extensions. Access Linear project management data using native pi tools — issues, projects, teams, users, comments, file uploads, cycles, labels, workflow states, and documents.

When should I use Linear?

Linear fits situations like: tasks that involve File uploads and storage; tasks that involve Project management.

How do I install Linear in Claude Code?

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

How do I install Linear in Codex?

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

Can I use Linear 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 emanuelcasco/pi-mono-extensions --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 need to run?

Going by SKILL.md and its folder, Linear needs credentials named LINEAR_API_KEY. Our summary lists: A credential in LINEAR_API_KEY.

Does Linear access the network?

SKILL.md names 1 domain. In commands or code: uploads.linear.app; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Linear 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 use?

Linear is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Linear use?

About 1.2k tokens (SKILL.md is roughly 5k 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?

Skills that share tags, products or a category with Linear: Linear (letta-ai/lettabot, 326 stars), Linear (AlexAI-MCP/hermes-CCC, 135 stars), Linear (OpenHands/extensions, 157 stars) and Linear (kv0906/pm-kit, 138 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear?

emanuelcasco (a GitHub user) maintains it in emanuelcasco/pi-mono-extensions, which has 106 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 26, 2026.

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