Create your first Linear issue and query using the GraphQL API. Use when making initial API calls, testing Linear connection, or learning basic Linear operations. Trigger with phrases like "linear hello world", "first linear issue", "create linear issue", "linear API example", "test linear connection".
Installation
Details
Usage
After installing, this skill will be available to your AI coding assistant.
Verify installation:
skills listSkill Instructions
name: linear-hello-world description: | Create your first Linear issue and query using the GraphQL API. Use when making initial API calls, testing Linear connection, or learning basic Linear operations. Trigger with phrases like "linear hello world", "first linear issue", "create linear issue", "linear API example", "test linear connection". allowed-tools: Read, Write, Edit, Bash(npx:*), Grep version: 1.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io
Linear Hello World
Overview
Create your first issue and execute basic queries with the Linear API.
Prerequisites
- Linear SDK installed (
@linear/sdk) - Valid API key configured
- Access to at least one Linear team
Instructions
Step 1: Query Your Teams
import { LinearClient } from "@linear/sdk";
const client = new LinearClient({ apiKey: process.env.LINEAR_API_KEY });
// Get all teams you have access to
const teams = await client.teams();
console.log("Your teams:");
teams.nodes.forEach(team => {
console.log(` - ${team.name} (${team.key})`);
});
Step 2: Create Your First Issue
// Get the first team
const team = teams.nodes[0];
// Create an issue
const issueCreate = await client.createIssue({
teamId: team.id,
title: "My first Linear issue from the API",
description: "This issue was created using the Linear SDK!",
});
if (issueCreate.success) {
const issue = await issueCreate.issue;
console.log(`Created issue: ${issue?.identifier} - ${issue?.title}`);
console.log(`URL: ${issue?.url}`);
}
Step 3: Query Issues
// Get recent issues from your team
const issues = await client.issues({
filter: {
team: { key: { eq: team.key } },
},
first: 10,
});
console.log("Recent issues:");
issues.nodes.forEach(issue => {
console.log(` ${issue.identifier}: ${issue.title} [${issue.state?.name}]`);
});
Output
- List of teams you have access to
- Created issue with identifier and URL
- Query results showing recent issues
Error Handling
| Error | Cause | Solution |
|---|---|---|
Team not found | Invalid team ID or no access | Use client.teams() to list accessible teams |
Validation error | Missing required fields | Ensure title and teamId are provided |
Permission denied | Insufficient permissions | Check API key scope in Linear settings |
Rate limited | Too many requests | Add delays between requests |
Examples
Complete Hello World Script
import { LinearClient } from "@linear/sdk";
async function helloLinear() {
const client = new LinearClient({
apiKey: process.env.LINEAR_API_KEY
});
// 1. Get current user
const viewer = await client.viewer;
console.log(`Hello, ${viewer.name}!`);
// 2. List teams
const teams = await client.teams();
const team = teams.nodes[0];
console.log(`Using team: ${team.name}`);
// 3. Create issue
const result = await client.createIssue({
teamId: team.id,
title: "Hello from Linear SDK!",
description: "Testing the Linear API integration.",
priority: 2, // Medium priority
});
if (result.success) {
const issue = await result.issue;
console.log(`Created: ${issue?.identifier}`);
}
// 4. Query issues
const issues = await client.issues({ first: 5 });
console.log(`\nYour latest ${issues.nodes.length} issues:`);
issues.nodes.forEach(i => console.log(` - ${i.identifier}: ${i.title}`));
}
helloLinear().catch(console.error);
Using GraphQL Directly
const query = `
query Me {
viewer {
id
name
email
}
}
`;
const response = await fetch("https://api.linear.app/graphql", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": process.env.LINEAR_API_KEY,
},
body: JSON.stringify({ query }),
});
const data = await response.json();
console.log(data);
Resources
Next Steps
After creating your first issue, proceed to linear-sdk-patterns for best practices.
More by jeremylongshore
View allRabbitmq Queue Setup - Auto-activating skill for Backend Development. Triggers on: rabbitmq queue setup, rabbitmq queue setup Part of the Backend Development skill category.
evaluating-machine-learning-models: This skill allows Claude to evaluate machine learning models using a comprehensive suite of metrics. It should be used when the user requests model performance analysis, validation, or testing. Claude can use this skill to assess model accuracy, precision, recall, F1-score, and other relevant metrics. Trigger this skill when the user mentions "evaluate model", "model performance", "testing metrics", "validation results", or requests a comprehensive "model evaluation".
building-neural-networks: This skill allows Claude to construct and configure neural network architectures using the neural-network-builder plugin. It should be used when the user requests the creation of a new neural network, modification of an existing one, or assistance with defining the layers, parameters, and training process. The skill is triggered by requests involving terms like "build a neural network," "define network architecture," "configure layers," or specific mentions of neural network types (e.g., "CNN," "RNN," "transformer").
Oauth Callback Handler - Auto-activating skill for API Integration. Triggers on: oauth callback handler, oauth callback handler Part of the API Integration skill category.
