linear
Linear API integration with managed OAuth. Query and manage issues, projects, teams, cycles, and labels using GraphQL. Use this skill when users want to create, update, or query Linear issues, search for tasks, manage projects, or track work. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/byungkyu/linear-apiWhat This Skill Does
The Linear skill for OpenClaw provides a powerful, GraphQL-based interface for managing your Linear workspace directly from your AI agent. By leveraging the Maton API gateway, this skill abstracts away the complexities of OAuth 2.0 authentication. It enables you to perform complex read and write operations, such as querying existing issues, creating new tasks, managing project status, tracking work cycles, and organizing labels. Whether you are a developer looking to automate ticket creation or a product manager needing to generate status reports from project data, this tool serves as your bridge to the Linear ecosystem.
Installation
To install this skill, run the following command in your terminal:
clawhub install openclaw/skills/skills/byungkyu/linear-api
After installation, ensure you have your Maton API key generated at maton.ai and exported as an environment variable in your shell configuration: export MATON_API_KEY="YOUR_API_KEY". Finally, initialize your OAuth connection by following the steps outlined in the Connection Management section to authorize your agent to access your Linear account.
Use Cases
This skill is perfect for automated project management workflows. Common use cases include:
- Automated Task Creation: Automatically generate Linear issues based on bug reports received via email or Slack.
- Status Reporting: Query the current sprint or cycle to provide a summary of completed and remaining work for team meetings.
- Project Organization: Dynamically assign labels or move tasks between projects based on priority changes.
- Syncing Operations: Keep external databases in sync with Linear by querying issue states through the GraphQL interface.
Example Prompts
- "Query the last five high-priority issues assigned to me in Linear and output their titles and URLs."
- "Create a new issue in the 'Product Engineering' project titled 'Refactor Auth Middleware' with the description 'Needs better error handling' and tag it as a 'bug'."
- "List all active cycles in the workspace and provide a summary of progress for each one."
Tips & Limitations
- Authentication: Always ensure your
MATON_API_KEYis kept secure and never hard-coded in version-controlled scripts. - GraphQL Queries: Since the skill uses GraphQL, you can fetch exactly the data you need by specifying fields. Refer to the official Linear API schema if you need to query custom fields or advanced relationships.
- Error Handling: If requests fail, verify your connection status at
https://ctrl.maton.aito ensure the OAuth token has not expired or been revoked. - Scope: This skill is strictly for Linear. For interactions with other third-party services like GitHub or Jira, please utilize the separate
api-gatewayskill.
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-byungkyu-linear-api": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api
Related Skills
apollo
Apollo.io API integration with managed OAuth. Search and enrich people and companies, manage contacts and accounts. Use this skill when users want to prospect, enrich leads, or manage sales data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
hubspot
HubSpot CRM API integration with managed OAuth. Manage contacts, companies, deals, and associations. Use this skill when users want to create or update CRM records, search contacts, or sync data with HubSpot. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
squareup
Square API integration with managed OAuth. Process payments, manage customers, orders, catalog, inventory, invoices, loyalty programs, team members, and more. Use this skill when users want to accept payments, manage point-of-sale operations, track inventory, handle invoicing, manage loyalty programs, or create payment links through Square. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
signnow
SignNow API integration with managed OAuth. E-signature platform for sending, signing, and managing documents. Use this skill when users want to upload documents, send signature invites, create templates, or manage e-signature workflows. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
vimeo
Vimeo API integration with managed OAuth. Video hosting and sharing platform. Use this skill when users want to upload, manage, or organize videos, create showcases/albums, manage folders, or interact with the Vimeo community. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.