← Back to Skills Marketplace
13663
Downloads
18
Stars
12
Active Installs
6
Versions
Install in OpenClaw
/install linear-api
Description
Linear API integration with managed OAuth. Query and manage issues, projects, teams, cycles, and labels using GraphQL. Use this skill when users want to crea...
Usage Guidance
Install this only if you trust Maton with access to your Linear workspace through OAuth. Confirm the selected Linear connection when multiple accounts exist, and approve write or delete actions only after checking the exact issue, comment, project, or OAuth connection that will be affected.
Capability Analysis
Type: OpenClaw Skill
Name: linear-api
Version: 1.0.5
The skill provides a Linear API integration via the Maton API gateway (api.maton.ai) for managed OAuth authentication. It includes standard GraphQL queries and mutations for managing issues, teams, and projects, along with Python and CLI examples for interaction. The documentation in SKILL.md explicitly includes safety instructions requiring user approval for write operations, and no indicators of malicious intent, data exfiltration, or prompt injection were found.
Capability Assessment
Purpose & Capability
The stated purpose and examples consistently match a Linear API skill for issues, teams, projects, cycles, labels, users, and comments through Maton-managed OAuth.
Instruction Scope
The skill includes write-capable GraphQL and connection-management examples, but it explicitly requires user approval before create, update, or delete operations and advises specifying a connection when multiple accounts exist.
Install Mechanism
The artifact is markdown-only with no bundled executable code, but it instructs users to install the external Maton CLI globally via npm or Homebrew.
Credentials
Network access, MATON_API_KEY, and Linear OAuth are sensitive but proportionate for the documented API gateway integration; examples disclose requests to api.maton.ai and Linear proxying.
Persistence & Privilege
OAuth connections are persistent and can be created, listed, selected, and deleted; this fits the managed OAuth purpose but users should verify the exact connection and account before changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install linear-api - After installation, invoke the skill by name or use
/linear-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
- Added Maton CLI commands throughout documentation for improved usability and quick start.
- Expanded setup instructions to include Homebrew and NPM installation options.
- Provided CLI equivalents for all connection management and core API tasks alongside existing Python examples.
- Updated example queries and CLI usage for more practical, real-world tasks (issue listing, team view, etc.).
- Clarified connection specification steps for users with multiple Linear accounts.
v1.0.4
- Updated API and connection management endpoints from `gateway.maton.ai`/`ctrl.maton.ai` to `api.maton.ai`
- Added new section outlining security & permissions, highlighting the need for explicit user approval for write operations
- Improved instructions for specifying which Linear connection to use when working with multiple accounts
- Clarified proxying and authentication flow for Maton API integrations
- Removed the file `LICENSE.txt`
v1.0.3
- Added `clawdbot` metadata section with required environment variable `MATON_API_KEY`.
- No changes to API, documentation, or functionality.
v1.0.2
- Documentation update only: SKILL.md file has been modified.
- No functional changes to the skill; endpoints and usage remain the same.
v1.0.1
- No code or documentation changes detected in this version.
- Version number incremented to 1.0.1.
v1.0.0
Initial release of the Linear API integration skill.
- Provides access to the Linear API with managed OAuth authentication via the Maton platform.
- Allows querying and managing issues, projects, teams, cycles, labels, and comments using GraphQL.
- Includes connection management endpoints (list, create, get, delete) for Linear OAuth connections.
- Offers detailed usage examples for key workflows (issue search, create/update issues, team/project querying).
- Requires a Maton API key and network access for all operations.
Metadata
Frequently Asked Questions
What is 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 crea... It is an AI Agent Skill for Claude Code / OpenClaw, with 13663 downloads so far.
How do I install Linear?
Run "/install linear-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Linear free?
Yes, Linear is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Linear support?
Linear is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Linear?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.0.5.
More Skills