Agent skill

Linear App Setup

by vellum-ai in vellum-ai/vellum-assistant

Create and configure a Linear agent app so the assistant can manage issues, projects, and workflows under its own identity

MITAuto-check passed

Install Linear App Setup

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill linear-app-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant linear-app-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/linear-app-setup .claude/skills/linear-app-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "linear-app-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/linear-app-setup into .claude/skills/linear-app-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "linear-app-setup", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/vellum-ai/vellum-assistant/tree/main/skills/linear-app-setup

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill linear-app-setup -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant linear-app-setup --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/linear-app-setup .agents/skills/linear-app-setup && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "linear-app-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/linear-app-setup into .agents/skills/linear-app-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "linear-app-setup", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill linear-app-setup -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant linear-app-setup --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/linear-app-setup .cursor/skills/linear-app-setup && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "linear-app-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/linear-app-setup into .cursor/skills/linear-app-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "linear-app-setup", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/vellum-ai/vellum-assistant.git --path skills/linear-app-setup

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill linear-app-setup -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant linear-app-setup --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/linear-app-setup .gemini/skills/linear-app-setup && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "linear-app-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/linear-app-setup into .gemini/skills/linear-app-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "linear-app-setup", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant linear-app-setup

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill linear-app-setup -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/linear-app-setup .github/skills/linear-app-setup && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "linear-app-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/linear-app-setup into .github/skills/linear-app-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "linear-app-setup", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add vellum-ai/vellum-assistant --skill linear-app-setup -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install vellum-ai/vellum-assistant linear-app-setup --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/linear-app-setup .opencode/skills/linear-app-setup && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "linear-app-setup" agent skill from https://github.com/vellum-ai/vellum-assistant/tree/main/skills/linear-app-setup into .opencode/skills/linear-app-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "linear-app-setup", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: linear-app-setup
GitHub stars: 1.4k
Token cost: ~1.2k tokens
SKILL.md length: 478 words
Files: 2 (incl. assets)
Skills in repo: 108
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Create and configure a Linear agent app so the assistant can manage issues, projects, and workflows under its own identity

Works in 4 steps: Create the Application → Generate an API Key for the App → Verify → …
SKILL.md covers Overview, Prerequisites, Setup Flow and App Identity, plus 2 more sections
Calls curl; reaches api.linear.app

What it does

Linear App Setup is an agent skill from vellum-ai/vellum-assistant. Create and configure a Linear agent app so the assistant can manage issues, projects, and workflows under its own identity

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including assets. Compatibility notes: Designed for Vellum personal assistants

It works with Linear. The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.

Example prompts

“/linear-app-setup”

Requirements

Compatibility (from SKILL.md): Designed for Vellum personal assistants

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Create the Application
Generate an API Key for the App
Verify
Set the App Avatar (Optional)

What it can do on your machine

Read from SKILL.md and the folder at commit c92ead1. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- api.linear.app
Also links to:
- linear.app
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Designed for Vellum personal assistants
From compatibility in the SKILL.md frontmatter.

Context cost

Linear App Setup loads about 1.2k tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 478 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~35
When it runs · the whole SKILL.md, loaded when a task matches: ~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vellum-ai/vellum-assistant at commit c92ead1, republished under its MIT licence (© vellum-ai). 478 words, ~1,210 tokens.

Download SKILL.mdSave it as .claude/skills/linear-app-setup/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: linear-app-setup
description: Create and configure a Linear agent app so the assistant can manage issues, projects, and workflows under its own identity
compatibility: Designed for Vellum personal assistants
metadata.icon: assets/icon.svg
metadata.emoji: 🔷

Overview

Set up a Linear agent app so the assistant operates under its own identity in a Linear workspace — creating issues, commenting, updating status, etc. as itself.

Linear agent apps act as their own entity in the workspace. They're free (don't count as billable users), can be @mentioned, and can be delegated issues.

Total manual effort: ~3 interactions — create the app, grab the API key, (optionally) upload an avatar.

Prerequisites

