What credentials are required to use this skill?

You need a Personal API Key generated from your Linear settings, which must be stored as LINEAR_API_KEY in a .env file in your project root.

Where does the skill save my task list?

The skill generates a dated markdown file (e.g., linear-todos-2025-01-18.md) directly in the root directory of your current project.

How do I ensure my Linear API key remains secure?

You should always add your .env file to your .gitignore list to prevent sensitive API keys from being committed to version control.

Can I customize which tasks are synchronized?

Yes, you can modify the Python script's GraphQL query to change filters, fetch additional fields, or adjust how tasks are sorted.

Does this skill work with Python environments?

Yes, it requires Python 3.7+ and the installation of the requests, mdutils, and python-dotenv packages.

Linear Todo Sync

Name: Linear Todo Sync
Author: LopeWale

byLopeWale

0•

生产力与工作流

Synchronizes assigned Linear tasks into a structured markdown todo list within your local project environment.

This skill streamlines project management by bridging the gap between your Linear issue tracker and your local development workspace. By querying the Linear GraphQL API, it automatically generates a comprehensive markdown file containing all your open tasks, organized by project and enriched with critical metadata like priority, status, estimates, and due dates. It is an essential tool for developers who want to maintain deep focus within their IDE while staying perfectly aligned with team sprint goals and individual assignments without needing to switch to a browser.

主要功能

01Automatic generation of dated markdown todo lists

02Includes direct deep links to Linear issues

03Customizable GraphQL queries for advanced task filtering

04GraphQL-powered integration with the Linear API

050 GitHub stars

06Task organization grouped by project and priority

使用场景

01Reviewing task priorities and estimates without leaving the terminal

02Generating a daily plan of attack directly in the project root

03Maintaining a local record of work items for offline reference

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lopewale/ampllabs linear-todo-sync

For use in Claude.ai and ChatGPT