Agent skill · software engineering · jeremylongshore
linear-hello-world
Prove Linear authentication and workspace visibility with the smallest read-only GraphQL or SDK query. Use when establishing a new integration baseline without creating test issues. Trigger with "test Linear connection", "Linear hello world", or "verify Linear API key".
Why this skill is useful
Provides specific commands and examples for interacting with the Linear API using GraphQL, which the AI wouldn't reliably generate on its own.
What it needs
Requires @linear/sdk installed locally. Requires linear account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Linear Read-Only Connectivity Proof Overview Verify endpoint, auth mode, viewer identity, and visible team count without spending the first test on a production write. Prerequisites The target repository, Linear workspace, environment, and accountable owner Current security, privacy, compliance, capacity, and change-control requirements An approved Linear credential only when a bounded live verification is necessary Tool Discipline Use Read, Glob, and Grep to inspect code, configuration, and evidence. Use WebFetch only for current first-party Linear documentation and package metadata. Use Write or Edit only for requested implementation with known target files. Never write credentials, customer content, unrestricted environment output, or unredacted GraphQL variables. Current Contract The GraphQL endpoint is https://api.linear.app/graphql and supports introspection. Personal API keys use Authorization: <APIKEY> without Bearer; OAuth access tokens use Authorization: Bearer <ACCESSTOKEN>. The official TypeScript SDK accepts either apiKey or accessToken in LinearClient. Authentication Use a personal API key only for owner-controlled scripts, OAuth with PKCE for user-delegated applications, or an enabled client-credentials grant for approved automation. Personal keys use Authorization: <APIKEY>; OAuth tokens use Authorization: Bearer <ACCESSTOKEN>. Store credentials server-side in an approved secret manager. Treat app approval, team access, scope changes, credential creation, rotation, revocation, and production access as owner-approved actions. Instructions 1. Inspect the repository runtime, package manager, secret-loading convention, and existing Linear client code. 2. Select personal API key only for owner-controlled scripts or OAuth for applications used by others. 3. Pin a compatible @linear/sdk range or construct a minimal GraphQL request using the correct authorization form. 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/linear-hello-world--074d3d