linear

What This Skill Does

The Linear skill provides a robust interface for interacting with your Linear workspace directly through the OpenClaw agent. By leveraging a bundled Node.js CLI that wraps the official Linear SDK, this skill enables seamless management of projects, issues, cycles, and teams. It bridges the gap between your AI agent and your task-tracking infrastructure, allowing for sophisticated project management automation. The skill ensures that all interactions are authenticated via your personal LINEAR_API_KEY, maintaining secure and direct communication with the Linear GraphQL API. Whether you need to triage incoming bug reports, facilitate sprint planning, or maintain documentation, this skill acts as your programmatic assistant for all Linear-related operations.

Installation

To integrate the Linear skill into your environment, follow these steps:

1. Execute the installation command: clawhub install openclaw/skills/skills/matrixy/linear-cli.
2. Navigate to the skill directory: cd {baseDir}/scripts.
3. Install necessary Node.js dependencies by running npm install.
4. Secure your environment by setting the required API key: export LINEAR_API_KEY="your-linear-api-key-here". You can obtain this key from the API section of your Linear workspace settings. Ensure that the key has appropriate permissions for the tasks you intend to automate.

Use Cases

• Automated Triage: Automatically identify high-priority bugs, assign them to team members, and move them into an 'In Progress' state based on agent analysis.
• Sprint Planning: Generate new issue tickets during planning meetings, set priority levels, apply labels, and estimate efforts for a specific sprint cycle.
• Release Management: Track project status, verify blockers, and manage documentation requirements by creating linked tasks and updating milestone records.
• Workflow Cleanup: Search for stale issues or orphaned tasks to keep your project board organized and actionable.

Example Prompts

1. "List all high-priority open issues in the ENG team and summarize their current assignees."
2. "Create a new issue in the backend project titled 'Fix database migration error' with high priority and assign it to Sarah."
3. "Move issue ENG-402 to the 'Completed' state and add a comment that the patch has been verified in staging."

Tips & Limitations

Always verify IDs before performing update mutations. The CLI is designed for programmatic access; therefore, avoid bulk edits without confirming the scope first to prevent unintentional changes. If the API key is missing or dependencies are not installed, the skill will fail safely. Always prioritize reading state before applying modifications to ensure data integrity. Do not share your API key in any shared logs or plain text files.