skills.rest
Logarn
LogarnCOMMUNITY
Explore all skills by this author →
GitHub

linear-app-setup

Configure a Linear agent app with API key authentication for assistant-driven issue management.

1|Updated Mar 30, 2026
Search Tags:#integration#graphql#issue tracking#linear#credentials#api key#app setup
One-click install
npx skills add https://github.com/Logarn/Worklin-ai --skill linear-app-setup-logarn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear-app-setup
Source: https://github.com/Logarn/Worklin-ai/tree/main/skills/linear-app-setup
Command: npx skills add https://github.com/Logarn/Worklin-ai --skill linear-app-setup-logarn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Setting up an assistant to act under its own identity in Linear requires navigating app creation, API key generation, and credential storage, which is error-prone without a guided workflow. ## Core Features & Use Cases - Guided App Creation: Walks the user through creating a Linear agent application with the correct name, developer fields, and settings. - Secure Credential Capture: Prompts for the app's API key through a secure credential flow restricted to api.linear.app with header-based injection. - Identity Verification: Confirms the connection via a GraphQL viewer query and validates the app actor identity by its @oauthapp.linear.app email. - Use Case: A workspace admin wants their assistant to create and comment on Linear issues as itself. The skill guides them through app creation, key storage, verification, and optional avatar upload in about three manual interactions. ## Quick Start Set up a Linear agent app so the assistant can create and manage issues under its own identity in my Linear workspace.

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 for an AI assistant?▼

Create a new application at linear.app/settings/api/applications/new, providing the assistant's name, developer name, and a developer URL. Then generate an API key on the app's settings page and store it through the secure credential prompt.

How do I authenticate Linear API requests for an app?▼

Authenticate with a personal API key scoped to the app, sent as a Bearer token in the Authorization header to api.linear.app. This is simpler than the full OAuth token refresh flow and works for GraphQL queries and mutations.

Does a Linear agent app count as a billable user?▼

No, Linear agent apps are free and do not count toward the workspace's billable user seats. They act as distinct entities that can be @mentioned and delegated issues.

Can I set a Linear app avatar through the API?▼

No, Linear does not support setting the app avatar via API. The avatar image must be uploaded manually through the app's settings page in the Linear web UI.

How do I verify a Linear app API key is working?▼

Send a GraphQL viewer query to https://api.linear.app/graphql with the key as a Bearer token. A successful response returns the app's identity, and an @oauthapp.linear.app email confirms it is an app actor rather than a user.

Related Skills

Explore More Software Engineering Skills→
CerisonAutomationCerisonAutomation

linear-app-setup

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

Community
Intermediate
erfanzarerfanzar
27

linear

Query and mutate Linear data via curl against the GraphQL API.

Community
Intermediate
jieni777jieni777
1

composio

Connect Slack, Jira, Linear, GitHub and 100+ platforms for cross-tool workflows.

Community
Advanced
ticruz38ticruz38

slack-auth

Manage Slack OAuth and bot token storage across multiple workspaces.

Community
Intermediate