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 CLI

by letta-ai in letta-ai/skills

Manage Linear issues from the command line using the linear cli.

ISCAuto-check passedBackend & APIs

Install Linear CLI

skills CLI
$ npx skills add letta-ai/skills --skill linear-cli -a claude-code

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

GitHub CLI
$ gh skill install letta-ai/skills linear-cli --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/letta-ai/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tools/linear .claude/skills/linear-cli && 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-cli
GitHub stars
147
Used in
1 other repo
Token cost
~1.1k tokens
SKILL.md length
258 words
Files
4 (incl. assets)
Skills in repo
22
Repo updated
First seen
Licence
ISC

At a glance

Manage Linear issues from the command line using the linear cli.

  • Tasks that involve GraphQL
  • SKILL.md covers Prerequisites, Best Practices for Markdown…, Available Commands and Discovering Options, plus 1 more section
  • Calls jq and curl; reaches api.linear.app

What it does

Linear CLI is an agent skill from letta-ai/skills. Manage Linear issues from the command line using the linear cli. This skill allows automating linear management.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including assets.

It sits in Backend & APIs, covering GraphQL. It works with Linear and GraphQL. The repository describes itself as: A shared repository for skills. Intended to be used with Letta Code, Claude Code, Codex CLI, and other agents that support skills. The licence is ISC.

When your agent uses it

  • Tasks that involve GraphQL

Example prompts

  • “/linear-cli”

What it can do on your machine

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

    • jq
    • curl

    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:

    • api.linear.app

    Also links to:

    • github.com

    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 CLI loads about 1.1k tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 258 words of instructions outside code blocks.

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

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 letta-ai/skills at commit 6785511, republished under its ISC licence (© letta-ai). 258 words, ~1,082 tokens.

Download SKILL.mdSave it as .claude/skills/linear-cli/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
linear-cli
description
Manage Linear issues from the command line using the linear cli. This skill allows automating linear management.

Linear CLI

A CLI to manage Linear issues from the command line, with git and jj integration.

Prerequisites

The linear command must be available on PATH. To check:

bash
linear --version

If not installed, follow the instructions at: https://github.com/schpet/linear-cli?tab=readme-ov-file#install

Best Practices for Markdown Content

When working with issue descriptions or comment bodies that contain markdown, always prefer using file-based flags instead of passing content as command-line arguments:

  • Use --description-file for issue create and issue update commands
  • Use --body-file for comment add and comment update commands

Why use file-based flags:

  • Ensures proper formatting in the Linear web UI
  • Avoids shell escaping issues with newlines and special characters
  • Prevents literal \n sequences from appearing in markdown
  • Makes it easier to work with multi-line content

Example workflow:

bash
# Write markdown to a temporary file
cat > /tmp/description.md <<'EOF'
## Summary

- First item
- Second item

## Details

This is a detailed description with proper formatting.
EOF

# Create issue using the file
linear issue create --title "My Issue" --description-file /tmp/description.md

# Or for comments
linear issue comment add ENG-123 --body-file /tmp/comment.md

Only use inline flags (--description, --body) for simple, single-line content.

Available Commands

linear auth               # Manage Linear authentication
linear issue              # Manage Linear issues
linear team               # Manage Linear teams
linear project            # Manage Linear projects
linear project-update     # Manage project status updates
linear cycle              # Manage Linear team cycles
linear milestone          # Manage Linear project milestones
linear initiative         # Manage Linear initiatives
linear initiative-update  # Manage initiative status updates (timeline posts)
linear label              # Manage Linear issue labels
linear document           # Manage Linear documents
linear config             # Interactively generate .linear.toml configuration
linear schema             # Print the GraphQL schema to stdout
linear api                # Make a raw GraphQL API request

Discovering Options

To see available subcommands and flags, run --help on any command:

bash
linear --help
linear issue --help
linear issue list --help
linear issue create --help

Each command has detailed help output describing all available flags and options.

Using the Linear GraphQL API Directly

Prefer the CLI for all supported operations. The api command should only be used as a fallback for queries not covered by the CLI.

Check the schema for available types and fields

Write the schema to a tempfile, then search it:

bash
linear schema -o "${TMPDIR:-/tmp}/linear-schema.graphql"
grep -i "cycle" "${TMPDIR:-/tmp}/linear-schema.graphql"
grep -A 30 "^type Issue " "${TMPDIR:-/tmp}/linear-schema.graphql"
Make a GraphQL request

Important: GraphQL queries containing non-null type markers (e.g. String followed by an exclamation mark) must be passed via heredoc stdin to avoid escaping issues. Simple queries without those markers can be passed inline.

bash
# Simple query (no type markers, so inline is fine)
linear api '{ viewer { id name email } }'

# Query with variables — use heredoc to avoid escaping issues
linear api --variable teamId=abc123 <<'GRAPHQL'
query($teamId: String!) { team(id: $teamId) { name } }
GRAPHQL

# Search issues by text
linear api --variable term=onboarding <<'GRAPHQL'
query($term: String!) { searchIssues(term: $term, first: 20) { nodes { identifier title state { name } } } }
GRAPHQL

