linear-app-setup

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

2|2|Updated May 13, 2026
One-click install
npx skills add https://github.com/autonomy-cloud/kairos-interface --skill linear-app-setup-autonomy-cloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-app-setup
Source: https://github.com/autonomy-cloud/kairos-interface/tree/main/skills/linear-app-setup
Command: npx skills add https://github.com/autonomy-cloud/kairos-interface --skill linear-app-setup-autonomy-cloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of getting an assistant access to manage Linear work under its own app identity, without requiring unreliable OAuth flows.

Core Features & Use Cases

  • Creates a Linear agent application identity so the assistant can act as a distinct entity when creating issues, commenting, and updating workflows.
  • Generates and stores a Linear app API key that the assistant can use to authenticate reliably as the app actor.
  • Enables correct attribution and permissions by verifying the app actor identity and guiding optional avatar upload for consistent mentions and comments.

Quick Start

Tell the assistant that you are a Linear workspace admin and ask it to set up the Linear app integration so it can create and manage issues as its own app 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 set up a Linear API key for an agent to manage issues?

You set up a Linear agent app by creating the application in your workspace, generating a scoped app API key, and storing it so the assistant authenticates as a distinct app actor to manage issues.

How does a Linear agent app manage issues under its own identity?

A Linear agent app authenticates via a scoped API key and GraphQL, allowing the assistant to create, comment on, and update issue statuses as a distinct app actor rather than a user.

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

Yes, creating a Linear agent app and generating a scoped API key requires workspace admin permissions to configure the application and optionally upload an avatar via the Linear web UI.

Can I make a Linear agent app mentionable and assignable for workflow automation?

Yes, applying specific app scopes during setup makes the Linear agent app mentionable and assignable, ensuring correct attribution when the assistant creates issues or comments.

Why use a scoped API key instead of OAuth for Linear issue management?

Using a scoped API key for Linear issue management provides reliable authentication for the app actor without relying on OAuth flows, ensuring stable access to create and update workflows.