Neura Market
wrsmith108/linear-claude-skill logo

wrsmith108/linear-claude-skill

Free

Manage Linear issues, projects, and teams

FreeFree tier
Type
Open Source
Visit Website GitHub (40 stars)

About wrsmith108/linear-claude-skill

Linear Skill for Claude Code is a comprehensive skill that enables managing Linear issues, projects, and teams directly from the Claude Code CLI. It provides multiple integration patterns including MCP tools for simple operations, TypeScript SDK automation for complex workflows, and direct GraphQL API access for advanced queries. Key capabilities include fast esbuild pre-compilation (18x faster startup), domain-based label taxonomy, sub-issue management with parent-child relationships, duplicate prevention via discovery checks, bulk sync between code and Linear, image uploads, and optional integration with the lin CLI Rust binary. The skill includes automatic first-time setup validation and smoke tests.

Key Features

18x faster CLI startup via esbuild pre-compilation
Domain-based label taxonomy system for consistent categorization
First-time setup check with automatic configuration validation
High-level operations for initiatives, projects, and status updates
Sub-issue management with parent-child relationship support
Discovery before creation to prevent duplicate projects/issues
MCP tool integration for simple operations
SDK automation with TypeScript scripts for complex workflows
Direct GraphQL API access for advanced queries
Bulk sync between codebase changes and Linear

Pros & Cons

Pros
  • Fast startup with pre-compilation (~50ms vs ~1s)
  • Comprehensive access through MCP, SDK, and GraphQL patterns
  • Prevents duplicate creation with mandatory discovery checks
  • Supports complex issue hierarchies with sub-issue management
  • Automated setup validation provides actionable guidance for new users
  • Open source and free to use
  • Bulk sync capability bridges code and project management
Cons
  • Requires Linear API key and environment setup
  • Dependent on Linear service availability and API rate limits
  • Initial npm install and optional build steps needed
  • Limited to Linear project management tool only
  • Command-line interface may have learning curve for non-developers

Best For

Create and manage Linear issues, projects, and initiatives from the command lineManage parent-child relationships among issues (sub-issues)Update issue statuses in bulkSync code changes to Linear via CLI, agents, or hooksAutomate project management workflows within Claude Code environmentUpload and attach images to Linear issuesVerify skill installation and configuration with automated checks