linear-app-setup

Create and configure a Linear agent app with an API key.

1.0k|158|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/vellum-ai/vellum-assistant --skill linear-app-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-app-setup
Source: https://github.com/vellum-ai/vellum-assistant/tree/main/skills/linear-app-setup
Command: npx skills add https://github.com/vellum-ai/vellum-assistant --skill linear-app-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill enables the assistant to operate as a Linear app within a workspace, allowing it to create and manage issues, comments, and workflows under its own identity.

Core Features & Use Cases

  • The app acts as its own entity in the Linear workspace, can be @mentioned, and can have issues delegated to it.
  • Setup flow includes creating the Linear app, generating an API key, and optionally uploading an avatar to complete branding.
  • Use case: the assistant creates issues, comments, and updates status as the app actor to streamline project workflows.

Quick Start

Create the Linear app, generate a personal API key, and optionally upload an avatar to complete the app's identity.

Frequently Asked Questions about linear-app-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Linear agent app to automate issue management in my workspace?

To create a Linear agent app, a workspace admin must generate a personal API key with appropriate scopes and configure the application to operate under its own identity. The setup optionally includes uploading an avatar to complete the app's branding.

Why does my assistant need its own Linear app identity instead of using my user account?

A dedicated Linear app identity allows the assistant to create issues, comment, and update statuses as a distinct actor. This means the app can be @mentioned and have issues delegated to it directly, streamlining project workflows without impersonating a user.

What permissions do I need to set up a Linear integration for workflow automation?

Setting up a Linear integration requires workspace admin access to create the application. The admin must generate a personal API key configured with appropriate scopes to authorize the agent app to manage issues and projects.

Can I customize the Linear agent app with a specific avatar and identity?

Yes, you can optionally upload an avatar to complete the branding of your Linear agent app. This visual identity helps workspace members recognize the app when it is @mentioned or assigned issues.

What's the best way to configure an assistant to update Linear issue statuses automatically?

The best way is to configure the assistant as a Linear agent app with a generated API key. This allows the assistant to operate under its own identity and automatically update issue statuses, create issues, and comment on projects.

Does setting up a Linear agent app require workspace admin access?

Yes, creating a Linear agent app requires workspace admin access to generate the application and configure the personal API key. This ensures the agent has the proper authorization to manage workflows within the workspace.