Skip to content

Resolve FIXME Comments

Finds every FIXME in a codebase and implements the work those comments describe.

Stars
7,638
Licence
Apache-2.0
Files
2 files

What it does

When you ask the agent to fix or resolve FIXME comments, it first runs a bundled shell script that searches the project for FIXME markers and shows each one with nearby lines of code. It then reads the full comment blocks, groups related FIXMEs that span several files into one task, and makes the complete code changes those comments ask for. It removes a FIXME only after the work is done, then re-runs the search to confirm none remain.

Great for

  • Maintainers of Rust or other codebases who have accumulated many FIXME notes and want them actioned
  • Developers doing a multi-file refactor that was described in scattered FIXME comments

Skip it if

  • Projects where FIXMEs are informal reminders that should not be acted on automatically, since the skill has no skip path and will attempt every one
  • Codebases that do not run cargo or where the verification command does not apply, because the final check assumes a Rust project with cargo insta

Try asking

  • “Resolve all FIXME comments in this repository”
  • “Fix the FIXMEs in the src/services directory”
  • “Address the FIXME notes about the session type refactor”
Step-by-step guide: how to use Resolve FIXME CommentsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the Apache-2.0 licence and an attribution note.

    resolve-fixme.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip resolve-fixme.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip resolve-fixme.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Point the request at a specific path to limit how much code the agent changes.
  • Review the diff afterwards, since large grouped refactors touch many files at once.
  • Make sure the working tree is committed or clean first so changes are easy to inspect or revert.

What's inside

  • scripts/find-fixme.sh
  • SKILL.md

Redistributed unmodified from tailcallhq/forgecode under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.