linear

Purpose

This skill enables the AI to interact with Linear's API for issue tracking, cycle management, project roadmaps, Git integrations, SLA monitoring, and API-driven workflows, specifically for engineering teams.

When to Use

Use this skill when automating engineering workflows, such as creating issues from code changes, updating project roadmaps, tracking SLAs for tickets, or syncing Git commits with Linear issues. Apply it in scenarios involving team collaboration, like querying issues during sprint planning or integrating with CI/CD pipelines.

Key Capabilities

• Issue Management: Create, update, and query issues using Linear's GraphQL API at https://api.linear.app/graphql.
• Cycle and Project Handling: Manage cycles via mutations like cycleCreate and projects with queries for roadmaps.
• Git Integration: Link Git commits to issues using webhooks or API; for example, associate a commit SHA with an issue ID.
• SLA Tracking: Monitor service level agreements by querying issue states and timestamps.
• API Access: Authenticate with a personal API key and perform operations like fetching issues with filters (e.g., state: "todo").
• Config Formats: Store API keys in environment variables like $LINEAR_API_KEY; use JSON for payload structures in requests.

Usage Patterns

To accomplish tasks, always authenticate first by setting $LINEAR_API_KEY in your environment. For querying data, use GraphQL queries; for mutations, provide input objects. Pattern for issue creation: Authenticate → Prepare mutation payload → Send request → Handle response. For integrations, combine with Git tools by parsing commit messages and mapping to Linear issues. Always validate inputs, like ensuring issue titles are under 255 characters, before sending requests.