Native Linear

Query and manage Linear issues, projects, cycles, and teams via the Linear GraphQL API. Use when you need to list or create issues, check cycle status, manag...

Security Scan

The skill's code, instructions, and required environment variable (LINEAR_API_KEY) are consistent with a Linear GraphQL client that calls api.linear.app directly and do not request unrelated credentials or installs.

Purpose & Capability

Name/description match the actual behavior: the script is a Python CLI that queries and mutates Linear via https://api.linear.app/graphql. Required binary (python3) and required env var (LINEAR_API_KEY) are appropriate and proportionate.

Instruction Scope

SKILL.md instructs running the included Python script and setting LINEAR_API_KEY. The runtime instructions only reference the Linear API endpoint and the skill's own script path; there are no instructions to read unrelated files or exfiltrate data to external endpoints.

Install Mechanism

No install spec is present (instruction-only with an included script). The script uses only Python stdlib (urllib) and does not pull external packages or execute downloads during install.

Credentials

Only LINEAR_API_KEY is required and declared as primaryEnv; this is exactly the credential needed to call the Linear API. There are no unrelated secrets or config paths requested.

Persistence & Privilege

always is false and the skill does not request persistent system-wide changes. It does not modify other skills' config or request elevated privileges; autonomous invocation is allowed by platform default and is not by itself a concern here.

Assessment

The skill appears internally consistent: it is a simple Python client that sends your LINEAR_API_KEY to api.linear.app/graphql and nothing else. Before installing, confirm you trust the skill source (the registry metadata lists no homepage and source is unknown). Use a Linear API key with minimal scope, rotate/revoke the key if you stop using the skill, and consider reviewing the full scripts/linear_query.py file yourself (or run it in a sandbox) to verify there are no hidden network calls or local file accesses beyond what is shown.

Linear

Interact with Linear directly via the Linear GraphQL API (api.linear.app/graphql).

Setup (one-time)

1. Go to Linear → Settings → Account → Security & Access → API keys
2. Create a new key
3. Set environment variable:

   LINEAR_API_KEY=lin_api_...
   

Usage

List your teams

python3 /mnt/skills/user/linear/scripts/linear_query.py teams

List issues assigned to you

python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues
python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues --state "In Progress"

List issues for a team

python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering"
python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering" --state "Todo" --limit 20

Get a specific issue

python3 /mnt/skills/user/linear/scripts/linear_query.py issue ENG-123

Search issues

python3 /mnt/skills/user/linear/scripts/linear_query.py search "authentication bug"

Create an issue

python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Fix login bug" --description "Users can't log in on Safari"
python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Add dark mode" --priority 2

Update an issue

python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --state "Done"
python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --priority 1 --title "New title"

List projects

python3 /mnt/skills/user/linear/scripts/linear_query.py projects
python3 /mnt/skills/user/linear/scripts/linear_query.py projects --team "Engineering"

List cycles (sprints)

python3 /mnt/skills/user/linear/scripts/linear_query.py cycles --team "Engineering"

List workflow states for a team

python3 /mnt/skills/user/linear/scripts/linear_query.py states --team "Engineering"

Priority levels

• 0 = No priority
• 1 = Urgent
• 2 = High
• 3 = Normal
• 4 = Low