Does it work with different programming languages?

Yes, because it relies on regex patterns via ripgrep, it can identify TODO comments in almost any text-based source file, including Python, JavaScript, HTML, and more.

What is the syntax for linking code to the master TODO list?

You can use a specific reference format such as '// TODO[docs/TODOS.md:L12] explanation' to link a code-level task directly to its corresponding line in the documentation.

How does TODO Sync find comments in my code?

It uses a specialized script powered by ripgrep to efficiently scan your project files for TODO patterns while automatically ignoring irrelevant directories like node_modules and .venv.

Can it update my documentation automatically?

Yes, the skill provides a structured workflow to extract scan results, classify them, and format them as actionable checkboxes within your docs/TODOS.md file.

TODO Sync Manager

Name: TODO Sync Manager
Author: shoichiro-suzuki

byshoichiro-suzuki

Productivity & Workflow

Synchronizes in-code TODO comments with central documentation to maintain a single source of truth for project tasks.

About

The todo-sync skill automates the process of identifying, tracking, and reconciling tasks scattered across a codebase. By utilizing ripgrep to scan for TODO comments and cross-referencing them with a central docs/TODOS.md file, it ensures that project documentation remains up-to-date while providing clear links between high-level tasks and specific lines of code. This skill is particularly useful for developers who want to prevent 'TODO rot' and ensure that small code-level reminders are captured in the broader project roadmap, making it easier to manage technical debt and feature progress.

Key Features

Automated scanning of TODO comments across source code, templates, and tests
Bi-directional synchronization between code comments and docs/TODOS.md
Intelligent filtering to exclude node_modules, .venv, and other non-source directories
Cross-referencing syntax to link code comments directly to specific lines in documentation
Workflow guidance for classifying, updating, and removing completed tasks
0 GitHub stars

Use Cases

Standardizing task management across a development team by linking code-level tasks to a centralized list
Aligning a project roadmap in docs/TODOS.md with technical debt markers in the source
Identifying and cleaning up stale or forgotten TODO comments during refactoring sessions

About

Key Features

Automated scanning of TODO comments across source code, templates, and tests
Bi-directional synchronization between code comments and docs/TODOS.md
Intelligent filtering to exclude node_modules, .venv, and other non-source directories
Cross-referencing syntax to link code comments directly to specific lines in documentation
Workflow guidance for classifying, updating, and removing completed tasks
0 GitHub stars

Use Cases

Standardizing task management across a development team by linking code-level tasks to a centralized list
Aligning a project roadmap in docs/TODOS.md with technical debt markers in the source
Identifying and cleaning up stale or forgotten TODO comments during refactoring sessions