Agent skill

Linear Project Updates

by nesszer in nesszer/linear-cli

Manage project status updates - create, list, archive. An agent skill from nesszer/linear-cli.

MITAuto-check: notes

Install Linear Project Updates

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

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

GitHub CLI
$ gh skill install nesszer/linear-cli linear-project-updates --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-project-updates .claude/skills/linear-project-updates && 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-project-updates
GitHub stars
138
Token cost
~276 tokens
SKILL.md length
48 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Manage project status updates - create, list, archive. An agent skill from nesszer/linear-cli.

  • Viewing project health updates
  • SKILL.md covers Health Status, Flags and Exit Codes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Linear Project Updates is an agent skill from nesszer/linear-cli. Manage project status updates - create, list, archive. Use when posting or viewing project health updates.

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

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

When your agent uses it

  • Viewing project health updates

Example prompts

  • “/linear-project-updates”

Requirements

  • Pre-approved tools (allowed-tools): Bash

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

    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

    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 Project Updates loads about 276 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 48 words of instructions outside code blocks.

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

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

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). 48 words, ~276 tokens.

Download SKILL.mdSave it as .claude/skills/linear-project-updates/SKILL.md (or your agent's skills folder).
name
linear-project-updates
description
Manage project status updates - create, list, archive. Use when posting or viewing project health updates.
allowed-tools
Bash

Project Updates

bash
# List updates for a project
linear-cli pu list "My Project"
linear-cli pu list "My Project" --output json

# Get update details
linear-cli pu get UPDATE_ID

# Create a project update
linear-cli pu create "My Project" -b "On track this sprint"
linear-cli pu create "My Project" -b "Blocked on API" --health atRisk

# Update an existing update
linear-cli pu update UPDATE_ID -b "Updated status"

# Archive/unarchive
linear-cli pu archive UPDATE_ID
linear-cli pu unarchive UPDATE_ID

Health Status

ValueMeaning
onTrackProject is on track (green)
atRiskProject is at risk (yellow)
offTrackProject is off track (red)

Flags

FlagPurpose
-b BODYUpdate body text
--health STATUSHealth status
--output jsonJSON output

Exit Codes

0=Success, 1=Error, 2=Not found, 3=Auth error

© 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-project-updates of nesszer/linear-cli.

Open the folder on GitHubat commit e100db1

Compare with similar skills

Linear Project Updates 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 Project Updates compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linear Project Updates this skillnesszer/linear-cli138—~276Automated safety check: NotesMIT
Linearasgeirtj/system_prompts_leaks69k—~653Automated safety check: PassCC0-1.0
Linearyc-software/qm15k—~886Automated safety check: PassMIT
Linear Issue Workflowlobehub/lobehub83k—~1.5kAutomated safety check: PassCustom licence
UI Updatesickn33/agentic-awesome-skills47k1 repos~1.4kAutomated safety check: PassMIT
Update Specificationgithub/awesome-copilot40k2 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Linear

    asgeirtj/system_prompts_leaks

    Read and manage software issues, tickets, projects, and planning data in Linear.

    69k GitHub stars~653 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Linear

    yc-software/qm

    Search, read, create, and update the user's Linear issues, projects, and comments through per-user OAuth.

    15k GitHub stars~886 tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • 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
  • UI Update

    sickn33/agentic-awesome-skills

    Update StyleSeed engine in your project — analyzes what's outdated and updates safely

    47k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Update Specification

    github/awesome-copilot

    Official

    Update an existing specification file for the solution, optimized for Generative AI consumption based on new requirements or updates to any existing code.

    40k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • Update

    Q00/ouroboros

    Check for updates and upgrade Ouroboros to the latest version

    6.2k GitHub stars~1.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

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

Questions about Linear Project Updates

What does Linear Project Updates do?

Manage project status updates - create, list, archive. An agent skill from nesszer/linear-cli. Linear Project Updates is an agent skill from nesszer/linear-cli. Manage project status updates - create, list, archive.

When should I use Linear Project Updates?

Linear Project Updates fits situations like: viewing project health updates.

How do I install Linear Project Updates in Claude Code?

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

How do I install Linear Project Updates in Codex?

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

Can I use Linear Project Updates 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-project-updates -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-project-updates, .gemini/skills/linear-project-updates, .github/skills/linear-project-updates and .opencode/skills/linear-project-updates in your project.

What does Linear Project Updates need to run?

SKILL.md names no scripts, command-line tools or credentials: Linear Project Updates is instructions for the agent only. Its frontmatter pre-approves these tools: Bash.

Does Linear Project Updates 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 Project Updates 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 Project Updates use?

Linear Project Updates 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 Project Updates use?

About 276 tokens (SKILL.md is roughly 1.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 Project Updates?

Skills that share tags, products or a category with Linear Project Updates: Linear (asgeirtj/system_prompts_leaks, 69k stars), Linear (yc-software/qm, 15k stars), Linear Issue Workflow (lobehub/lobehub, 83k stars) and UI Update (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear Project Updates?

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.