User must be a workspace admin in Linear
User must be logged into Linear in their browser

Setup Flow

Step 1: Create the Application

Direct the user to create a new application:

Open https://linear.app/settings/api/applications/new to create a new application.

Guide them through the form:

Field	Value
Application name	The assistant's name. This is how the agent appears in mentions and filters.
Developer name	The user's name or org name
Developer URL	Any valid URL

Click Create when done.

Step 2: Generate an API Key for the App

After creating the app, the user should generate a personal API key scoped to this app identity. This is how the assistant authenticates — simpler and more reliable than the full OAuth token refresh flow.

Direct the user:

On the app's settings page, look for the option to create an API key for this application. Copy the key.

Prompt for the API key via secure UI:

bash

assistant credentials prompt --service linear --field api_key \
  --label "Linear App API Key" \
  --placeholder "lin_api_xxxxxxxxxx" \
  --description "API key for your Linear app (used to authenticate API requests)" \
  --allowed-domains "api.linear.app" \
  --allowed-tools "bash" \
  --injection-templates '[{"hostPattern":"api.linear.app","injectionType":"header","headerName":"Authorization","valuePrefix":"Bearer "}]'

Step 3: Verify

After storing the key, verify the connection:

bash

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

Run with network_mode: "proxied" and the linear credential. A successful response returns the app's identity:

json

{
  "data": {
    "viewer": {
      "id": "...",
      "name": "MyAssistant",
      "email": "...@oauthapp.linear.app"
    }
  }
}

The @oauthapp.linear.app email confirms it's an app actor, not a user.

Step 4: Set the App Avatar (Optional)

Linear doesn't support setting the avatar via API — it must be uploaded through the web UI.

If the assistant has an avatar, send it to the user:

<vellum-attachment source="sandbox" path="data/avatar/avatar-image.png" />

Then direct them to the app settings page:

Go to https://linear.app/settings/api, find your app, and upload the avatar image under the app icon.

Show full SKILL.md (163 more words)Show less

App Identity

The app appears as a distinct entity in Linear:

Issues it creates show the app as creator
Comments it posts show the app's name and avatar
It appears in mention menus if app:mentionable scope is enabled
Issues can be delegated to it if app:assignable scope is enabled — delegation sets the app as delegate, not assignee, so humans keep ownership

Acting on Behalf of a User

When the agent performs an action that originated from a specific user in a third-party system, use createAsUser and displayIconUrl to attribute it:

graphql

mutation {
  issueCreate(
    input: {
      title: "Bug report"
      teamId: "TEAM_UUID"
      createAsUser: "Jane"
      displayIconUrl: "https://example.com/jane-avatar.png"
    }
  ) {
    success
    issue {
      identifier
      url
    }
  }
}

This renders as "Jane (via AppName)" in Linear.

Team Access

After installation, workspace admins can modify the app's team access at any time through the app's details page in Linear settings.

Important Notes

The app's name and icon are how it appears everywhere in Linear — pick something short, recognizable, and unique.
Agent apps are free — they don't count toward the workspace's billable user seats.
The app gets a unique user ID per workspace.

Files

SKILL.md and 1 other file (assets) in skills/linear-app-setup of vellum-ai/vellum-assistant.

SKILL.md
assets/icon.svg

Open the folder on GitHubat commit c92ead1

Compare with similar skills

Linear App Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Linear App Setup compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Linear App Setup this skillvellum-ai/vellum-assistant	1.4k	—	~1.2k	Automated safety check: Pass	MIT	yesterday
Orca Linear Ticket Workflowstablyai/orca	87k	1 repos	~522	Automated safety check: Pass	MIT	today
Review Triage Phaseprisma/orm	48k	—	~995	Automated safety check: Pass	Apache-2.0	today
Commitdinerojs/dinero.js	6.8k	—	~667	Automated safety check: Pass	MIT	3 days ago
Draft Pull Request Creatorwordpress-mobile/WordPress-Android	3.2k	—	~881	Automated safety check: Notes	GPL-2.0	yesterday
Linear Tickets via Orcastablyai/orca	87k	—	~558	Automated safety check: Pass	MIT	today

