New: 98,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 letta-ai in letta-ai/lettabot

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

Apache-2.0Auto-check passedBackend & APIs

Install Linear

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

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

GitHub CLI
$ gh skill install letta-ai/lettabot 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/letta-ai/lettabot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.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
326
Token cost
~583 tokens
SKILL.md length
219 words
Files
2 (incl. scripts)
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Works in 4 steps: List triage issues: list --state "Triage" → Review each issue, decide priority → Update priority and move to appropriate… → …
  • The user asks about Linear
  • SKILL.md covers When to Use, Setup, Quick Operations and Triage Workflow, plus 2 more sections
  • Runs TypeScript scripts from its folder; calls npx; needs LINEAR_API_KEY

What it does

Linear is an agent skill from letta-ai/lettabot. Manage Linear issues via GraphQL API. List, filter, update, prioritize, comment, and search issues. Use when the user asks about Linear, issues, project management, or backlog.

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/linear.ts`).

It sits in Backend & APIs, covering GraphQL and Project management. It works with GraphQL and Linear. The repository describes itself as: Archived - has been replaced by Letta Code channels/schedules! The licence is Apache-2.0.

When your agent uses it

  • The user asks about Linear
  • Project management

Example prompts

  • “/linear”

Requirements

  • Node.js
  • A credential in LINEAR_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. List triage issues: list --state "Triage"
  2. Review each issue, decide priority
  3. Update priority and move to appropriate state
  4. Add comments for context if needed

What it can do on your machine

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

    Ships 1 file in scripts/ (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    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 583 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 219 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from letta-ai/lettabot at commit 99c3b5d, republished under its Apache-2.0 licence (© letta-ai). 219 words, ~583 tokens.

Download SKILL.mdSave it as .claude/skills/linear/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
linear
description
Manage Linear issues via GraphQL API. List, filter, update, prioritize, comment, and search issues. Use when the user asks about Linear, issues, project management, or backlog.

Linear

Interact with Linear's GraphQL API to manage issues.

When to Use

  • User asks about Linear issues, tickets, or project management
  • Need to triage, prioritize, or update issue status
  • Want to search or comment on issues
  • Managing a backlog or sprint

Setup

Requires LINEAR_API_KEY environment variable. Get one from Linear Settings > API > Personal API keys.

Quick Operations

List issues by status
bash
npx tsx scripts/linear.ts list --state "Triage"
npx tsx scripts/linear.ts list --state "In Progress"
npx tsx scripts/linear.ts list --state "Backlog"
List issues assigned to someone
bash
npx tsx scripts/linear.ts list --assignee "cameron"
Get issue details
bash
npx tsx scripts/linear.ts get <issue-id>
Update issue priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)
bash
npx tsx scripts/linear.ts update <issue-id> --priority 2
Update issue state
bash
npx tsx scripts/linear.ts update <issue-id> --state "In Progress"
Add comment
bash
npx tsx scripts/linear.ts comment <issue-id> "Your comment here"
Search issues
bash
npx tsx scripts/linear.ts search "search query"

Triage Workflow

  1. List triage issues: list --state "Triage"
  2. Review each issue, decide priority
  3. Update priority and move to appropriate state
  4. Add comments for context if needed

Output Format

All commands output JSON for easy parsing. Use jq for filtering if needed.

Battle-Tested Insights

GraphQL Query Patterns
  • Linear uses GraphQL with nested filtering. State filters need the exact format: state: { name: { eq: "State Name" } }
  • Assignee filters are case-insensitive with containsIgnoreCase
  • When updating state, you need to fetch the state ID first - state names alone won't work in mutations
Common Pitfalls
  • Issue IDs vs Identifiers: The API accepts both UUID-style IDs and human-readable identifiers (e.g., "ENG-123"), but some endpoints prefer one over the other
  • Priority is numeric (0-4), not a string
  • Rate limits are generous but exist - batch operations if doing bulk updates

© letta-ai, Apache-2.0. 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 1 other file (scripts) in .skills/linear of letta-ai/lettabot.

  • SKILL.md
  • scripts/linear.ts

Open the folder on GitHubat commit 99c3b5d

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 skillletta-ai/lettabot326—~583Automated safety check: PassApache-2.0
LinearOpenHands/extensions158—~1.9kAutomated safety check: PassMIT
Linear Expertborghei/Claude-Skills881—~1.9kAutomated safety check: PassMIT
Linear APInesszer/linear-cli138—~213Automated safety check: NotesMIT
Linearteam-mirai/mirai-gikai212—~1.9kAutomated safety check: PassAGPL-3.0
LinearRedWoodOG/Hermes-Desktop1773 repos~2.8kAutomated safety check: PassMIT

Similar skills

  • Linear

    OpenHands/extensions

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

    158 GitHub stars~1.9k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Linear Expert

    borghei/Claude-Skills

    Linear expert for workspace/team admin, Cycles, Projects, Initiatives, Roadmaps, GraphQL API queries, triage workflows, GitHub integration, bulk operations, and Jira-to-Linear migration.

    881 GitHub stars~1.9k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Linear API

    nesszer/linear-cli

    Execute raw GraphQL queries and mutations against the Linear API.

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

  • Linear

    team-mirai/mirai-gikai

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

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

  • Linear

    RedWoodOG/Hermes-Desktop

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

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

  • Linear CLI

    letta-ai/skills

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

    147 GitHub starsUsed in 1 repo~1.1k tokens
    Backend & APIsAuto-check passed

More from letta-ai/lettabot

  • Lettabot

    letta-ai/lettabot

    Set up and run LettaBot - a multi-channel AI assistant for Telegram, Slack, Discord, WhatsApp, and Signal.

    326 GitHub stars~3.4k tokensUpdated 4 mo ago
    Auto-check passed

  • Scheduling

    letta-ai/lettabot

    Create scheduled tasks and one-off reminders. An agent skill from letta-ai/lettabot.

    326 GitHub stars~852 tokensUpdated 4 mo ago
    Auto-check passed

  • Voice Memo

    letta-ai/lettabot

    Reply with voice memos using text-to-speech. An agent skill from letta-ai/lettabot.

    326 GitHub stars~487 tokensUpdated 4 mo ago
    Auto-check passed

  • Bluesky

    letta-ai/lettabot

    Post, reply, like, and repost on Bluesky using the lettabot-bluesky CLI.

    326 GitHub stars~954 tokensUpdated 4 mo ago
    Auto-check passed

  • Cron

    letta-ai/lettabot

    Create and manage scheduled tasks (cron jobs) that send you messages at specified times.

    326 GitHub stars~814 tokensUpdated 4 mo ago
    Auto-check passed

  • Google

    letta-ai/lettabot

    Google Workspace CLI (gog) for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

    326 GitHub stars~774 tokensUpdated 4 mo ago
    Auto-check: notes

Works with

Categories

Questions about Linear

What does Linear do?

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

When should I use Linear?

Linear fits situations like: the user asks about Linear; project management.

How do I install Linear in Claude Code?

Run `npx skills add letta-ai/lettabot --skill linear -a claude-code`. Or copy the skill folder (.skills/linear in letta-ai/lettabot) 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 letta-ai/lettabot --skill linear -a codex`. Or copy the skill folder (.skills/linear in letta-ai/lettabot) 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 letta-ai/lettabot --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 TypeScript for the scripts in its folder, the command-line tools its instructions call (npx) and credentials named LINEAR_API_KEY. Our summary lists: Node.js; A credential in LINEAR_API_KEY.

Does Linear access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Linear use?

Linear is published under the Apache-2.0 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 583 tokens (SKILL.md is roughly 2.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?

Skills that share tags, products or a category with Linear: Linear (OpenHands/extensions, 158 stars), Linear Expert (borghei/Claude-Skills, 881 stars), Linear API (nesszer/linear-cli, 138 stars) and Linear (team-mirai/mirai-gikai, 212 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear?

letta-ai (a GitHub organization) maintains it in letta-ai/lettabot, which has 326 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on May 25, 2026.

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