Skip to content

wrsmith108/linear-claude-skill

Managing Linear issues, projects, and teams. Use when working with Linear tasks, creating issues, updating status, querying projects, or managing team workflows.

FileKindSize
SKILL.mdskill md22.7 KB
scripts/__tests__/bulk-create.test.tsscript5.0 KB
scripts/__tests__/issue-description.test.tsscript6.8 KB
scripts/__tests__/lin-cli.test.tsscript3.8 KB
scripts/__tests__/lint-issues.test.tsscript2.3 KB
scripts/__tests__/retry.test.tsscript8.2 KB
scripts/__tests__/smoke.test.tsscript7.0 KB
scripts/__tests__/validate-description.test.tsscript4.3 KB
scripts/build.mjsscript1.4 KB
scripts/bulk-create.tsscript12.5 KB
scripts/create-initiative-update.tsscript5.8 KB
scripts/create-issue-with-project.tsscript8.0 KB
scripts/create-project-update.tsscript5.5 KB
scripts/extract-image.tsscript2.2 KB
scripts/lib/agent-selection.tsscript8.7 KB
scripts/lib/exit-codes.tsscript357 B
scripts/lib/index.tsscript3.1 KB
scripts/lib/initiative.tsscript5.0 KB
scripts/lib/issue-description.tsscript7.1 KB
scripts/lib/labels.tsscript7.6 KB
scripts/lib/lin-cli.tsscript7.3 KB
scripts/lib/linear-utils.tsscript9.3 KB
scripts/lib/project-template.tsscript8.8 KB
scripts/lib/retry.tsscript4.8 KB
scripts/lib/taxonomy-data.tsscript8.1 KB
scripts/lib/taxonomy-validation.tsscript10.0 KB
scripts/lib/taxonomy.tsscript3.6 KB
scripts/lib/verify.tsscript6.6 KB
scripts/linear-api.mjsexecutablescript12.1 KB
scripts/linear-ops.tsscript69.1 KB
scripts/lint-issues.tsscript6.9 KB
scripts/phase-complete.tsscript12.4 KB
scripts/query.shexecutablescript498 B
scripts/query.tsscript3.5 KB
scripts/run.shexecutablescript321 B
scripts/setup.tsscript8.6 KB
scripts/sync-skill-version.mjsscript2.0 KB
scripts/sync.tsscript5.7 KB
scripts/upload-image.tsscript4.4 KB

scripts/query.ts

View on GitHub
#!/usr/bin/env npx tsx

/**
 * Execute ad-hoc GraphQL queries against the Linear API
 *
 * Usage:
 *   LINEAR_API_KEY=lin_api_xxx npx tsx query.ts "query { viewer { id name } }"
 *   LINEAR_API_KEY=lin_api_xxx npx tsx query.ts "query { viewer { id name } }" '{"var": "value"}'
 */

import { LinearClient } from '@linear/sdk';

interface GraphQLErrorResponse {
  errors: Array<{
    message: string;
    locations?: Array<{ line: number; column: number }>;
    path?: Array<string | number>;
  }>;
}

function hasGraphQLErrors(error: unknown): error is Error & GraphQLErrorResponse {
  return (
    error instanceof Error &&
    'errors' in error &&
    Array.isArray((error as Record<string, unknown>).errors)
  );
}

async function main() {
  const apiKey = process.env.LINEAR_API_KEY;

  if (!apiKey) {
    console.error('\n========================================');
    console.error('  LINEAR_API_KEY Not Found');
    console.error('========================================\n');
    console.error('To fix this:\n');
    console.error('  1. Go to Linear -> Settings -> Security & access -> Personal API keys');
    console.error('  2. Click "Create key" and copy the key (starts with lin_api_)');
    console.error('  3. Set it in your environment:\n');
    console.error('     # Option A: Export in current shell');
    console.error('     export LINEAR_API_KEY="lin_api_your_key_here"\n');
    console.error('     # Option B: Add to shell profile (~/.zshrc or ~/.bashrc)');
    console.error('     echo \'export LINEAR_API_KEY="lin_api_..."\' >> ~/.zshrc\n');
    console.error('     # Option C: Add to Claude Code environment');
    console.error('     echo \'LINEAR_API_KEY=lin_api_...\' >> ~/.claude/.env\n');
    console.error('Or run the full setup check:');
    console.error('  npx tsx setup.ts\n');
    console.error('Usage once configured:');
    console.error('  npx tsx query.ts "query { viewer { id name } }"\n');
    process.exit(1);
  }

  // Validate key format
  if (!apiKey.startsWith('lin_api_')) {
    console.error('\n[WARNING] LINEAR_API_KEY has unexpected format');
    console.error('Expected format: lin_api_... (got: ' + apiKey.substring(0, 10) + '...)');
    console.error('This may cause authentication failures.\n');
  }

  const query = process.argv[2];
  const variablesArg = process.argv[3];

  if (!query) {
    console.error('Error: Query argument is required');
    console.error('');
    console.error('Usage:');
    console.error('  LINEAR_API_KEY=lin_api_xxx npx tsx query.ts "query { viewer { id name } }"');
    console.error('  LINEAR_API_KEY=lin_api_xxx npx tsx query.ts "query($id: String!) { issue(id: $id) { title } }" \'{"id": "ISSUE_ID"}\'');
    process.exit(1);
  }

  let variables = {};
  if (variablesArg) {
    try {
      variables = JSON.parse(variablesArg);
    } catch (_error) {
      console.error('Error: Variables must be valid JSON');
      console.error(`Received: ${variablesArg}`);
      process.exit(1);
    }
  }

  const client = new LinearClient({ apiKey });

  try {
    const result = await client.client.rawRequest(query, variables);
    console.log(JSON.stringify(result.data, null, 2));
  } catch (error) {
    console.error('Error executing query:');

    if (hasGraphQLErrors(error)) {
      console.error(error.message);
      console.error('\nGraphQL Errors:');
      console.error(JSON.stringify(error.errors, null, 2));
    } else if (error instanceof Error) {
      console.error(error.message);
    } else {
      console.error(error);
    }

    process.exit(1);
  }
}

main();
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall