Agent skill

Linear Config

by nesszer in nesszer/linear-cli

Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.

MITAuto-check: notesBackend & APIs

Install Linear Config

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

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

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

At a glance

Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.

  • Backend & APIs work in your project
  • Needs LINEAR_API_KEY

What it does

Linear Config is an agent skill from nesszer/linear-cli. Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.

Its SKILL.md is about 420 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. The repository describes itself as: A powerful CLI for Linear.app built with Rust. The licence is MIT.

When your agent uses it

  • Backend & APIs work in your project

Example prompts

  • “/linear-config”

Requirements

  • A credential in YOUR_API_KEY
  • A credential in LINEAR_API_KEY
  • 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 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 Config loads about 421 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 22 words of instructions outside code blocks.

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

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). 22 words, ~421 tokens.

Download SKILL.mdSave it as .claude/skills/linear-config/SKILL.md (or your agent's skills folder).
name
linear-config
description
Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.
allowed-tools
Bash

Configuration

bash
# First-time setup wizard
linear-cli setup

# Set API key
linear-cli config set-key YOUR_API_KEY

# Show config
linear-cli config show

# Auth commands
linear-cli auth login                # Store API key
linear-cli auth oauth                # OAuth 2.0 browser flow (PKCE)
linear-cli auth oauth --client-id ID # Custom OAuth app
linear-cli auth status               # Check auth status (shows type, expiry)
linear-cli auth revoke               # Revoke OAuth tokens
linear-cli auth logout               # Remove key

# Workspaces
linear-cli config workspace-add work KEY
linear-cli config workspace-list
linear-cli config workspace-switch work
linear-cli config workspace-current

# Profiles
linear-cli --profile work i list     # Use profile

# Diagnostics
linear-cli doctor                    # Check config and connectivity
linear-cli doctor --fix              # Auto-fix common issues

# Shell completions (static)
linear-cli config completions bash > ~/.bash_completion.d/linear-cli

# Shell completions (dynamic, context-aware)
linear-cli completions dynamic bash >> ~/.bashrc
linear-cli completions dynamic zsh >> ~/.zshrc
linear-cli completions dynamic fish >> ~/.config/fish/completions/linear-cli.fish

Environment Variables

VariablePurpose
LINEAR_API_KEYAPI key override
LINEAR_CLI_PROFILEProfile override
LINEAR_CLI_OUTPUTDefault output format
LINEAR_CLI_YESAuto-confirm prompts
LINEAR_CLI_NO_PAGERDisable pager

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

Open the folder on GitHubat commit e100db1

Compare with similar skills

Linear Config 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 Config compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linear Config this skillnesszer/linear-cli138—~421Automated safety check: NotesMIT
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api43k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    43k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-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

Categories

Questions about Linear Config

What does Linear Config do?

Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard. Linear Config is an agent skill from nesszer/linear-cli. Configure linear-cli - auth (API key + OAuth), workspaces, diagnostics, setup wizard.

When should I use Linear Config?

Linear Config fits situations like: backend & APIs work in your project.

How do I install Linear Config in Claude Code?

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

How do I install Linear Config in Codex?

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

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

What does Linear Config need to run?

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

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

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

About 421 tokens (SKILL.md is roughly 1.7k 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 Config?

Skills that share tags, products or a category with Linear Config: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 43k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear Config?

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.