1
    πŸ“Œ TODO FIXME Extractor

    πŸ“Œ TODO FIXME Extractor

    by JustHandled Labs

    List every TODO, FIXME, HACK, XXX, BUG, and OPTIMIZE comment in your codebase with file, line, and tag. Scans 14 languages, groups the results by tag with counts, and skips node_modules, dist, build, and vendor. A clean tech-debt inventory instead of scrolling grep output.

    Updated Jun 2026
    0 installs

    Free

    Included in download

    • Downloadable skill package
    • Works with Cursor, Codex CLI
    • 2 permissions declared
    • Instant install

    Sample input

    Scan my current repository and list all the technical debt comments you find, grouped by their type.

    Sample output

    Tech Debt Audit Findings:

    • FIXME [auth.py:42]: Session timeout logic is hardcoded.
    • TODO [db/connector.py:12]: Migrate to connection pooling in v2.
    • HACK [utils/parser.py:89]: Regex fix for edge case; need proper lexer.
    • BUG [api/routes.py:101]: Intermittent 500 error here.

    About This Skill

    What it does

    The TODO FIXME Extractor is a specialized developer tool designed to automatically inventory technical debt markers embedded in your source code. It scans your repository to identify and categorize comments labeled with TODO, FIXME, HACK, XXX, and BUG, providing a structured report of where your code needs attention.

    Why use this skill

    Manual Grepping for comments is inefficient and prone to noise. This skill provides a clean, actionable audit of tech debt by extracting the exact file path, line number, and comment context. Use it to:

    • Audit project health before a release or sprint planning.
    • Onboard to a new codebase by identifying known issues and shortcuts.
    • Quantify technical debt across different modules.
    • Filter out noise from dependency and build directories automatically.

    How it works

    By invoking this skill, your agent executes a targeted scan of your source files. It returns a categorized list of findings, including the specific tag used and the developer's notes, allowing you to scope cleanup work without manually hunting through files.

    Use Cases

    • Generate a comprehensive audit of technical debt markers across all files
    • Locate specific HACK and XXX markers before a production release
    • Quantify existing debt to assist in sprint planning and task prioritization
    • Onboard to new projects by identifying documented shortcuts and bugs

    Reviews

    No reviews yet - be the first to share your experience.

    Only users who have downloaded or purchased this skill can leave a review.

    Security Scanned

    Passed automated security review

    Permissions

    Terminal / Shell
    Read Files

    File Scopes

    todo-fixme-extractor/**
    **/*.py
    **/*.js
    **/*.ts
    **/*.jsx
    **/*.tsx
    **/*.go
    **/*.java
    **/*.rb
    **/*.php
    **/*.c
    **/*.cpp
    **/*.cs
    **/*.rs
    **/*.md

    Read-only. Prints each hit with rule id, file, line, tag, and the comment text, plus per-tag counts. Ignores node_modules, .git, dist, build, and vendor. Writes nothing and reads no environment variables.

    Tags

    tech-debt
    code-audit
    productivity
    static-analysis
    maintenance

    Works with any agent that can read a repo and run a local Python script (Claude Code, Cursor, Codex CLI, and other SKILL.md-compatible agents). Standard library only, no install step. Read-only.

    Creator

    JustHandled Labs

    JustHandled Labs creates focused agent skills and workflow packs for Claude, Codex, Cursor, and AI-assisted builders. Each tool is designed around a real repeatable task: cleaner commits, better PRs, stronger handoffs, safer repo hygiene, clearer documentation, and less copy-paste chaos. The goal is not generic AI productivity. The goal is specific workflows that are easier to run, review, and repeat. Maintained by H.J. Westerfield, with a background in communications, editing, project coordination, customer support, and practical AI systems. JustHandled Labs builds tools for people who want useful automation without theatrical complexity.

    Frequently Asked Questions

    Learn More About AI Agent Skills

    More Premium Skills

    inline-comment

    inline-comment

    Best way to steer your agents, effortlessly.

    $9.994 installs

    designing-hybrid-context-layers

    Architects the right retrieval strategy for every query β€” teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.

    $1015 installs

    consumer-motivation-analyzer

    Go beyond surface-level feedback to uncover the psychological drivers and hidden motivations behind buyer behavior.

    $199 installs

    keyword-research

    Transform URLs or product lists into SEO keyword research packs with Google Ads data and intent-based clustering.

    $77 installs

    Free