Agent skill
linear
Linear issue tracker API integration
Install this agent skill to your Project
npx add-skill https://github.com/nearai/ironclaw/tree/staging/skills/linear
SKILL.md
Linear API Skill
You have access to the Linear GraphQL API via the http tool. Credentials are automatically injected — never construct Authorization headers manually. When the URL host is api.linear.app, the system injects Authorization: Bearer {linear_api_key} transparently.
API Patterns
Linear uses a single GraphQL endpoint: https://api.linear.app/graphql
All requests are POST with a JSON body containing query and optional variables.
List Issues
http(method="POST", url="https://api.linear.app/graphql", body={"query": "{ issues(first: 20, orderBy: updatedAt) { nodes { id identifier title state { name } assignee { name } priority priorityLabel createdAt } } }"})
Get Issue by Identifier
http(method="POST", url="https://api.linear.app/graphql", body={"query": "query($id: String!) { issue(id: $id) { id identifier title description state { name } assignee { name } labels { nodes { name } } comments { nodes { body user { name } createdAt } } } }", "variables": {"id": "ISSUE_ID"}})
Search Issues
http(method="POST", url="https://api.linear.app/graphql", body={"query": "query($term: String!) { issueSearch(query: $term, first: 10) { nodes { id identifier title state { name } priorityLabel } } }", "variables": {"term": "SEARCH_TERM"}})
Create Issue
http(method="POST", url="https://api.linear.app/graphql", body={"query": "mutation($input: IssueCreateInput!) { issueCreate(input: $input) { success issue { id identifier title url } } }", "variables": {"input": {"title": "...", "description": "...", "teamId": "TEAM_ID", "priority": 2}}})
List Teams (to get teamId for issue creation)
http(method="POST", url="https://api.linear.app/graphql", body={"query": "{ teams { nodes { id name key } } }"})
Update Issue State
http(method="POST", url="https://api.linear.app/graphql", body={"query": "mutation($id: String!, $stateId: String!) { issueUpdate(id: $id, input: { stateId: $stateId }) { success issue { id identifier title state { name } } } }", "variables": {"id": "ISSUE_UUID", "stateId": "STATE_UUID"}})
Response Handling
- Linear returns
{"data": {...}}on success,{"errors": [...]}on failure. - Issue identifiers look like
ENG-123(team key + number). - Always check for
errorsin the response before processingdata. - GraphQL errors include a
messageand optionalextensionswith error codes.
Common Mistakes
- Do NOT add an
Authorizationheader — it is injected automatically. - Always use
POSTmethod — Linear's API is GraphQL only. - The
idfield is a UUID, theidentifierfield is human-readable (e.g.,ENG-42). - Use
issueSearchfor text search, notissueswith a filter (text search is separate). - When creating issues, you MUST provide
teamId. List teams first if unknown.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
nearai/ironclaw
mintlify
Build and maintain documentation sites with Mintlify. Use when creating docs pages, configuring navigation, adding components, or setting up API references.
nearai/ironclaw
product-prioritization
Product strategy and feature prioritization — score features by user demand evidence, effort (human vs AI-assisted), strategic alignment, and market signal. Anti-sycophantic forcing questions to cut through opinion.
nearai/ironclaw
qa-review
QA review for code changes — test coverage analysis, edge case identification, test plan generation, regression detection, test health tracking over time.
nearai/ironclaw
commit
Generate git commit messages from staged changes
nearai/ironclaw
content-creator-assistant
Commitment tracking tuned for content creators — content pipeline stages, trend expiration, cross-platform cascades, heavy idea parking.
nearai/ironclaw
trader-assistant
Commitment tracking tuned for financial traders — real-time alerts, position-aware relevance, decision journaling with outcome tracking.
Didn't find tool you were looking for?