skills/linear-api/SKILL.md
Execute raw GraphQL queries and mutations against the Linear API. Use for advanced operations not covered by other commands.
npx skillsauth add finesssee/linear-cli linear-apiInstall 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.
# Run a query
linear-cli api query '{ viewer { id name email } }'
# Query with variables
linear-cli api query -v teamId=abc '{ team(id: $teamId) { name } }'
# Run a mutation
linear-cli api mutate -v title="Bug" '
mutation($title: String!) {
issueCreate(input: { title: $title, teamId: "..." }) {
issue { id identifier }
}
}
'
# Pipe query from file
cat query.graphql | linear-cli api query -
| Flag | Purpose |
|------|---------|
| -v key=val | GraphQL variables |
| --output json | JSON output |
| --compact | Compact JSON |
0=Success, 1=Error, 2=Not found, 3=Auth error
tools
Start/stop work on Linear issues. Use when beginning work, creating branches, or getting current issue context.
development
Manage webhooks - create, listen for events, rotate secrets. Use when setting up integrations or event listeners.
tools
Watch Linear issues for changes. Use for monitoring updates.
tools
Manage custom views - create, list, apply saved views. Use when working with saved issue filters.