Linear Git

What it does

This skill, Linear Git, automates workflows based on the Linear project management system and integrates with Git repositories. It allows an AI agent to create branches linked to Linear issues, generate pull requests from those issues, and display commit information including Linear issue references. The tool leverages the linear-cli command-line interface to streamline common tasks within a linear Git workflow like GitLab Flow.

When to use it

• When you need to quickly create a new branch associated with a specific Linear issue (e.g., "LIN-123").
• To automatically generate a pull request from a Linear issue, simplifying the code review process.
• For displaying commit history and ensuring commits are properly linked to Linear issues.
• When you want to create a draft pull request for early feedback.

Key capabilities

• Branch creation: Creates new Git branches associated with Linear issues (e.g., linear-cli g checkout LIN-123).
• Pull Request generation: Generates GitHub pull requests directly from Linear issues (e.g., linear-cli g pr LIN-123).
• Base branch specification: Allows specifying the base branch for pull request creation (e.g., linear-cli g pr LIN-123 --base main).
• Context awareness: Retrieves information about the Linear issue associated with the current Git branch (linear-cli context).
• Commit display: Shows commit history, including Linear issue references (e.g., linear-cli g commits).

Example prompts

• "Create a branch for Linear issue LIN-123."
• "Generate a pull request from Linear issue LIN-123 and make it a draft."
• "Show me the commit history with Linear issue references."

Tips & gotchas

• This skill relies on the linear-cli command-line tool being properly configured and authenticated.
• The base branch for pull requests can be explicitly specified using the --base flag.
• Output can be formatted as JSON using the --output json flag for programmatic use.