К основному содержанию
скилл CX Codex

Linear Todo Sync — скилл для Claude Code: задачи из Linear в markdown

Скилл Linear Todo Sync для Claude Code собирает открытые задачи из Linear в Markdown-файл в корне проекта. Формирует список дел на день.

MIT ★ 1 357 обновлён 2026-03-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add qdhenry/Claude-Command-Suite --skill linear-todo-sync -a claude-code
Открыть на GitHub

Что делает Linear Todo Sync

Скилл обращается к GraphQL API Linear и забирает все назначенные вам задачи в незавершённых статусах. По каждой задаче подтягиваются название, описание, статус, приоритет, метки, оценка, срок, проект и ссылка. Затем всё это группируется по проектам и записывается в файл linear-todos-YYYY-MM-DD.md в корне проекта.

Для работы нужен Python 3.7+ и пакеты requests, mdutils, python-dotenv. Ключ LINEAR_API_KEY должен лежать в .env в корне проекта, иначе скрипт упадёт с ошибкой «LINEAR_API_KEY not found in environment». Сам .env стоит добавить в .gitignore, чтобы ключ не утёк в репозиторий.

Запустить проверку можно напрямую: python .claude/skills/linear-todo-sync/scripts/sync_linear_tasks.py. Если задач нет, файл всё равно создастся — просто с нулевым количеством. У Linear действует лимит 2000 запросов в час на ключ, поэтому синхронизацию не стоит дёргать без остановки.

Какие задачи решает

  • собрать открытые задачи из Linear в один файл
  • сгруппировать задачи по проектам с приоритетами и сроками
  • посмотреть список дел на утро одной командой
  • создать markdown-отчёт с задачами в корне проекта

Примеры запросов агенту

  • Что мне нужно сделать сегодня утром?
  • Синхронизируй мои задачи из Linear.
  • Покажи мои рабочие задачи и собери их в файл.

Как установить Linear Todo Sync

1Через Skills CLI (Vercel)

npx skills add qdhenry/Claude-Command-Suite --skill linear-todo-sync -a claude-code

2Вручную: положить файлы

~/.claude/skills/linear-todo-sync/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/linear-todo-sync/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о Linear Todo Sync

Как установить Linear Todo Sync в Claude Code?

Выполните npx skills add qdhenry/Claude-Command-Suite --skill linear-todo-sync -a claude-code. Скилл появится в ~/.claude/skills/linear-todo-sync/SKILL.md.

Что делает Linear Todo Sync?

Забирает через Linear GraphQL API все назначенные вам задачи в незавершённых статусах и генерирует markdown-файл linear-todos-YYYY-MM-DD.md с группировкой по проектам.

Что нужно для работы скилла?

Python 3.7+ и пакеты requests, mdutils, python-dotenv. В .env в корне проекта должен быть ключ LINEAR_API_KEY, иначе скрипт не запустится.

Исходный текст

SKILL.md · MIT
---
name: Linear Todo Sync
description: This skill fetches open tasks assigned to the user from the Linear API and generates a markdown todo list file in the project root. This skill should be used when the user asks about their work items, wants to see what they need to work on, or requests to load/sync their Linear tasks. Requires Python 3.7+, requests, mdutils, and python-dotenv packages. Requires LINEAR_API_KEY in .env file.
allowed-tools: Read, Write, Bash, Glob
license: MIT
---

# Linear Todo Sync

Automatically fetch assigned Linear tasks and generate a comprehensive markdown todo list in your project root. This skill queries the Linear GraphQL API to retrieve all open tasks assigned to you, organizing them by project with full details including status, priority, labels, estimates, and due dates.

## Setup

### 1. Install Required Packages

Install the Python dependencies:

```bash
pip install requests mdutils python-dotenv
```

Or using conda:

```bash
conda install requests python-dotenv
pip install mdutils
```

### 2. Obtain Linear API Key

