← 返回 Skills 市场
3217
总下载
6
收藏
6
当前安装
2
版本数
在 OpenClaw 中安装
/install linear-skill
功能描述
Manage Linear projects, issues, and tasks via the bundled Node CLI and the official Linear API. Use when you need to read, create, update, or organize Linear...
使用说明 (SKILL.md)
Linear Workflow Management
Manage Linear issues and projects through the bundled CLI at {baseDir}/scripts/linear-cli.js.
Scope and Runtime Model
- This skill runs
node {baseDir}/scripts/linear-cli.js .... - The CLI uses the official
@linear/sdk. - Authentication is
LINEAR_API_KEYfrom the local environment. - Expected API destination is Linear GraphQL (
https://api.linear.app/graphql) through the official SDK.
Prerequisites
- Node.js and npm are installed.
- Install script dependencies once:
cd {baseDir}/scripts && npm install
- Set your API key:
export LINEAR_API_KEY="lin_api_..."
If dependencies or LINEAR_API_KEY are missing, stop and complete setup before issue/project operations.
Authentication and Credentials
- Required credential:
LINEAR_API_KEY. - Get it from
https://linear.app/settings/api. - Use least-privilege access and a dedicated token for automation.
Required Workflow
- Clarify intent and scope:
- Team/project, labels, cycle, assignee, due date, priority.
- Read current state first:
- List/get issues, projects, statuses, labels, users, cycles.
- Apply mutations second:
- Create/update issues, comments, projects, milestones, labels.
- Summarize exactly what changed:
- Mention IDs, states, assignees, blockers, and follow-up actions.
Command Coverage
- Teams and projects:
teams,projects,createProject - Issues:
issues,issue,createIssue,updateIssue - Comments:
createComment - States and labels:
states,labels - User:
user
Quick Examples
node {baseDir}/scripts/linear-cli.js teams
node {baseDir}/scripts/linear-cli.js projects
node {baseDir}/scripts/linear-cli.js issues
node {baseDir}/scripts/linear-cli.js issue ENG-123
node {baseDir}/scripts/linear-cli.js createIssue "Title" "Description" "team-id" '{"priority":2}'
node {baseDir}/scripts/linear-cli.js updateIssue "issue-id" '{"stateId":"state-id"}'
Practical Workflows
- Triage urgent bugs:
list high-priority open issues, assign owners, move state to
In Progress, add triage comments. - Sprint planning: review cycle scope, create missing issues, set priorities and estimates, align assignees.
- Release prep: verify blockers, update project status, create milestone tasks, add rollout comments.
- Documentation cleanup: find stale docs/issues, open follow-up tasks, link related records.
Safety and Operational Rules
- Never invent IDs; fetch and confirm before updates.
- Prefer narrow updates over broad bulk edits.
- For bulk edits, explain grouping logic before applying changes.
- Do not include secrets in issue comments or descriptions.
- Do not send data to endpoints outside Linear API scope for this skill.
References
references/API.mdfor priority values and workflow patterns.
安全使用建议
This skill appears coherent and implements a straightforward CLI wrapper for the official Linear SDK. Before installing: 1) Use a dedicated Linear API token with minimal permissions and rotate it if needed. 2) Run npm install in a controlled environment (the package installs @linear/sdk from npm); verify network sources if you require stricter supply-chain controls. 3) Ensure your Node version meets the SDK's engine requirement (>=18.x). 4) Review the bundled scripts if you want extra assurance (the CLI is short and only calls the official SDK). 5) On shared platforms, ensure the platform only exposes LINEAR_API_KEY to this skill and not to unrelated components.
功能分析
Type: OpenClaw Skill
Name: linear-skill
Version: 1.0.0
The skill is designed to manage Linear projects and issues using the official `@linear/sdk`. The `SKILL.md` explicitly includes 'Safety and Operational Rules' instructing the agent 'Do not send data to endpoints outside Linear API scope for this skill,' which actively mitigates prompt injection risks for data exfiltration. The `scripts/linear-cli.js` only accesses the `LINEAR_API_KEY` environment variable and makes calls through the official SDK, showing no signs of unauthorized network activity, file system access, or malicious execution. While the use of `JSON.parse` on command-line arguments could be a robustness vulnerability if untrusted input is provided, it does not indicate malicious intent within the context of an AI agent providing structured input.
能力评估
Purpose & Capability
The name/description match the contained CLI implementation (scripts/linear-cli.js) which uses @linear/sdk and targets Linear's GraphQL API. Required binaries (node, npm) and the LINEAR_API_KEY credential are appropriate and expected for this purpose.
Instruction Scope
SKILL.md instructs the agent to run the bundled Node CLI and to read LINEAR_API_KEY from the environment. Runtime steps are limited to listing/reading/updating Linear resources and explicitly forbid sending data to endpoints outside the Linear API. The CLI source only calls the official SDK and prints JSON; it does not access unrelated files or network endpoints.
Install Mechanism
Install uses a brew formula to install Node (reasonable). The package.json triggers `cd scripts && npm install` (postinstall), which will fetch @linear/sdk from the npm registry — typical but worth verifying in your environment. Note: @linear/sdk declares node engine >=18.x; ensure your Node version meets that requirement.
Credentials
Only a single credential (LINEAR_API_KEY) is required and is the primaryEnv; that is proportionate. The code reads only that env var and nothing else. Recommend using a dedicated, least-privilege Linear token for automation as the SKILL.md suggests.
Persistence & Privilege
The skill does not request permanent 'always' inclusion (always: false). It doesn't modify other skills or system-wide configs. Note that model invocation is allowed by default (disable-model-invocation: false) — this is the platform default and not in itself suspicious.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install linear-skill - 安装完成后，直接呼叫该 Skill 的名称或使用
/linear-skill触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of linear-skill – manage Linear projects and workflows via CLI and API.
- Adds bundled Node.js CLI for Linear project, issue, comment, and label management.
- Supports authentication via LINEAR_API_KEY environment variable.
- Provides coverage for teams, projects, issues, comments, states, labels, users.
- Includes operational best practices and setup guidance in documentation.
- Offers reference examples and practical workflow suggestions in README and SKILL.md.
v0.1.0
Initial release of linear-skill.
- Enables management of Linear projects, issues, tasks, teams, milestones, comments, states, and labels via CLI.
- Supports creating, updating, searching, and managing all Linear entities.
- Provides quick start and command usage examples for common workflows.
- All commands return JSON for easy integration and automation.
元数据
常见问题
Linear 是什么？
Manage Linear projects, issues, and tasks via the bundled Node CLI and the official Linear API. Use when you need to read, create, update, or organize Linear... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 3217 次。
如何安装 Linear？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install linear-skill」即可一键安装，无需额外配置。
Linear 是免费的吗？
是的，Linear 完全免费（开源免费），可自由下载、安装和使用。
Linear 支持哪些平台？
Linear 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Linear？
由 MaTriXy（@matrixy）开发并维护，当前版本 v1.0.0。
推荐 Skills