skills.rest
CerisonAutomation
CerisonAutomationCOMMUNITY
Explore all skills by this author →
GitHub

linear-app-setup

Configure a Linear agent app with API key and GraphQL verification.

Updated Aug 27, 2026
Search Tags:#workflow automation#graphql#issue management#linear#api key#agent app#workspace admin
One-click install
npx skills add https://github.com/CerisonAutomation/clud --skill linear-app-setup-cerisonautomation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear-app-setup
Source: https://github.com/CerisonAutomation/clud/tree/main/skills/linear-app-setup
Command: npx skills add https://github.com/CerisonAutomation/clud --skill linear-app-setup-cerisonautomation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the guesswork involved in configuring a Linear agent app so your assistant can create and manage issues and workflows under its own identity.

Core Features & Use Cases

  • Linear agent app creation: Guides you through creating an application in the Linear API settings with the right identity details.
  • App-scoped API key setup: Walks you through generating and securely storing a personal API key scoped to the app identity.
  • Validation and identity verification: Uses a GraphQL viewer query to confirm the app identity is correctly authenticated as an OAuth app actor.
  • Optional avatar upload: Helps you attach an avatar file via the web UI since Linear requires it through the interface rather than the API.
  • Correct attribution for user-originated actions: Shows how to act using createAsUser and displayIconUrl so Linear renders actions as “User (via AppName)”.

Quick Start

Set up the assistant’s Linear agent app by following the Skill steps to create the application, store the Linear app API key, and verify the connection with the provided GraphQL viewer query.

Frequently Asked Questions about linear-app-setup

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

FAQPage Schema
How do I set up a Linear agent app to manage issues under its own identity?▼

To set up a Linear agent app, create an application in Linear API settings, generate an app-scoped personal API key, store it via the credential store injection template, and verify the connection using a GraphQL viewer query.

Why does my Linear API key authenticate as a standard user instead of an agent app?▼

Linear authenticates as an agent app actor when you use an app-scoped personal API key. You must generate this key within the application settings and verify the OAuth app actor identity using a GraphQL viewer query.

Can I upload a Linear agent app avatar through the API?▼

No, Linear requires avatar configuration through the web UI rather than the API. You must attach the avatar file manually via the Linear interface after creating the agent application identity.

How do I make Linear show issue actions as "User (via AppName)"?▼

To display actions as "User (via AppName)" in Linear, your agent app must use the `createAsUser` and `displayIconUrl` parameters when creating or managing issues through the authenticated GraphQL API.

Do I need workspace admin permissions to create a Linear agent app?▼

Yes, creating a Linear agent app and generating the required app-scoped personal API key requires workspace admin onboarding privileges to access the necessary API settings and authentication configuration.

What is the best way to verify a Linear agent app API connection?▼

The best way to verify a Linear agent app connection is by running a GraphQL viewer query that confirms the app identity is correctly authenticated as an OAuth app actor before managing workflows.

Related Skills

Explore More Product & Management Skills→
vellum-aivellum-ai
1.0k

linear-app-setup

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

Official
Intermediate
SatangThevalueSatangThevalue

linear

Manage Linear issues, projects, and documents via GraphQL queries.

Community
Intermediate
lobehublobehub
81.4k

linear

Automate Linear issue status updates and completion comments via MCP tools.

Official
Advanced
projectedanxprojectedanx
1

linear

Manage issues, projects, and documentation via the Linear GraphQL API.

Community
Intermediate