Agent skill

Linear Uploads

by nesszer in nesszer/linear-cli

Download attachments and images from Linear issues. An agent skill from nesszer/linear-cli.

MITAuto-check: notes

Install Linear Uploads

skills CLI
$ npx skills add nesszer/linear-cli --skill linear-uploads -a claude-code

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

GitHub CLI
$ gh skill install nesszer/linear-cli linear-uploads --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/nesszer/linear-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/linear-uploads .claude/skills/linear-uploads && 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-uploads
GitHub stars
138
Token cost
~357 tokens
SKILL.md length
77 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Download attachments and images from Linear issues. An agent skill from nesszer/linear-cli.

  • Fetching screenshots
  • SKILL.md covers Download to File, Output to Stdout, Finding Upload URLs and View Images (AI Agents), plus 1 more section
  • Reaches uploads.linear.app; needs LINEAR_API_KEY
  • File attachments from Linear comments

What it does

Linear Uploads is an agent skill from nesszer/linear-cli. Download attachments and images from Linear issues. Use when fetching screenshots, images, or file attachments from Linear comments or descriptions.

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

It works with Linear. The repository describes itself as: A powerful CLI for Linear.app built with Rust. The licence is MIT.

When your agent uses it

  • Fetching screenshots
  • File attachments from Linear comments

Example prompts

  • “/linear-uploads”

Requirements

  • A credential in LINEAR_API_KEY
  • Pre-approved tools (allowed-tools): Bash, Read

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    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 Uploads loads about 357 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 77 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read

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 nesszer/linear-cli at commit e100db1, republished under its MIT licence (© nesszer). 77 words, ~357 tokens.

Download SKILL.mdSave it as .claude/skills/linear-uploads/SKILL.md (or your agent's skills folder).
name
linear-uploads
description
Download attachments and images from Linear issues. Use when fetching screenshots, images, or file attachments from Linear comments or descriptions.
allowed-tools
Bash, Read

Linear Uploads

Download attachments and images from Linear issues using linear-cli.

Download to File

bash
# Download image/attachment to file
linear-cli up fetch "https://uploads.linear.app/..." -f image.png

# Download to temp directory
linear-cli up fetch "https://uploads.linear.app/..." -f /tmp/screenshot.png

Output to Stdout

bash
# Pipe to other tools
linear-cli up fetch "https://uploads.linear.app/..." | base64

# Redirect to file
linear-cli up fetch "https://uploads.linear.app/..." > file.png

Finding Upload URLs

Upload URLs are found in:

  • Issue descriptions (linear-cli i get LIN-123 --output json)
  • Comments (linear-cli cm list LIN-123 --output json)

URL pattern: https://uploads.linear.app/{org}/{upload}/{filename}

View Images (AI Agents)

Since Claude is multimodal, download then read:

bash
# 1. Download to temp file
linear-cli up fetch "https://uploads.linear.app/..." -f /tmp/screenshot.png

# 2. Use Read tool on the file
# Claude can view images directly

Tips

  • Requires valid LINEAR_API_KEY
  • Use -f / --file to specify output filename
  • Without -f, outputs raw bytes to stdout
  • URLs must be from uploads.linear.app

© nesszer, 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 skills/linear-uploads of nesszer/linear-cli.

Open the folder on GitHubat commit e100db1

Compare with similar skills

Linear Uploads 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 Uploads compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linear Uploads this skillnesszer/linear-cli138—~357Automated safety check: NotesMIT
Orca Linear Ticket Workflowstablyai/orca87k1 repos~522Automated safety check: PassMIT
Review Triage Phaseprisma/orm48k—~995Automated safety check: PassApache-2.0
Commitdinerojs/dinero.js6.8k—~667Automated safety check: PassMIT
Draft Pull Request Creatorwordpress-mobile/WordPress-Android3.2k—~881Automated safety check: NotesGPL-2.0
Linear Tickets via Orcastablyai/orca87k—~558Automated safety check: PassMIT

Similar skills

  • 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
  • Official

    Runs the triage step of the review-framework loop: reads fetched PR review state, builds `review-actions.json`, validates it and renders `review-actions.md`.

    48k GitHub stars~995 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Commit

    dinerojs/dinero.js

    Create a git commit with optional automatic Linear issue linking.

    6.8k GitHub stars~667 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • 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
  • Add Icon Mapping

    lobehub/lobe-icons

    Add or modify icon keyword mappings for providers, models, or agents in lobe-icons.

    2.6k GitHub stars~1.5k tokensUpdated yesterday
    MobileAuto-check: warnings

More from nesszer/linear-cli

All 25 skills in this repo
  • Linear API

    nesszer/linear-cli

    Execute raw GraphQL queries and mutations against the Linear API.

    138 GitHub stars~213 tokensUpdated 24 days ago
    Auto-check: notes
  • Linear Attachments

    nesszer/linear-cli

    Manage issue attachments - link URLs, create, update, delete.

    138 GitHub stars~234 tokensUpdated 24 days ago
    Auto-check: notes
  • Linear Import

    nesszer/linear-cli

    Import issues from CSV or JSON files. An agent skill from nesszer/linear-cli.

    138 GitHub stars~260 tokensUpdated 24 days ago
    Auto-check: notes
  • Linear List

    nesszer/linear-cli

    List and get Linear issues. An agent skill from nesszer/linear-cli.

    138 GitHub stars~208 tokensUpdated 24 days ago
    Auto-check: notes
  • Linear Milestones

    nesszer/linear-cli

    Manage project milestones - create, update, track target dates.

    138 GitHub stars~243 tokensUpdated 24 days ago
    Auto-check: notes
  • Linear PR

    nesszer/linear-cli

    Create GitHub PRs linked to Linear issues. An agent skill from nesszer/linear-cli.

    138 GitHub stars~364 tokensUpdated 24 days ago
    Auto-check: notes

Works with

Questions about Linear Uploads

What does Linear Uploads do?

Download attachments and images from Linear issues. An agent skill from nesszer/linear-cli. Linear Uploads is an agent skill from nesszer/linear-cli. Download attachments and images from Linear issues.

When should I use Linear Uploads?

Linear Uploads fits situations like: fetching screenshots; file attachments from Linear comments.

How do I install Linear Uploads in Claude Code?

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

How do I install Linear Uploads in Codex?

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

Can I use Linear Uploads 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 nesszer/linear-cli --skill linear-uploads -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-uploads, .gemini/skills/linear-uploads, .github/skills/linear-uploads and .opencode/skills/linear-uploads in your project.

What does Linear Uploads need to run?

Going by SKILL.md and its folder, Linear Uploads needs credentials named LINEAR_API_KEY. Our summary lists: A credential in LINEAR_API_KEY. Its frontmatter pre-approves these tools: Bash, Read.

Does Linear Uploads 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 Uploads safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Linear Uploads use?

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

About 357 tokens (SKILL.md is roughly 1.4k 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 Uploads?

Skills that share tags, products or a category with Linear Uploads: Orca Linear Ticket Workflow (stablyai/orca, 87k stars), Review Triage Phase (prisma/orm, 48k stars), Commit (dinerojs/dinero.js, 6.8k stars) and Draft Pull Request Creator (wordpress-mobile/WordPress-Android, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear Uploads?

nesszer (a GitHub organization) maintains it in nesszer/linear-cli, which has 138 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on September 13, 2026.

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