Linear Agent
Skill by clawdbotworker
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/clawdbotworker/linear-agentWhat This Skill Does
The Linear Agent is a powerful integration for OpenClaw that enables direct, native communication with the Linear GraphQL API. Unlike simplistic shell-script wrappers, this tool provides a robust interface for managing your entire project lifecycle directly from your terminal or AI agent. It allows for the creation and mutation of issues, seamless transitions of issue states using human-readable names, and sophisticated backlog summarization. By automating the sync between git commits and project states, it ensures that your project documentation stays perfectly aligned with your technical contributions without requiring manual updates.
Installation
To integrate the Linear Agent into your workflow, ensure you have your Linear API key ready. Navigate to your Linear workspace settings under 'Security & Access' and generate a new API key. Once obtained, set this as an environment variable in your terminal session or your .env file: LINEAR_API_KEY=lin_api_yourkey. After the environment is configured, use the OpenClaw installation command: clawhub install openclaw/skills/skills/clawdbotworker/linear-agent. The skill is designed with zero external dependencies, ensuring a lightweight and secure installation process.
Use Cases
This skill is ideal for engineering teams who wish to reduce context switching between their code editors and project management tools. It is particularly effective for automating daily stand-ups by generating natural language summaries of the current team backlog. It also shines in CI/CD pipelines where commit messages can automatically trigger issue state updates, such as moving a ticket to 'In Review' or 'Done' upon merging a pull request. Project managers can also use it to perform bulk updates or coordinate complex cycles across multiple teams efficiently.
Example Prompts
- "Summarize the current backlog for the ENG team and highlight any high-priority issues that haven't been touched in three days."
- "Create a new issue titled 'Refactor Auth Middleware' in the ENG team with the priority set to high and assign it to the current user."
- "Find the issue related to ENG-124 and move it to the 'Done' column, then add a comment saying 'Refactor complete and verified in staging'."
Tips & Limitations
Note that this is a community-supported skill and is not maintained by Linear, Inc. Use caution when granting API access in shared environments. Always ensure that your Linear API key is scoped correctly within the Linear dashboard to follow the principle of least privilege. When using the CLI, ensure you specify the correct team ID (e.g., 'ENG') to avoid accidental mutations in the wrong workspace. For complex automation, rely on the explicit IDs provided by the list commands rather than guessing identifiers.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-clawdbotworker-linear-agent": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api