A robust Linear integration for AI agents that enables native GraphQL project management, issue tracking, and automated git-sync functionality.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install linear-agent
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install linear-agent using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is linear-agent?
linear-agent provides a high-performance interface between AI agents and the Linear project management platform. Unlike traditional shell-script alternatives, this tool leverages the native GraphQL API to provide superior control over workspace data, including automatic identifier resolution (e.g., ENG-42) and the ability to move issues by state names. It is a core component for developers looking to expand their Openclaw Skills with deep project management capabilities.
By utilizing this skill, engineering teams can bridge the gap between their development environment and project tracking. It eliminates the friction of manual issue updates by allowing AI agents to summarize backlogs in plain English, manage sprints, and interact with the team via comments, all while maintaining a zero-dependency architecture for maximum security and speed.
linear-agent Use Cases
- Automating issue creation and updates directly from AI-driven development workflows.
- Moving issues through custom workflow states (e.g., In Progress to Review) using natural language or code triggers.
- Generating comprehensive team backlog summaries to keep stakeholders informed without manual reporting.
- Syncing git commit messages like "fixes ENG-42" to automatically update Linear issue statuses.
- Managing complex project cycles and sprints through a programmatic interface.
How linear-agent Works
- The skill establishes a secure connection to the Linear GraphQL API using an environment-stored API key.
- It interprets user or agent requests to resolve identifiers, such as mapping a human-readable team name to its unique internal ID.
- The agent executes specific mutations or queries to create, update, or retrieve project data.
- It processes the raw GraphQL response into structured, actionable information or plain-English summaries.
- In git-sync scenarios, it monitors commit patterns to trigger status updates across the Linear workspace.
linear-agent Setup
To integrate linear-agent with your Openclaw Skills, you must first obtain a Linear API key from your workspace settings under Security & Access.
Set your environment variable:
export LINEAR_API_KEY=lin_api_yourkey
You can then run the skill as a standalone CLI or within an agentic workflow:
node index.js list-teams
node index.js create-issue --title "New Feature" --teamId ENG
node index.js backlog-summary --teamId ENG
linear-agent Data Schema & Taxonomy
The skill interacts with the Linear GraphQL schema, focusing on the following data entities:
| Entity | Description |
|---|---|
| Issues | Primary task objects including titles, descriptions, and state metadata. |
| Teams | Organizational units used to categorize issues and projects. |
| Cycles | Time-boxed sprints used for planning and velocity tracking. |
| States | Workflow stages such as Backlog, Todo, In Progress, and Done. |
| Comments | Threaded communication history associated with specific issue IDs. |
linear-agent Advanced Features
- Native GraphQL API utilization for faster, more reliable data transactions than shell-based alternatives.
- Automatic identifier resolution that allows agents to interact with issues using standard project keys like ENG-42.
- Workflow state mapping that permits moving issues by human-readable names instead of cryptic internal IDs.
- Zero-dependency design ensuring easy integration into various Openclaw Skills environments without bloat.
- Support for git-commit syncing to automate the developer lifecycle from code push to issue closure.
SKILL.md
Loading
Related Openclaw Skills
ElevenLabs Speech-to-Text (STT)
A high-performance transcription skill leveraging ElevenLabs Scribe v2 for accurate audio-to-text conversion with speaker diarization.
ElevenLabs Music Generation
A sophisticated tool for generating complete songs with vocals and lyrics from simple text descriptions using the ElevenLabs Music API.
SuperMemory
An AI-driven memory management skill that enables users to store information, perform semantic searches, and chat with their personal knowledge base via the SuperMemory API.
OnChat Skill
A technical interface for interacting with the OnChat protocol, enabling fully on-chain messaging and channel management on the Base L2 network.
PagerDuty Agent Skill
A powerful AI agent skill for managing PagerDuty incident lifecycles, on-call rotations, and service health directly from your development workflow.
Hybrid Memory System
A sophisticated memory architecture that merges vector-based document retrieval with temporal knowledge graphs for comprehensive AI agent context.
Featured*