Similar skills

Orca Linear Ticket Workflow
stablyai/orca
Linear ticket work through Orca's CLI. Use when working from a linked Linear issue, finishing work with a PR/MR link and a completion comment, moving a ticket…
87k GitHub starsUsed in 1 repo~522 tokens
Productivity & AutomationAuto-check passed
Review Triage Phase
prisma/orm
Official
Runs the triage step of the review-framework loop: reads fetched PR review state, builds `review-actions.json`, validates it and renders `review-actions.md`.
48k GitHub stars~995 tokensUpdated today
DevelopmentAuto-check passed
Commit
dinerojs/dinero.js
Create a git commit with optional automatic Linear issue linking.
6.8k GitHub stars~667 tokensUpdated 3 days ago
DevelopmentAuto-check passed
Draft Pull Request Creator
wordpress-mobile/WordPress-Android
Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.
3.2k GitHub stars~881 tokensUpdated yesterday
DevelopmentAuto-check: notes
Linear Tickets via Orca
stablyai/orca
Linear ticket work through Orca's CLI. Use when working from a linked Linear issue, finishing work with a PR/MR link and a completion comment, moving a ticket…
87k GitHub stars~558 tokensUpdated today
Productivity & AutomationAuto-check passed
Add Icon Mapping
lobehub/lobe-icons
Add or modify icon keyword mappings for providers, models, or agents in lobe-icons.
2.6k GitHub stars~1.5k tokensUpdated yesterday
MobileAuto-check: warnings

Questions about Linear App Setup

What does Linear App Setup do?

Create and configure a Linear agent app so the assistant can manage issues, projects, and workflows under its own identity. Linear App Setup is an agent skill from vellum-ai/vellum-assistant.

How do I install Linear App Setup in Claude Code?

Run `npx skills add vellum-ai/vellum-assistant --skill linear-app-setup -a claude-code`. Or copy the skill folder (skills/linear-app-setup in vellum-ai/vellum-assistant) into .claude/skills/linear-app-setup in your project. Claude Code loads it when a task matches its description.

How do I install Linear App Setup in Codex?

Run `npx skills add vellum-ai/vellum-assistant --skill linear-app-setup -a codex`. Or copy the skill folder (skills/linear-app-setup in vellum-ai/vellum-assistant) into .agents/skills/linear-app-setup in your project. Codex loads it when a task matches its description.

Can I use Linear App Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vellum-ai/vellum-assistant --skill linear-app-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/linear-app-setup, .gemini/skills/linear-app-setup, .github/skills/linear-app-setup and .opencode/skills/linear-app-setup in your project.

What does Linear App Setup need to run?

Going by SKILL.md and its folder, Linear App Setup needs the command-line tools its instructions call (curl). Compatibility (from SKILL.md): Designed for Vellum personal assistants.

Does Linear App Setup access the network?

SKILL.md names 2 domains. In commands or code: api.linear.app; the agent is likely to contact it when it follows the instructions. As links in the text: linear.app. This is read from the text; nothing was executed.

Is Linear App Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Linear App Setup use?

Linear App Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Linear App Setup use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Linear App Setup?

Skills that share tags, products or a category with Linear App Setup: Orca Linear Ticket Workflow (stablyai/orca, 87k stars), Review Triage Phase (prisma/orm, 48k stars), Commit (dinerojs/dinero.js, 6.8k stars) and Draft Pull Request Creator (wordpress-mobile/WordPress-Android, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linear App Setup?

vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,397 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 7, 2026.

Source: vellum-ai/vellum-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Linear App Setup

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Overview

Prerequisites

Setup Flow

Step 1: Create the Application

Step 2: Generate an API Key for the App

Step 3: Verify

Step 4: Set the App Avatar (Optional)

App Identity

Acting on Behalf of a User

Team Access

Important Notes

Files

Compare with similar skills

Similar skills

More from vellum-ai/vellum-assistant

Related

Questions about Linear App Setup