Add Linear skill for issue and project management

[wrsmith108]

Summary

Adds a comprehensive skill for managing Linear issues, projects, and teams with Claude Code.

Features

• MCP Tool Integration: Patterns for using Linear MCP server for common operations (create/update issues, search, comments)
• SDK Automation: TypeScript script templates for complex workflows involving loops, bulk updates, and conditional logic
• GraphQL API Reference: Direct API access documentation for advanced use cases
• Best Practices: Critical insights including:
  • Content vs description field usage (255 char limit on description, unlimited markdown on content)
  • Project status management with status UUIDs
  • Resource links and milestone patterns for projects/initiatives

Files Added

• skills/linear/SKILL.md - Main skill instructions and patterns
• skills/linear/api.md - GraphQL API reference
• skills/linear/sdk.md - SDK automation script patterns
• skills/linear/scripts/query.ts - GraphQL query runner utility
• skills/linear/LICENSE.txt - MIT license

Prerequisites

Users need to configure the Linear MCP server in .mcp.json:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "your_api_key"
      }
    }
  }
}

Test Plan

• Skill files follow repository structure (SKILL.md with proper frontmatter)
• License file included (MIT)
• Marketplace.json updated to include skill in example-skills plugin
• Manual testing with Claude Code using Linear MCP

Context

This skill was developed through real-world usage managing the 021 School Platform project, capturing patterns and best practices for effective Linear integration with Claude Code.

🤖 Generated with Claude Code