# Pipe to jq for filtering
linear api '{ issues(first: 5) { nodes { identifier title } } }' | jq '.data.issues.nodes[].title'
Advanced: Using curl directly

For cases where you need full HTTP control, use linear auth token:

bash
curl -s -X POST https://api.linear.app/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: $(linear auth token)" \
  -d '{"query": "{ viewer { id } }"}'

© letta-ai, ISC. 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 3 other files (assets) in tools/linear of letta-ai/skills.

  • SKILL.md
  • LICENSE
  • assets/linear-small.svg
  • assets/linear.png

Open the folder on GitHubat commit 6785511

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in letta-ai/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Linear CLI 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 CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linear CLI this skillletta-ai/skills1471 repos~1.1kAutomated safety check: PassISC
Linearletta-ai/lettabot326—~583Automated safety check: PassApache-2.0
Linear APInesszer/linear-cli138—~213Automated safety check: NotesMIT
Linearteam-mirai/mirai-gikai212—~1.9kAutomated safety check: PassAGPL-3.0
LinearRedWoodOG/Hermes-Desktop1772 repos~2.8kAutomated safety check: PassMIT
Lineartaracodlabs/aiden849—~1kAutomated safety check: PassApache-2.0

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 API

    nesszer/linear-cli

    Execute raw GraphQL queries and mutations against the Linear API.

    138 GitHub stars~213 tokensUpdated 24 days ago
    Backend & APIsAuto-check: notes

  • Linear

    team-mirai/mirai-gikai

    Linear と対話するためのスキル。Linear MCP サーバー（mcplinear ツール）を 優先的に使用し、MCP でカバーされない生の GraphQL 操作（イントロスペクション、 ファイルアップロードなど）は lineargraphql クライアントツールにフォールバックする。

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

  • Linear

    RedWoodOG/Hermes-Desktop

    Manage Linear issues, projects, and teams via the GraphQL API.

    177 GitHub starsUsed in 2 repos~2.8k tokens
    Backend & APIsAuto-check passed

  • Linear

    taracodlabs/aiden

    Manage Linear issues, projects, and cycles via the Linear GraphQL API

    849 GitHub stars~1k tokensUpdated 24 days 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 yesterday
    Backend & APIsAuto-check passed

More from letta-ai/skills

All 22 skills in this repo

  • Visual Identity

    letta-ai/skills

    Build and maintain a persistent visual identity for your agent using Flux Kontext Pro.

    147 GitHub stars~2.6k tokensUpdated 6 days ago
    Auto-check passed

  • AI News

    letta-ai/skills

    Fetch and summarize recent AI news from curated RSS feeds (Hugging Face, VentureBeat, The Verge, OpenAI, Anthropic, DeepMind, etc.) and YouTube channels (Yannic Kilcher, Two Minute Papers, AI…

    147 GitHub stars~582 tokensUpdated 6 days ago
    Auto-check passed

  • Creating Letta Code Channels

    letta-ai/skills

    Builds and debugs Letta Code channels, including first-party channel adapters and dynamic user channel plugins under ~/.letta/channels.

    147 GitHub stars~1.1k tokensUpdated 6 days ago
    Auto-check passed

  • Letta Configuration

    letta-ai/skills

    Configure LLM models and providers for Letta agents and servers.

    147 GitHub stars~1.3k tokensUpdated 6 days ago
    Auto-check: notes

  • Letta Filesystem To Memfs

    letta-ai/skills

    Migrates deprecated Letta Filesystem folders/files to MemFS using markdown document corpora, chunking, local lexical search, and QMD semantic search via the memfs-search skill.

    147 GitHub stars~1.3k tokensUpdated 6 days ago
    Auto-check passed

  • Memfs Search

    letta-ai/skills

    Semantic search over agent memory files. An agent skill from letta-ai/skills.

    147 GitHub stars~901 tokensUpdated 6 days ago
    Auto-check passed

Works with

Categories

Questions about Linear CLI

What does Linear CLI do?

Manage Linear issues from the command line using the linear cli. Linear CLI is an agent skill from letta-ai/skills. Manage Linear issues from the command line using the linear cli.

When should I use Linear CLI?

Linear CLI fits situations like: tasks that involve GraphQL.

How do I install Linear CLI in Claude Code?

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

How do I install Linear CLI in Codex?

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

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

What does Linear CLI need to run?

Going by SKILL.md and its folder, Linear CLI needs the command-line tools its instructions call (jq and curl).

Does Linear CLI access the network?

SKILL.md names 2 domains. In commands or code: api.linear.app; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

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

Linear CLI is published under the ISC licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Linear CLI use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 CLI?

Skills that share tags, products or a category with Linear CLI: Linear (letta-ai/lettabot, 326 stars), Linear API (nesszer/linear-cli, 138 stars), Linear (team-mirai/mirai-gikai, 212 stars) and Linear (RedWoodOG/Hermes-Desktop, 177 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear CLI?

letta-ai (a GitHub organization) maintains it in letta-ai/skills, which has 147 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 1, 2026.

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