← Back to Skills Marketplace
emrekilinc

Linear Issues

by emrekilinc · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2549
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install linear-issues
Description
Interact with Linear for issue tracking. Use when creating, updating, listing, or searching issues. Supports viewing assigned issues, changing status, adding comments, and managing tasks.
README (SKILL.md)

Linear

Manage Linear issues via scripts/linear.sh.

Setup

Store API key in ~/.clawdbot/credentials/linear.json:

{"apiKey": "lin_api_..."}

Commands

# List my assigned issues
scripts/linear.sh issues --mine

# List team issues
scripts/linear.sh issues --team TEAM_ID

# Get issue details
scripts/linear.sh get CLP-123

# Search issues
scripts/linear.sh search "auth bug"

# Create issue
scripts/linear.sh create --team TEAM_ID --title "Bug: login fails" --description "Details"

# Update issue (status, title, assignee, priority)
scripts/linear.sh update CLP-123 --state STATE_ID

# Add comment
scripts/linear.sh comment CLP-123 "Fixed in PR #42"

# List teams (to get TEAM_ID)
scripts/linear.sh teams

# List states (to get STATE_ID)
scripts/linear.sh states

# List users (to get assignee ID)
scripts/linear.sh users

Use --json flag for raw API output: scripts/linear.sh --json issues --mine

Workflow Examples

Create and assign a bug:

# Find team ID
scripts/linear.sh teams
# Create with priority 2 (high)
scripts/linear.sh create --team abc123 --title "Critical: API down" --priority 2

Move issue to In Progress:

# Find state ID
scripts/linear.sh states
# Update
scripts/linear.sh update CLP-45 --state xyz789

See references/api-examples.md for GraphQL details.

Usage Guidance
This skill appears to be a straightforward Linear CLI wrapper, but there are some gaps you should address before installing or running it: - The skill requires a Linear API key (LINEAR_API_KEY or ~/.clawdbot/credentials/linear.json) even though the registry metadata doesn't declare it. Do not supply a high-privilege API key until you verify the author and intended usage. Prefer a token with minimal scopes. - The shell script depends on command-line tools (curl, jq, column). Make sure those are available and from trusted packages on your system. - The script builds GraphQL payloads by directly interpolating user input into JSON/GraphQL strings. That can break with quotes/newlines and could be abused if untrusted input is fed into the skill. Review and test with safe inputs; consider sanitizing/escaping values in the script before use. - The package contains Node-related files (package.json / package-lock.json) but the runtime is a shell script; verify whether any Node code is intended to be executed and whether an install step is required. If you want to proceed: 1) obtain a Linear API key with minimal permissions, 2) manually inspect scripts/linear.sh (or run it in a sandbox), 3) add the declared requirement for the API key and CLI tools to the skill metadata or request the author to update the package metadata to match runtime needs. If you cannot validate the author or the repository origin, consider not installing or running it on sensitive accounts.
Capability Analysis
Type: OpenClaw Skill Name: linear-issues Version: 1.0.0 The skill's core script, `scripts/linear.sh`, constructs GraphQL queries by directly embedding user-provided arguments (such as issue titles, descriptions, search terms, and comment bodies) into the JSON query string without proper sanitization. This creates a GraphQL injection vulnerability, which could allow a malicious actor to alter the intended API call, potentially leading to unauthorized data access or manipulation within the Linear API. While the skill's stated purpose is benign, this implementation flaw represents a significant security risk.
Capability Assessment
Purpose & Capability
Name/description align with the code: the script talks exclusively to api.linear.app and implements listing, creating, updating, commenting, teams/states/users, etc. However the skill metadata declares no primary credential or required env vars even though both SKILL.md and scripts/linear.sh require a Linear API key (LINEAR_API_KEY or ~/.clawdbot/credentials/linear.json). The metadata also does not declare required CLI tools (curl, jq, column) that the script depends on.
Instruction Scope
SKILL.md and scripts/linear.sh stay within the stated purpose (access Linear via GraphQL). The script reads a credentials file at $HOME/.clawdbot/credentials/linear.json or the LINEAR_API_KEY env var — that's expected for an API integration. Concerns: the script interpolates user-supplied strings directly into JSON/GraphQL payloads without robust escaping, which can lead to malformed queries or injection-like behavior if an attacker or malformed input is provided. The only external endpoint contacted is api.linear.app (no unexpected endpoints).
Install Mechanism
No install spec (instruction-only + shipped script). That is low risk from an install perspective because nothing arbitrary is downloaded during install. The repo includes package.json/lock but there is no install step declared by the registry entry — the presence of Node deps in package-lock is not used at runtime by the shell script.
Credentials
The skill legitimately needs a Linear API key to function, which is documented in SKILL.md and used by the script, so the requested secret is proportionate. But the registry metadata did not declare a primary credential or required env var. Also the script expects runtime tools (curl, jq, column) that are not declared; missing these requirements can lead users to run the skill in an environment where it will fail or produce unexpected output.
Persistence & Privilege
always is false and the skill does not request to persist or modify other skills or system-wide configs. It only reads a credentials file in the user's home under ~/.clawdbot/credentials and environment variables, which is consistent with its purpose.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install linear-issues
  3. After installation, invoke the skill by name or use /linear-issues
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release - manage Linear issues from Clawdbot
Metadata
Slug linear-issues
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Linear Issues?

Interact with Linear for issue tracking. Use when creating, updating, listing, or searching issues. Supports viewing assigned issues, changing status, adding comments, and managing tasks. It is an AI Agent Skill for Claude Code / OpenClaw, with 2549 downloads so far.

How do I install Linear Issues?

Run "/install linear-issues" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Linear Issues free?

Yes, Linear Issues is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Linear Issues support?

Linear Issues is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Linear Issues?

It is built and maintained by emrekilinc (@emrekilinc); the current version is v1.0.0.

💬 Comments