1. Navigate to [Linear API Settings](https://linear.app/settings/api)
2. Click "Create new key" under Personal API Keys
3. Give it a descriptive name (e.g., "Claude Code Sync")
4. Copy the generated API key

### 3. Configure Environment

Create a `.env` file in your project root:

```bash
cp .claude/skills/linear-todo-sync/assets/.env.example .env
```

Edit `.env` and add your API key:

```
LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

**Important**: Ensure `.env` is in your `.gitignore` to protect your API key.

### 4. Verify Setup

Test the configuration by running:

```bash
python .claude/skills/linear-todo-sync/scripts/sync_linear_tasks.py
```

A markdown file named `linear-todos-YYYY-MM-DD.md` should appear in your project root.

## How It Works

When triggered, this skill:

1. **Loads credentials** from the `.env` file in your project root
2. **Queries Linear API** using GraphQL to fetch all assigned issues in non-completed states
3. **Retrieves task details** including title, description, status, priority, labels, estimates, due dates, project, and URL
4. **Groups tasks by project** for better organization
5. **Generates markdown file** with filename `linear-todos-YYYY-MM-DD.md` in the project root
6. **Outputs summary** showing total tasks and project count

The generated markdown file provides a comprehensive view of your work with all relevant task metadata, making it easy to review priorities and plan your day.

## Usage

Trigger this skill with phrases like:

- "What do I need to work on this morning"
- "Show me my work"
- "Load work"
- "Sync my Linear tasks"
- "Get my todo list from Linear"

The skill will execute the sync script and create a dated markdown file in your project root.

## Generated File Format

The markdown file follows this structure:

```markdown
# Linear Tasks - January 18, 2025

Generated: 2025-01-18 09:30:45
Total Tasks: 12

## Project Alpha

### Implement user authentication (High)
- **Status**: In Progress
- **Labels**: backend, security
- **Estimate**: 5 points
- **Due**: 2025-01-20
- **Link**: https://linear.app/team/issue/PROJ-123

Add JWT-based authentication to the API endpoints...

### Fix login bug (Urgent)
- **Status**: Todo
- **Labels**: bug, frontend
- **Estimate**: 2 points
- **Due**: 2025-01-19
- **Link**: https://linear.app/team/issue/PROJ-124

Users cannot log in when using Safari...

## Project Beta

...
```

## Customization

To modify the skill's behavior, edit `scripts/sync_linear_tasks.py`:

### Change GraphQL Query

Modify the `QUERY` variable to fetch additional fields:

```python
QUERY = """
query {
  viewer {
    assignedIssues(filter: { state: { type: { nin: ["completed", "canceled"] } } }) {
      nodes {
        id
        title
        description
        state { name }
        priority
        labels { nodes { name } }
        estimate
        dueDate
        project { name }
        url
        # Add more fields here
        createdAt
        updatedAt
        assignee { name }
      }
    }
  }
}
"""
```

### Adjust Task Filtering

Modify the filter in the GraphQL query to change which tasks are fetched:

```python
# Include completed tasks from the last week
filter: {
  state: { type: { nin: ["canceled"] } }
  completedAt: { gte: "2025-01-11" }
}
```

### Modify Output Format

Customize the markdown generation in the `generate_markdown()` function to change structure, add sections, or include different metadata.

### Change Output Location

Update the `output_path` variable in `main()`:

```python
# Save to a different directory
output_path = os.path.join(project_root, "docs", filename)
```

## Troubleshooting

### Error: "LINEAR_API_KEY not found in environment"

**Cause**: The `.env` file is missing or doesn't contain the API key.

**Solution**:
1. Verify `.env` exists in your project root (not in the skill directory)
2. Check that it contains: `LINEAR_API_KEY=lin_api_...`
3. Ensure no extra spaces around the `=` sign
4. Restart your terminal session if you just created the file

### Error: "Authentication failed: Invalid API key"

**Cause**: The API key is incorrect or expired.

**Solution**:
1. Go to [Linear API Settings](https://linear.app/settings/api)
2. Verify your API key is still active
3. Generate a new key if needed
4. Update `.env` with the correct key

### Error: "Network request failed"

**Cause**: Cannot connect to Linear API (network issue, timeout, or API downtime).

**Solution**:
1. Check your internet connection
2. Verify https://linear.app is accessible
3. Check [Linear Status](https://status.linear.app) for outages
4. Try again in a few moments

### Error: "Rate limit exceeded (429)"

**Cause**: Too many API requests in a short period.

**Solution**:
- Wait 60 seconds before retrying
- Avoid running the sync multiple times in quick succession
- Linear's rate limit is 2000 requests per hour per API key

### Warning: "No tasks found"

**Cause**: You have no assigned tasks in non-completed states.

**Solution**: This is informational only. The skill will still create a markdown file indicating zero tasks.

### Error: "Permission denied when writing file"

**Cause**: Insufficient file system permissions.

**Solution**:
1. Check you have write permissions in the project directory
2. Verify the directory exists and is accessible
3. Try running with appropriate permissions

### Script runs but no file appears

**Cause**: File created in unexpected location or script error.

**Solution**:
1. Check the script output for the exact file path
2. Look for error messages in the console
3. Run with verbose output: `python scripts/sync_linear_tasks.py --verbose`

## Security Best Practices

1. **Never commit `.env` file**: Always add `.env` to `.gitignore`
2. **Rotate API keys periodically**: Generate new keys every 90 days
3. **Use minimal permissions**: Linear API keys inherit your user permissions
4. **Keep packages updated**: Run `pip install --upgrade requests mdutils python-dotenv`
5. **Review generated files**: Check markdown files before sharing to ensure no sensitive data

## Advanced Usage

### Automated Daily Sync

Add to your shell profile (`.bashrc`, `.zshrc`) to sync on terminal startup:

```bash
# Auto-sync Linear tasks daily
if [ -f "/path/to/project/.env" ]; then
  python /path/to/project/.claude/skills/linear-todo-sync/scripts/sync_linear_tasks.py
fi
```

### Integration with Git Hooks

Create a post-checkout hook to sync after changing branches:

```bash
#!/bin/bash
# .git/hooks/post-checkout
python .claude/skills/linear-todo-sync/scripts/sync_linear_tasks.py
```

### CI/CD Integration

Use in continuous integration to track team tasks:

```yaml
# .github/workflows/sync-tasks.yml
- name: Sync Linear Tasks
  run: |
    pip install requests mdutils python-dotenv
    python .claude/skills/linear-todo-sync/scripts/sync_linear_tasks.py
  env:
    LINEAR_API_KEY: ${{ secrets.LINEAR_API_KEY }}
```

## Additional Resources

- [Linear GraphQL API Documentation](https://developers.linear.app/docs/graphql/working-with-the-graphql-api)
- [Linear API Reference](https://studio.apollographql.com/public/Linear-API/variant/current/home)
- [Python Requests Documentation](https://requests.readthedocs.io/)
- [MDUtils Documentation](https://github.com/didix21/mdutils)

For detailed API reference and advanced GraphQL queries, see the Linear API documentation.

© qdhenry · MIT · qdhenry/Claude-Command-Suite

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
linear-cli schpet Скилл linear-cli для Claude Code управляет задачами, проектами и документами Linear через CLI. Срабатывает по запросам о Linear и ID вроде ENG-123. CX Codex +1 16 900установок sync-issues-to-linear davila7 Команда sync-issues-to-linear для Claude Code переносит GitHub issues в Linear, сопоставляя поля, метки и исполнителей. Синхронизирует все задачи или выборку по фильтрам. CX Codex +1 128установок sync-linear-to-issues davila7 Команда sync-linear-to-issues переносит задачи из Linear в задачи GitHub с сохранением статусов, приоритетов и вложений. Пригодится при переезде команды разработки на единый трекер в GitHub. CX Codex +1 123установок Linear Ryan Smith Управляет задачами, проектами и командами в Linear через MCP, утилиту Linear CLI или вспомогательные скрипты прямо в сессии агента. CX Codex +1 ★ 141звёзд репо linear-claude-skill wrsmith108 Связывает его с Linear для работы с задачами, проектами и командами. Создаёт и обновляет рабочие элементы и синхронизирует их. ★ 141звёзд репо linear-cost-tuning Jeremy Longshore Скилл linear-cost-tuning снижает расход квот и нагрузку на API Linear: заменяет частый поллинг вебхуками и урезает избыточную сложность запросов GraphQL. CX Codex +1 1установок

Из того же набора112

Весь набор →
nextjs-pro Субагент nextjs-pro помогает проектировать и развивать приложения на Next.js: от App Router и рендеринга до тестов, SEO и оптимизации. CX Codex ★ 1 357звёзд репо retrospective-analyzer Команда retrospective-analyzer собирает метрики спринта из Linear и Git, ищет повторы в прошлых ретро и готовит отчёт с темами для обсуждения и action items. CX Codex +1 ★ 1 357звёзд репо boundary-guardian Субагент boundary-guardian для Claude Code, который отслеживает границы знаний модели и предупреждает галлюцинации через расчёт семантического напряжения. CX Codex ★ 1 357звёзд репо react-pro Субагент react-pro помогает создавать React-компоненты, менять существующий код и разбирать сложные задачи интерфейса. Учитывает устройство проекта и предлагает проверять изменения тестами. CX Codex ★ 1 357звёзд репо reasoning-validator Субагент reasoning-validator под именем Euclid проверяет логические цепочки с помощью формул WFGY и числовых метрик. Помогает находить логические ошибки в рассуждениях ассистента. CX Codex ★ 1 357звёзд репо strategic-analyst Субагент strategic-analyst моделирует технические и продуктовые сценарии, строит деревья решений и связывает планы с задачами в Linear. CX Codex ★ 1 357звёзд репо svelte-testing Субагент svelte-testing для Claude Code пишет тесты для Svelte и SvelteKit — от компонентов до E2E-сценариев. Проверяет поведение интерфейса и серверные функции. CX Codex ★ 1 357звёзд репо logic-synthesizer Субагент logic-synthesizer раскладывает сложную задачу на несколько параллельных путей решения, взвешивает каждый и собирает один ответ из лучших частей. CX Codex ★ 1 357звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой