Linear Todo Sync

Fetch open Linear tasks via GraphQL and generate a markdown todo list.

Updated Feb 24, 2013

Search Tags:#automation #markdown #API #GraphQL #linear #todo #task-management

Ready to run

npx skills add https://github.com/ysano/dotfiles --skill linear-todo-sync-ysano

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Linear Todo Sync
Source: https://github.com/ysano/dotfiles/tree/main/claude-home/skills/linear-todo-sync
Command: npx skills add https://github.com/ysano/dotfiles --skill linear-todo-sync-ysano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, mdutils, python-dotenv, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

The Linear Todo Sync skill eliminates the manual task of collecting, filtering, and organizing Linear issues assigned to you, and presents them as a clear, up-to-date markdown todo list in your project root.

Core Features & Use Cases

Automatic task collection: Fetches open tasks assigned to you from Linear via GraphQL and groups them by project with metadata (state, priority, estimates, due dates, labels).
Markdown task list: Generates a readable, checkable markdown file suitable for standups, planning, and daily reviews.
Use Case: When asked "Load my Linear tasks" Claude outputs a ready-to-edit todo sheet with direct links to Linear items.

Quick Start

Use the skill to fetch your assigned Linear tasks and generate a markdown file in the project root.

Frequently Asked Questions about Linear Todo Sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I export my assigned Linear tasks to a markdown todo list?▼

Export assigned Linear tasks to a markdown todo list by running a GraphQL query that fetches your open issues and generates a checklist file with metadata like state, priority, and due dates in your project root.

What is the best way to prepare for standups using my Linear task list?▼

Preparing for standups using your Linear task list is best done by generating a markdown file that automatically groups your assigned open issues by project, giving you a readable checklist to review progress and blockers.

Do I need a Linear API key to fetch open tasks for sprint planning?▼

Yes, you need a Linear API key to fetch open tasks for sprint planning. The skill uses a GraphQL query against the Linear API, requiring environment configuration via python-dotenv to authenticate and retrieve your assigned issues.

Can I automatically group Linear issues by project with priority and due dates?▼

Automatically grouping Linear issues by project with priority and due dates is supported. The skill parses the GraphQL API response and generates a markdown file containing metadata for state, priority, estimates, due dates, and labels.

Does Linear Todo Sync work with Python scripts and markdown generation?▼

Linear Todo Sync works with Python scripts and markdown generation. It relies on the requests library for the GraphQL API call and the mdutils library to build the markdown todo list file directly in your project root.

Why does my Linear task export show only open issues in the markdown file?▼

Your Linear task export shows only open issues because the GraphQL query is specifically filtered to fetch open tasks assigned to you, ensuring the generated markdown todo list reflects current work for daily reviews and planning.