nodnarbnitramnodnarbnitram/claude-code-extensions/.claude/skills/linear/SKILL.md

linear

Skill16 starsChanged 7 months agoMITView on GitHub

Manage Linear tickets, projects, milestones, and documents. Use for coordinating work across skills (orca-security, multi-repo) or tracking remediation progress.

Sends data out

83 other projects use a version of this.

Adopted by

Most recently taken up by

ashleysbrain/skillstheir own version, first seen Nov 8, 2026
withpiper/pipekittheir own version, first seen Nov 8, 2026
lox/agent-skillstheir own version, first seen Nov 7, 2026
lobehub/lobehubtheir own version, first seen Nov 5, 2026
DROOdotFOO/agent-skillstheir own version, first seen Nov 1, 2026
AgnesAI-Labs/agnet-skills-cntheir own version, first seen Nov 1, 2026

Used with

Projects with it also use agent-deep-links, helium-mcp and 10 more.

Other files people use alongside this one.

ComposioHQSkill
agent-deep-links
Build, validate, and troubleshoot deep links for Codex, Cursor, VS Code, Visual Studio, and similar tools. Use when users ask for clickable links (especially in Slack) that open threads, files, folders, or app settings.
Also in 3 projects that use this
ComposioHQSkill
helium-mcp
Search real-time news with bias scoring, get live stock/ETF/crypto data with AI analysis, ML options pricing, balanced news synthesis, and meme search via the Helium MCP server.
Also in 3 projects that use this
petestewartSkill
datadog-logs
Query Datadog logs via the Logs Search API v2. Use when the user asks to "check the logs", "search logs", "find errors in Datadog", "look up logs for", "show me production logs", "check for errors", "search Datadog", or any request involving log search, error investigation, or production debugging that requires Datadog log data.
Also in 3 projects that use this
OpenAISkill
pull
Also in 5 projects that use this
SentrySkill
datadog
Query live Datadog telemetry (logs, metrics, traces, spans, monitors, incidents, dashboards, services, hosts) through Datadog's Pup CLI. Use when users ask to investigate production behavior in Datadog, including searching logs, checking monitor status, inspecting traces or spans, looking up incidents, finding services, or correlating metrics. Do not use it for Sentry issues, repository/source-code work, or ticketing.
Also in 4 projects that use this
+7 more from ComposioHQ

Other versions83 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 83
lobehub/lobe-chat★ 84ksame name
lobehub/lobehub★ 84ksame name
openai/skills★ 27ksame name
openai/symphony★ 27ksame name
anthropics/claude-quickstarts★ 19ksame name
ComposioHQ/awesome-codex-skills★ 17ksame name
composio-community/awesome-codex-skills★ 16ksame name
anyproto/anytype-ts★ 9.1ksame name
vercel-labs/emulate★ 2ksame name
Lilac-Labs/gini-agent★ 1.9ksame name
73 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository23 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- cloudflare-vpc-servicesSkill
- code-reviewerSkill
- commit-helperSkill
- esphome-box3-builderSkill
- esphome-config-helperSkill
- frigate-configuratorSkill
- grafana-billingSkill
- grafana-plugin-scaffoldingSkill
- ha-addonSkill
- ha-apiSkill
- ha-automationSkill
- ha-dashboardSkill
- ha-energySkill
- ha-integrationSkill
- ha-voiceSkill
- kubernetes-healthSkill
- kubernetes-operationsSkill
- tauri-v2Skill
- typescript-v6Skill
- vitest-v4Skill
- vite-v8Skill

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 6 are distinctive, and 3 are very specific to this project.

0
Common
Most of the 79 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
If this returns ticket JSON, auth and GraphQL access are working.
line 31
Very specific:
Prefer the scripts in .claude/skills/linear/scripts/ over ad hoc curl calls.
line 35
Distinctive:
Create or update tickets for feature work, bugs, or remediation
line 39
Distinctive:
Create projects and milestones to organize work
line 40
Distinctive:
Add comments with progress or review notes
line 41
Distinctive:
Create, list, or read project documents
line 42
Distinctive:
If a needed operation does not have a wrapper yet, call the GraphQL endpoint directly rather than introducing a CLI dependency.
line 279
Very specific:
Do not use a Bearer prefix.
line 288
Very specific:
All scripts exit with code 1 on errors.
line 304

“Common” is measured: kept by at least 6 in 10 of the 79 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Linear Project & Ticket Management

This skill manages Linear through the GraphQL endpoint only. Do not use linearis or any other CLI wrapper. The project scripts in .claude/skills/linear/scripts/ share a single GraphQL client and hit https://api.linear.app/graphql directly.

