How does the skill identify TODO items?

It uses grep to scan the specified directory for patterns like FIXME or TODO, targeting relevant files such as .mojo source files.

Does it support automated merging?

Yes, it utilizes the GitHub CLI (gh) to create pull requests and enable auto-merge following successful CI status checks.

What happens if a CI test is flaky?

The skill includes an execution pattern to specifically handle flaky CI by automatically rerunning failed jobs via the GitHub CLI.

Can it handle items blocked by external dependencies?

Yes, the skill includes a categorization phase that identifies external blockers, ensuring Claude only attempts to resolve actionable items.

Is this skill specific to the Mojo language?

While the default workflow is optimized for Mojo and Pixi environments, the core logic for discovery and PR management can be adapted for any programming language.

FIXME & TODO Cleanup Manager

Name: FIXME & TODO Cleanup Manager
Author: mvillmow

bymvillmow

•

Productivity & Workflow

Automates the identification, categorization, and resolution of technical debt through a systematic FIXME and TODO cleanup workflow.

The FIXME/TODO Cleanup Skill helps developers maintain high code quality by automating the lifecycle of technical debt resolution. It scans directories for FIXME and TODO markers, classifies them by urgency and type, and then follows a rigorous workflow to fix issues, run tests, and manage GitHub pull requests. By integrating with tools like Mojo, Pixi, and the GitHub CLI, it enables a 'one fix per commit' strategy with automated merging to keep project momentum high and technical debt low. This is particularly effective for pre-release sweeps and consolidating scattered documentation notes into actionable issues.

Key Features

01Resilient CI handling with automated retries for flaky test runs

02Intelligent categorization of actionable items versus external blockers

03Built-in integration for Mojo testing and Pixi environment runners

04Standardized Git workflow with automated branch and PR creation

05Automated discovery of FIXME and TODO markers across directories

0612 GitHub stars

Use Cases

01Automating repetitive code migrations and decorator updates

02Consolidating technical debt into a structured issue tracking system

03Performing a code quality sweep before a major production release

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mvillmow/projectodyssey fixme-todo-cleanup

For use in Claude.ai and ChatGPT

Download Skill