linear-skill_skill

Overview

This skill lets you read, search, and manage Linear issues, projects, teams, and cycles from the command line. It streamlines daily standup prep, sprint checks, ticket creation, and board grooming. Setup is quick: create a Linear personal API key and save it to the local config file. Commands return JSON for easy automation and integration.

How this skill works

The skill calls the Linear API using a personal API key stored in a local config file to list teams, fetch issues, view cycle progress, search, create, update, and reorder issues. All outputs are JSON objects including identifier, title, status, priority, assignee, cycle, labels, and estimates. Operations support filters (status, priority, limit) and accept team keys or names and issue identifiers. No external Python packages are required; the tool uses the standard library.

When to use it

• Prepare for daily standups by listing issues assigned to you or your team.
• Check current sprint (cycle) progress and capacity for planning or retrospectives.
• Search for specific bugs, features, or tasks across projects and teams.
• Create or update issues quickly from scripts or terminal during triage.
• Reorder backlog or in-progress lanes when grooming boards.

Best practices

• Store the personal API key in the local config file and grant minimum permissions (Read or Read+Write as needed).
• Use team keys (e.g., ENG, EPO) for consistent filtering and faster lookups.
• Filter by status and priority to reduce noise when preparing standups or planning.
• Use the JSON output to integrate with CI scripts, automation, or dashboards.
• Revoke or rotate the API key from Linear settings if the key is exposed or when access is no longer needed.

Example use cases

• Morning standup: python3 linear_skill.py my-issues --status in_progress to list current work.
• Sprint check: python3 linear_skill.py cycle EPO to view active sprint progress and velocity indicators.
• Find work: python3 linear_skill.py search "authentication bug" to locate relevant tickets and context.
• Create a quick ticket: python3 linear_skill.py create EPO --title "Fix login timeout" --priority high.
• Board grooming: python3 linear_skill.py reorder EPO-485 EPO-480 EPO-397 to set priority order in a lane.