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

0•

Productividad y Flujo de Trabajo

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

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.

Características Principales

01Automated scanning of TODO comments across source code, templates, and tests

02Bi-directional synchronization between code comments and docs/TODOS.md

03Intelligent filtering to exclude node_modules, .venv, and other non-source directories

04Cross-referencing syntax to link code comments directly to specific lines in documentation

05Workflow guidance for classifying, updating, and removing completed tasks

060 GitHub stars

Casos de Uso

01Standardizing task management across a development team by linking code-level tasks to a centralized list

02Aligning a project roadmap in docs/TODOS.md with technical debt markers in the source

03Identifying and cleaning up stale or forgotten TODO comments during refactoring sessions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add shoichiro-suzuki/ip-support-app todo-sync

For use in Claude.ai and ChatGPT

Características Principales

01Automated scanning of TODO comments across source code, templates, and tests

02Bi-directional synchronization between code comments and docs/TODOS.md

03Intelligent filtering to exclude node_modules, .venv, and other non-source directories

04Cross-referencing syntax to link code comments directly to specific lines in documentation

05Workflow guidance for classifying, updating, and removing completed tasks

060 GitHub stars

Casos de Uso

01Standardizing task management across a development team by linking code-level tasks to a centralized list

02Aligning a project roadmap in docs/TODOS.md with technical debt markers in the source

03Identifying and cleaning up stale or forgotten TODO comments during refactoring sessions