Prerequisites

Required: API Token

export LINEAR_API_TOKEN='lin_api_xxxxx'

Get the token from Linear → Settings → Security & Access → Personal API keys.

Verify Setup

uv run .claude/skills/linear/scripts/read-ticket.py ICE-2041

If this returns ticket JSON, auth and GraphQL access are working.

IMPORTANT: Use Scripts First

Prefer the scripts in .claude/skills/linear/scripts/ over ad hoc curl calls. They resolve names to IDs, normalize errors, and keep output JSON-shaped for agent workflows. If you need raw queries for debugging or unsupported operations, use references/graphql-reference.md.

When to Use This Skill

Create or update tickets for feature work, bugs, or remediation
Create projects and milestones to organize work
Add comments with progress or review notes
Create, list, or read project documents
Move issues into projects or milestones

Scripts Overview

Script	Purpose
`list-issues.py`	List issues with optional team, status, and project filters
`search-issues.py`	Full-text search issues
`create-ticket.py`	Create a ticket
`read-ticket.py`	Read ticket details by identifier or UUID
`update-ticket.py`	Update ticket fields
`add-comment.py`	Add a comment to a ticket
`create-project.py`	Create a project
`add-issues-to-project.py`	Add tickets to a project
`create-milestone.py`	Create a project milestone
`add-issues-to-milestone.py`	Add tickets to a milestone
`create-document.py`	Create a project document
`list-documents.py`	List documents, optionally by project
`read-document.py`	Read a document by UUID

Ticket Operations

List Issues

uv run .claude/skills/linear/scripts/list-issues.py --team ICE-T
uv run .claude/skills/linear/scripts/list-issues.py --team ICE-T --limit 100
uv run .claude/skills/linear/scripts/list-issues.py --team ICE-T --status "Todo,In Progress"
uv run .claude/skills/linear/scripts/list-issues.py --team ICE-T --project "Orca Security Remediation"

Options:

--team filter by team key or name
--limit, -l max issues to fetch, default 50
--status, -s comma-separated workflow states
--project project name or UUID

Search Issues

uv run .claude/skills/linear/scripts/search-issues.py "Orca Security"
uv run .claude/skills/linear/scripts/search-issues.py "CVE" --team ICE-T
uv run .claude/skills/linear/scripts/search-issues.py "Privileged Role" --status "Todo,Triage"
uv run .claude/skills/linear/scripts/search-issues.py "Docker" --team ICE-T --limit 20

Options:

query required search text
--team filter by team key or name
--status, -s comma-separated workflow states
--project project name or UUID
--assignee, -a assignee user ID
--limit, -l max results, default 25

Create Ticket

uv run .claude/skills/linear/scripts/create-ticket.py "Fix CVE-2024-1234" \
  --team ICE-T \
  --description "Critical vulnerability in production" \
  --priority 1 \
  --labels "security" \
  --json

Options:

title required ticket title
--team required team key or name
--description, -d description
--priority, -p 1=urgent, 2=high, 3=normal, 4=low
--labels comma-separated label names or UUIDs
--json print structured JSON instead of just the identifier

Read Ticket

uv run .claude/skills/linear/scripts/read-ticket.py ICE-2021
uv run .claude/skills/linear/scripts/read-ticket.py 9e05263f-ed01-4b85-9c74-569fd1a0ce13

Update Ticket

uv run .claude/skills/linear/scripts/update-ticket.py ICE-2021 --status "In Progress"
uv run .claude/skills/linear/scripts/update-ticket.py ICE-2021 --status "Done" --priority 2
uv run .claude/skills/linear/scripts/update-ticket.py ICE-2021 --labels "security,urgent"

Options, at least one required:

--status new status name or UUID
--priority 1=urgent, 2=high, 3=normal, 4=low
--assignee assignee user ID
--labels comma-separated label names or UUIDs; labels are added to the existing set
--project project name or UUID
--project-milestone milestone name or UUID
--title new title
--description new description

Add Comment

uv run .claude/skills/linear/scripts/add-comment.py ICE-2021 "Fixed in PR #123"

Project Operations

Create Project

uv run .claude/skills/linear/scripts/create-project.py "Security Remediation Q1" \
  --team ICE-T \
  --description "Eliminate all High severity alerts" \
  --priority 1 \
  --json

Options:

name required project name
--team required team key or name
--description short summary, max 255 chars
--content full markdown content for the project page
--priority 0=none, 1=urgent, 2=high, 3=normal, 4=low
--target-date YYYY-MM-DD
--json print full project JSON

