linear
Manage Linear issues, projects, and cycles via the Linear GraphQL API
Install / Use
npx skills add taracodlabs/aiden --skill linearInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Project & Program ManagementSupported Platforms
Our assessment of linear
linear scores 85/100 on our quality scale, 41st of 82 Project & Program Management skills we index (top 50%).
Its SKILL.md is 3.9 KB long, well organised into 14 sections with 7 code examples: a solid amount of guidance for an agent.
It has 843 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so linear is actively maintained.
- Our last check on 2026-11-05 found the source still online.
- It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
linear compared with similar skills
All 4 of these similar skills score higher than linear; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| linear (this skill)by taracodlabs | 85 | 843 | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.9k | today | MCP Server |
| crawl4aiby unclecode | 100 | 87.5k | today | MCP Server |
Frequently asked questions
- How do I install linear?
- Run
npx skills add taracodlabs/aiden --skill linear. The install tabs above show the steps for each supported agent. - Which AI agents does linear work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is linear safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is linear still maintained?
- The repository was last updated about 2 months ago, so linear is actively maintained.
Skill content
View source on GitHubname: linear description: Manage Linear issues, projects, and cycles via the Linear GraphQL API category: productivity version: 1.0.0 origin: aiden license: Apache-2.0 tags: linear, issues, project-management, graphql, engineering, sprint, cycle, team, tasks
Linear Issue Tracking
Query and mutate Linear data — issues, projects, cycles, and teams — using the Linear GraphQL API. Requires LINEAR_API_KEY set as an environment variable.
When to Use
- User wants to list open issues in a Linear team or project
- User wants to create a new Linear issue
- User wants to update issue status or priority
- User wants to see issues assigned to them
- User wants to look up current cycle/sprint progress
How to Use
1. Set API key
Generate a Personal API key at https://linear.app/settings/api — select read and write scopes.
$env:LINEAR_API_KEY = "lin_api_..."
2. Run a GraphQL query helper
All Linear API calls are POST to https://api.linear.app/graphql.
function Invoke-Linear($query, $variables = @{}) {
$body = @{ query = $query; variables = $variables } | ConvertTo-Json -Depth 10
$headers = @{ "Authorization" = $env:LINEAR_API_KEY; "Content-Type" = "application/json" }
(Invoke-RestMethod -Uri "https://api.linear.app/graphql" -Method Post -Headers $headers -Body $body).data
}
3. List my assigned issues
$q = '{ viewer { assignedIssues(first: 20, filter: { state: { type: { in: ["started","unstarted"] } } }) { nodes { identifier title priority state { name } } } } }'
(Invoke-Linear $q).viewer.assignedIssues.nodes | Format-Table identifier, title, priority
4. List issues in a team
$q = 'query($key:String!) { team(key:$key) { issues(first:30, filter:{state:{type:{in:["started","unstarted"]}}}) { nodes { identifier title assignee { name } state { name } } } } }'
(Invoke-Linear $q @{ key = "ENG" }).team.issues.nodes | Format-Table identifier, title
5. Create a new issue
# First get teamId
$teamQ = '{ teams { nodes { id key name } } }'
$teams = (Invoke-Linear $teamQ).teams.nodes
$teamId = ($teams | Where-Object key -eq "ENG").id
$mutation = 'mutation($input:IssueCreateInput!) { issueCreate(input:$input) { issue { identifier title url } } }'
$vars = @{ input = @{ teamId = $teamId; title = "Fix login timeout bug"; description = "Users are being logged out after 5 min of inactivity."; priority = 2 } }
(Invoke-Linear $mutation $vars).issueCreate.issue
6. Update issue state
# Get state IDs for the team first
$stateQ = 'query($key:String!) { team(key:$key) { states { nodes { id name } } } }'
$states = (Invoke-Linear $stateQ @{ key = "ENG" }).team.states.nodes
$doneId = ($states | Where-Object name -eq "Done").id
$mutation = 'mutation($id:String! $stateId:String!) { issueUpdate(id:$id input:{stateId:$stateId}) { issue { identifier state { name } } } }'
(Invoke-Linear $mutation @{ id = "ENG-42"; stateId = $doneId }).issueUpdate.issue
7. List current cycle
$q = 'query($key:String!) { team(key:$key) { activeCycle { name startsAt endsAt progress issues(first:50) { nodes { identifier title state { name } } } } } }'
(Invoke-Linear $q @{ key = "ENG" }).team.activeCycle | Select-Object name, progress
Examples
"Show me all my open Linear issues" → Use steps 2–3 to list viewer's assigned unstarted/in-progress issues.
"Create a Linear issue: 'Update onboarding flow' in the PRODUCT team" → Use step 5 — fetch team ID for PRODUCT, then create with given title.
"What's the progress on the current sprint?" → Use step 7 — ask user for their team key, then show activeCycle progress.
Cautions
- Linear API keys are personal — they act as the user who created them
- Priority values: 0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low
- Issue IDs look like
ENG-42but mutations need the UUID — always fetch UUID from the issues list - GraphQL depth limit is ~6 levels — avoid deeply nested queries
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.9k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.5kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
