linear-todo-sync

Name: linear-todo-sync
Rating: 5 (834 reviews)
Author: qdhenry

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.

TL;DR

Fetches user's open Linear tasks and generates a markdown todo list in project root.

What Is It

Fetches assigned tasks from Linear API
Generates a markdown todo list file
Organizes tasks by project with full details
Requires LINEAR_API_KEY in .env

Key Features

Queries Linear GraphQL API for open tasks
Groups tasks by project for clarity
Includes status, priority, labels, estimates, and due dates
Creates dated markdown file in project root
Supports custom filtering and output formatting
Outputs total tasks and project count

How to Use

1.Install required Python packages
2.Get a Linear API key and save it in .env
3.Run the sync script from project root
4.Trigger with phrases like 'show me my work' or 'sync my tasks'

Guardrails & Gotchas

MUST have LINEAR_API_KEY in .env
CRITICAL: .env must be in project root, not skill directory
FORBIDDEN: do not commit .env to version control
MUST ensure write permissions for output directory
RATE LIMIT: 2000 requests/hour per key

GitHub Stats

Author

@qdhenry

Repository

qdhenry/Claude-Command-Suite

Stars

834

Explore More Skills

move-code-quality

@davila7

Analyzes Move language packages against the official Move Book Code Quality Checklist. Use this skill when reviewing Move code, checking Move 2024 Edition compliance, or analyzing Move packages for best practices. Activates automatically when working with .move files or Move.toml manifests.

12.4k

1.1k

1w ago

linear-todo-sync

Explore More Skills

move-code-quality

e2e-testing-patterns

testing-anti-patterns