Linear

What This Skill Does

The Linear skill empowers you to seamlessly manage your team's workflow directly from your chat interface. It provides a powerful command-line interface to interact with Linear, a popular issue tracking and project management tool. You can effortlessly query and update issues, monitor project progress, and gain insights into your team's tasks. The skill facilitates quick issue creation, status updates, assignments, and priority adjustments. It also integrates with GitHub, allowing you to generate branch names based on Linear issues, streamlining your development workflow and enabling automatic status tracking.

Installation

To install the Linear skill, run the following command:

clawhub install openclaw/skills/skills/manuelhettich/linear

Before using the skill, you need to configure your Linear API key. Set the LINEAR_API_KEY environment variable with your personal API key:

export LINEAR_API_KEY="your-api-key"

Optionally, you can set a LINEAR_DEFAULT_TEAM environment variable to specify a default team key, which can simplify commands by allowing you to omit the team key when it's unambiguous:

export LINEAR_DEFAULT_TEAM="TEAM"

You can discover your team keys by running:

{baseDir}/scripts/linear.sh teams

Use Cases

• Morning Standup: Quickly get a summary of your assigned issues, blocked items across the team, recently completed tasks, and items currently in review.
• Quick Issue Creation: Create new Linear issues directly from chat with a title and description.
• Triage and Prioritization: Identify and address urgent or high-priority issues that require immediate attention.
• Project Status Checks: Monitor the progress of projects and get an overview of all issues within a specific team or project.
• Task Management: Assign issues to team members, change their status (e.g., to 'In Progress', 'In Review'), and set priorities.
• GitHub Integration: Streamline your development process by generating appropriate branch names for Linear issues, ensuring automatic status updates in Linear as you work on GitHub.
• Issue Details: Retrieve detailed information about specific Linear issues.

Example Prompts

1. "Show me my assigned issues in Linear."
2. "Create a new Linear issue titled 'Implement user authentication' with the description 'Add secure user login and registration functionality.' for team 'FE'."
3. "What are the urgent issues across the team?"

Tips & Limitations

• API Key Security: Keep your LINEAR_API_KEY secure and do not share it. It grants access to your Linear account.
• Default Team: Setting LINEAR_DEFAULT_TEAM can significantly speed up your workflow if you primarily work with one team.
• GitHub Branching: For the GitHub integration to work seamlessly, always use Linear-derived branch names. Avoid making changes directly on the main branch; use worktrees for issue-specific development.
• Permissions: The commands executed by this skill are subject to the permissions granted by your Linear API key and your role within your Linear workspace.
• Team Keys: Ensure you have the correct team keys when executing commands that require them. Use {baseDir}/scripts/linear.sh teams to list them.
• Description Length: While descriptions can be provided, very long descriptions might be truncated or handled differently depending on the Linear API's limitations.