Linear Skill для Claude Code

Комплексный скилл Claude Code для управления задачами, проектами и командами в Linear. Предоставляет паттерны для работы с MCP-инструментами, автоматизации через SDK и прямого доступа к GraphQL API.

Возможности

• Предварительная компиляция через esbuild — запуск CLI в 18 раз быстрее (~50 мс против ~1 с) с прозрачным fallback на tsx через общий scripts/run.sh
• Система таксономии меток — метки на основе доменов для единообразной категоризации и маршрутизации агентов
• Проверка при первом запуске — автоматическая валидация конфигурации с конкретными рекомендациями
• Высокоуровневые операции — простые команды для инициатив, проектов и обновления статусов
• Управление подзадачами — создание и управление связями родитель-потомок
• Проверка перед созданием — обязательные проверки для предотвращения дублирования проектов и задач
• Интеграция MCP-инструментов — простые операции через Linear MCP-сервер
• Автоматизация через SDK — сложные операции с TypeScript-скриптами
• GraphQL API — прямой доступ к API для продвинутых запросов
• Управление проектами — контент, описания, вехи, ссылки на ресурсы
• Массовая синхронизация — синхронизация изменений кода с Linear через CLI, агентов или хуки
• Загрузка изображений — загрузка изображений в S3-хранилище Linear и прикрепление к задачам
• Smoke-тесты — автоматическая проверка результатов сборки и поведения CLI
• Интеграция lin CLI — опциональный быстрый путь через Rust-бинарник aaronkwhite/linear-cli с тихим fallback на SDK

Быстрый старт (для новых пользователей)

1. Установка скилла

git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear
cd ~/.claude/skills/linear && npm install

2. Запуск проверки настройки

Команда проверяет конфигурацию и сообщает, чего именно не хватает.

3. Получение API-ключа (при необходимости)

1. Откройте Linear в браузере
2. Перейдите в Settings → Security & access → Personal API keys
3. Нажмите Create key и скопируйте ключ (начинается с lin_api_)
4. Добавьте в окружение:

# Добавить в профиль оболочки
echo 'export LINEAR_API_KEY="lin_api_your_key_here"' >> ~/.zshrc
source ~/.zshrc

4. Проверка работоспособности

Должны отобразиться ваше имя и организация.

5. Сборка для ускорения запуска (опционально)

Предварительно компилирует TypeScript в JavaScript — холодный старт CLI ускоряется примерно в 18 раз. Без сборки команды работают через tsx (медленнее, но функционально).

6. Начало работы

# Создать инициативу
npm run ops -- create-initiative "My Project"

# Создать проект
npm run ops -- create-project "Phase 1" "My Project"

# Создать подзадачу под родительской
npm run ops -- create-sub-issue ENG-100 "Add tests" "Unit tests for feature"

# Установить связи родитель-потомок для существующих задач
npm run ops -- set-parent ENG-100 ENG-101 ENG-102

# Обновить статус задачи
npm run ops -- status Done ENG-123 ENG-124

# Показать все команды
npm run ops -- help

Установка

# Клонировать напрямую в директорию скиллов
git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear
cd ~/.claude/skills/linear && npm install

Предварительные требования

• Linear API Key — создаётся в Linear → Settings → Security & access → Personal API keys
• lin CLI (опционально) — ускоряет выполнение обновлений статусов, поиска и листингов:
  bashКопировать

  brew install aaronkwhite/tap/lin    # macOS (Homebrew)
  cargo install lincli                # Любая платформа с Rust

  Установите LINEAR_USE_LIN=0, чтобы отключить даже при наличии установленного бинарника.
• Linear MCP Server (рекомендуется) — используйте официальный Linear MCP-сервер для максимальной надёжности:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.linear.app/sse"],
      "env": {
        "LINEAR_API_KEY": "your_api_key"
      }
    }
  }
}

Важно: всегда используйте официальный MCP-сервер Linear по адресу mcp.linear.app. НЕ используйте устаревшие сторонние серверы: linear-mcp-server (npm) или jerhadf/linear-mcp-server (GitHub).

Структура директорий

Ключевые паттерны

Проверка перед созданием (критически важно!)

ВСЕГДА проверяйте Linear перед созданием проектов или задач. Это предотвращает дублирование:

# Проверить существующие проекты
linear projects list | grep -i "phase\|feature-name"

# Проверить существующие задачи
linear issues list --filter "title:keyword"

См. SKILL.md → «Discovery Before Creation» для полного чеклиста.

Проверка кодовой базы перед началом работы (критически важно!)

ВСЕГДА проверяйте состояние кодовой базы, прежде чем принимать описание задачи за чистую монету.

Описания задач могут быть устаревшими или предположительными. API или функции могут быть уже реализованы!

# Перед началом работы над задачами «реализовать API»:
ls src/pages/api/admin/members/     # Проверить наличие файлов
grep -r "test.skip" tests/          # Проверить пропущенные тесты

См. SKILL.md → «Codebase Verification» для полного чеклиста.

Конфигурация

Документация

• SKILL.md — основные инструкции и паттерны для Claude Code
• api.md — примеры GraphQL-запросов и мутаций
• sdk.md — паттерны автоматизации через TypeScript SDK
• sync.md — паттерны массовой синхронизации
• docs/labels.md — система таксономии меток

Лицензия

MIT