modules/home/programs/cli-agents/shared/skills/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
development
Emulates not-matthias's technical blog writing style. Use when writing blog posts, technical articles, README content, or any long-form technical prose. Produces investigation-driven, first-person narratives with dry humor, practical code examples, and concrete takeaways.
development
Create and manage Git worktrees for parallel feature development. Use when user wants to work on multiple features simultaneously or needs isolated development environments.
development
Systematic technical research and brainstorming. Given a question, recursively explores attached specifications, source code, documentation, GitHub repositories, and authoritative online sources to build comprehensive, accurate answers. Surfaces edge cases, caveats, and implementation details that matter.
development
Converts a research paper (PDF path, uploaded PDF, or URL) into a reusable skill that stores distilled knowledge for future sessions. Use when a user asks to "turn this paper into a skill", "make this PDF reusable", "encode this research", or wants project-specific decisions backed by a specific paper without re-uploading it.