feat: add Claude Code skills for linear-cli operations

Add structured skill files that Claude Code can load when performing
Linear operations. Skills cover: issues, PRs, search, and uploads.

Author: Finesssee

.claude/skills/linear-issues/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: linear-issues
+description: Manage Linear issues - list, create, update, start/stop work. Use when working with Linear issues, viewing tasks, creating bugs, or updating issue status.
+allowed-tools: Bash
+---
+
+# Linear Issues
+
+Manage Linear.app issues using the `linear-cli` command-line tool.
+
+## List Issues
+
+```bash
+# List all issues
+linear-cli i list
+
+# Filter by team
+linear-cli i list -t Engineering
+
+# Filter by status
+linear-cli i list -s "In Progress"
+
+# Get JSON output (for parsing)
+linear-cli i list --output json
+```
+
+## View Issue Details
+
+```bash
+# View issue details
+linear-cli i get LIN-123
+
+# Get as JSON
+linear-cli i get LIN-123 --output json
+```
+
+## Create Issues
+
+```bash
+# Create issue (priority: 1=urgent, 2=high, 3=medium, 4=low)
+linear-cli i create "Bug: Login fails" -t Engineering -p 2
+
+# Create with status
+linear-cli i create "Feature request" -t ENG -s "Backlog"
+```
+
+## Update Issues
+
+```bash
+# Update status
+linear-cli i update LIN-123 -s Done
+
+# Update priority
+linear-cli i update LIN-123 -p 1
+```
+
+## Start/Stop Work
+
+```bash
+# Start working (assigns to you, sets In Progress, creates git branch)
+linear-cli i start LIN-123 --checkout
+
+# Stop working (unassigns, resets status)
+linear-cli i stop LIN-123
+```
+
+## Comments
+
+```bash
+# List comments
+linear-cli cm list LIN-123
+
+# Get comments as JSON
+linear-cli cm list LIN-123 --output json
+
+# Add comment
+linear-cli cm create LIN-123 -b "Fixed in latest commit"
+```
+
+## Tips
+
+- Use `--output json` for machine-readable output
+- Short alias: `i` for issues, `cm` for comments
+- Run `linear-cli i --help` for all options

.claude/skills/linear-pr/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: linear-pr
+description: Create GitHub PRs linked to Linear issues. Use when creating pull requests, pushing code for review, or linking PRs to Linear issues.
+allowed-tools: Bash
+---
+
+# Linear PR Creation
+
+Create GitHub pull requests linked to Linear issues using `linear-cli`.
+
+## Create PR for Issue
+
+```bash
+# Create PR linked to Linear issue
+linear-cli g pr LIN-123
+
+# Create draft PR
+linear-cli g pr LIN-123 --draft
+
+# Specify base branch
+linear-cli g pr LIN-123 --base main
+
+# Open in browser after creation
+linear-cli g pr LIN-123 --web
+```
+
+## Git Branch Operations
+
+```bash
+# Create and checkout branch for issue
+linear-cli g checkout LIN-123
+
+# Use custom branch name
+linear-cli g checkout LIN-123 -b my-custom-branch
+
+# Just show branch name (don't create)
+linear-cli g branch LIN-123
+
+# Create branch without checkout
+linear-cli g create LIN-123
+```
+
+## Full Workflow
+
+```bash
+# 1. Start working on issue (assigns, sets In Progress, creates branch)
+linear-cli i start LIN-123 --checkout
+
+# 2. Make your changes...
+# git add . && git commit -m "Fix the bug"
+
+# 3. Create PR
+linear-cli g pr LIN-123
+```
+
+## Tips
+
+- PR title and description are auto-generated from issue
+- Use `--draft` for work-in-progress PRs
+- The branch name follows pattern: `username/lin-123-issue-title`

.claude/skills/linear-search/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: linear-search
+description: Search Linear issues and projects. Use when finding issues, looking up bugs, or searching the backlog.
+allowed-tools: Bash
+---
+
+# Linear Search
+
+Search Linear.app issues and projects using `linear-cli`.
+
+## Search Issues
+
+```bash
+# Search issues by text
+linear-cli s issues "authentication bug"
+
+# Limit results
+linear-cli s issues "login" --limit 5
+
+# Get JSON output
+linear-cli s issues "error" --output json
+```
+
+## Search Projects
+
+```bash
+# Search projects
+linear-cli s projects "backend"
+
+# Limit results
+linear-cli s projects "api" --limit 10
+```
+
+## Combine with Filters
+
+After searching, you can get details on specific issues:
+
+```bash
+# Get issue details
+linear-cli i get LIN-123
+
+# Get as JSON for parsing
+linear-cli i get LIN-123 --output json
+
+# List comments on issue
+linear-cli cm list LIN-123 --output json
+```
+
+## Tips
+
+- Search is case-insensitive
+- Searches issue titles and descriptions
+- Use `--output json` for programmatic access

.claude/skills/linear-uploads/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: linear-uploads
+description: Download attachments and images from Linear issues. Use when fetching screenshots, images, or file attachments from Linear comments or descriptions.
+allowed-tools: Bash
+---
+
+# Linear Uploads
+
+Download attachments and images from Linear issues using `linear-cli`.
+
+## Download to File
+
+```bash
+# Download image/attachment to file
+linear-cli up fetch "https://uploads.linear.app/..." -o image.png
+
+# Download screenshot
+linear-cli up fetch "https://uploads.linear.app/abc/def/screenshot.png" -o /tmp/screenshot.png
+```
+
+## Output to Stdout
+
+```bash
+# Pipe to other tools
+linear-cli up fetch "https://uploads.linear.app/..." | base64
+
+# Pipe to file
+linear-cli up fetch "https://uploads.linear.app/..." > file.png
+```
+
+## Finding Upload URLs
+
+Upload URLs are found in:
+- Issue descriptions
+- Comments (use `linear-cli cm list ISSUE_ID --output json`)
+
+URLs follow pattern: `https://uploads.linear.app/{org}/{upload}/{filename}`
+
+## Tips
+
+- Requires valid Linear API key
+- Use `-o` to specify output filename
+- Without `-o`, outputs raw bytes to stdout

.gitignore

@@ -1,4 +1,4 @@
 /target
 
-# Claude Code config
-.claude/
+# Claude Code local settings (not skills)
+.claude/settings.local.json