A robust interface for AI agents to interact with Linear's GraphQL API for issue management and team collaboration.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install linear-graphql-skill
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-graphql-skill 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 GraphQL Skill?
The Linear GraphQL Skill provides a seamless bridge between AI agents and your Linear workspace. By utilizing the uxc tool, this skill allows for complex querying and mutation of Linear data, including issues, projects, and teams. It is a vital component of the Openclaw Skills ecosystem, designed to bring high-level project management capabilities directly into your automated workflows.
This skill supports both Personal API Keys for rapid development and OAuth 2.0 for secure, user-delegated access in production environments. It transforms the way developers interact with Linear by providing a structured, CLI-driven approach to GraphQL operations that is both human-readable and agent-optimized.
Linear GraphQL Skill Use Cases
- Automated creation of issues from bug reports or meeting transcripts.
- Generating automated weekly status updates by querying project and team progress.
- Bulk updating issue states, labels, or assignees based on external triggers.
- Syncing development tasks between different platforms using Openclaw Skills.
How Linear GraphQL Skill Works
- Link the Linear GraphQL endpoint to a local CLI alias (e.g., linear-graphql-cli) using the uxc link command.
- Configure authentication using either a Personal API Key or an OAuth 2.0 flow to establish a secure connection.
- Bind the authenticated credential to the api.linear.app host to ensure all requests are properly authorized.
- Perform discovery of available GraphQL operations using the built-in help flags to inspect schemas and arguments.
- Execute queries or mutations by passing JSON payloads to the CLI, receiving structured data responses for further processing.
Linear GraphQL Skill Setup
First, ensure uxc is installed. Then, link the skill and set up your credentials:
# Create the CLI link
uxc link linear-graphql-cli https://api.linear.app/graphql
# Set your Personal API Key
uxc auth credential set linear-graphql \
--auth-type api_key \
--header "Authorization:{{secret}}" \
--secret "lin_api_YOUR_KEY"
# Bind the credential to the API endpoint
uxc auth binding add \
--id linear-graphql \
--host api.linear.app \
--path-prefix /graphql \
--scheme https \
--credential linear-graphql \
--priority 100
Linear GraphQL Skill Data Schema & Taxonomy
The skill utilizes the Linear GraphQL schema to organize data into logical entities. Below are the primary data categories used by this addition to Openclaw Skills:
| Entity | Common Operations | Description |
|---|---|---|
| Issues | query/issues, mutation/issueCreate | Manage individual tickets, their status, and descriptions. |
| Teams | query/teams, query/team | Access team-specific configurations and member lists. |
| Projects | query/projects | Handle high-level project milestones and roadmaps. |
| Workflow | query/workflowStates | Interact with the custom states defined in your Linear workspace. |
Linear GraphQL Skill Advanced Features
- Custom selection sets using the _select argument to optimize API response payload size.
- Full support for complex mutations including issue archiving and comment creation.
- Integration with uxc daemon for persistent, background credential management and status monitoring.
- Capability to handle multi-turn OAuth login flows within agent-led environments.
- Detailed error recovery and schema introspection to help agents self-correct GraphQL syntax.
SKILL.md
Loading
Related Openclaw Skills
Etherscan MCP Skill
A high-performance interface for onchain investigation, providing deep access to Ethereum blockchain data via the Etherscan MCP.
Dune MCP Skill
A powerful tool for AI agents to discover, query, and visualize blockchain data directly from Dune Analytics.
DeepWiki MCP Skill
A powerful tool to interact with GitHub repository documentation and get AI-grounded answers about codebases.
Context7 MCP Skill
A high-performance bridge for AI agents to query live, version-accurate documentation for virtually any software library.
Notion MCP Skill
A secure interface for AI agents to interact with Notion workspaces using the Model Context Protocol and UXC CLI.
OKX OnchainOS MCP Skill
A comprehensive DeFi automation skill for accessing OKX OnchainOS market data, wallet balances, and DEX swap execution via uxc.
Featured*
