modules/home/programs/cli-agents/shared/skills/cli-tools/linear-cli/SKILL.md
Use when working with the Linear CLI (`linear`) to browse and manage issues, projects, teams, cycles, labels, documents, and GraphQL queries.
npx skillsauth add not-matthias/dotfiles-nix linear-cliInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill when the user asks to use or debug the linear command-line tool.
Assume authentication is already configured.
linear --version
linear --help
List your issues with filters:
linear issue list --all-states --team <TEAM_KEY> --project <PROJECT_NAME> --limit 50
linear issue list --state started --state unstarted --label bug --updated-after 2026-01-01
View one issue (text or JSON):
linear issue view <ISSUE_ID>
linear issue view <ISSUE_ID> --json --no-comments
Structured issue queries:
linear issue query --help
linear project list --all-teams
linear project list --team <TEAM_KEY> --status "In Progress" --json
linear project view <PROJECT_ID>
linear team list
linear team members <TEAM_KEY>
linear cycle list --team <TEAM_KEY>
linear cycle view <CYCLE_REF>
linear label list --all
linear label list --team <TEAM_KEY> --json
linear document list --project <PROJECT_NAME> --limit 50
linear document list --issue <TEAM-123> --json
linear document view <DOCUMENT_ID>
linear issue view <ISSUE_ID> --web
linear project list --app
linear team list --web
Inline query:
linear api 'query { viewer { id name email } }'
With variables and pagination:
linear api 'query($first:Int!,$after:String){ issues(first:$first, after:$after){ nodes { identifier title } pageInfo { hasNextPage endCursor } } }' \
--variable first=50 \
--paginate
linear issue --help
linear project --help
linear team --help
linear cycle --help
linear label --help
linear document --help
linear api --help
documentation
Save notes, journal entries, and research to the personal-notes Obsidian vault (personal-vault-v2). Use when the user asks to 'save note', 'save to notes', 'write to personal notes', 'save to daily notes', 'note this down', or wants to persist findings/analysis to their personal vault.
documentation
Use whenever the user asks to address, fix, resolve, review, or respond to pull-request comments or review feedback.
development
Apply Not Matthias's Rust-first personal coding style. Use whenever the user explicitly asks to apply or review their code style, make Rust match their preferences, perform a style pass, or simplify/refactor according to their conventions. Inspect only task-touched code, honor local project conventions first, and make only safe opt-out style edits.
development
Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search codebases using Abstract Syntax Tree (AST) patterns, find specific code structures, or perform complex code queries that go beyond simple text search. This skill should be used when users ask to search for code patterns, find specific language constructs, or locate code with particular structural characteristics.