Add Issues to Project

uv run .claude/skills/linear/scripts/add-issues-to-project.py PROJECT_UUID ICE-2027
uv run .claude/skills/linear/scripts/add-issues-to-project.py PROJECT_UUID ICE-2027 ICE-2028 ICE-2029
uv run .claude/skills/linear/scripts/add-issues-to-project.py PROJECT_UUID --issues ICE-2027,ICE-2028

Milestone Operations

Create Milestone

uv run .claude/skills/linear/scripts/create-milestone.py "P1: Critical Fixes" \
  --project PROJECT_UUID \
  --description "RCE and exposed secrets" \
  --target-date 2026-02-09 \
  --json

Options:

name required milestone name
--project required project UUID
--description milestone description
--target-date due date in YYYY-MM-DD
--json print full milestone JSON

Add Issues to Milestone

uv run .claude/skills/linear/scripts/add-issues-to-milestone.py MILESTONE_UUID ICE-2027 ICE-2028

Document Operations

Create Document

uv run .claude/skills/linear/scripts/create-document.py \
  --title "Security Findings Report" \
  --project PROJECT_UUID \
  --content-file ./report.md \
  --json

Options:

--title required document title
--project required project name or UUID
--content markdown content
--content-file read content from file
--json print structured JSON

List Documents

uv run .claude/skills/linear/scripts/list-documents.py --project PROJECT_UUID
uv run .claude/skills/linear/scripts/list-documents.py --project "Security Remediation" --limit 100

Read Document

uv run .claude/skills/linear/scripts/read-document.py DOCUMENT_UUID

Common Workflow

# 1. Create project
PROJECT_ID=$(uv run .claude/skills/linear/scripts/create-project.py \
  "Security Remediation" \
  --team ICE-T \
  --description "Eliminate all security vulnerabilities")

# 2. Create milestone
MILESTONE_ID=$(uv run .claude/skills/linear/scripts/create-milestone.py \
  "P1: Critical" \
  --project "$PROJECT_ID" \
  --target-date 2026-02-09)

# 3. Create ticket
TICKET_ID=$(uv run .claude/skills/linear/scripts/create-ticket.py \
  "Patch CVE-2024-1234" \
  --team ICE-T \
  --priority 1)

# 4. Link ticket into the plan
uv run .claude/skills/linear/scripts/add-issues-to-project.py "$PROJECT_ID" "$TICKET_ID"
uv run .claude/skills/linear/scripts/add-issues-to-milestone.py "$MILESTONE_ID" "$TICKET_ID"

# 5. Attach supporting documentation
uv run .claude/skills/linear/scripts/create-document.py \
  --title "Findings Report" \
  --project "$PROJECT_ID" \
  --content-file ./report.md

Direct GraphQL Usage

If a needed operation does not have a wrapper yet, call the GraphQL endpoint directly rather than introducing a CLI dependency.

curl -X POST https://api.linear.app/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: $LINEAR_API_TOKEN" \
  -d '{"query":"{ viewer { id name } }"}'

Do not use a Bearer prefix. Linear expects the raw token.

For reusable queries and resolver examples, see references/graphql-reference.md.

Known Limitations

Due dates are not handled by the current project wrappers; use the UI if you need fields not exposed here
Labels must already exist in the workspace
Project description is capped at 255 characters; use content for long-form project docs

Error Handling

All scripts exit with code 1 on errors.

Common failures:

Error: LINEAR_API_TOKEN not set and ~/.linear_api_token not found
Error: Ticket ICE-9999 not found
Error: Team 'INVALID' not found
Error: Milestone 'Release 1' matched multiple projects (...)

Version

Skill version: 3.0
Transport: Linear GraphQL endpoint only

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free

Adopted by

Most recently taken up by

Used with

agent-deep-links

helium-mcp

datadog-logs

pull

datadog

Word for word · 0

Edited · 0

Wrote their own version · 83

The file

9 rules. 0 are common, 6 are distinctive, and 3 are very specific to this project.

Linear Project & Ticket Management

Prerequisites

Required: API Token

Verify Setup

IMPORTANT: Use Scripts First

When to Use This Skill

Scripts Overview

Ticket Operations

List Issues

Search Issues

Create Ticket

Read Ticket

Update Ticket

Add Comment

Project Operations

Create Project

Add Issues to Project

Milestone Operations

Create Milestone

Add Issues to Milestone

Document Operations

Create Document

List Documents

Read Document

Common Workflow

Direct GraphQL Usage

Known Limitations

Error Handling

Version

Does it work?

No reviews yet

Your trail

Now do this for your own.