Skip to content
cccskills
FreePublished on GitHub

todo-extractor

Finds TODO, FIXME, HACK and XXX comments across a source tree and groups them by tag and file. Use when the user asks for a list of open tasks in the code, wants to plan cleanup work, or needs an inventory of technical debt.

The English summary is being prepared. Showing the original description.

Lethe044/agentskill-kit48 stars(GitHub 48 + cccskills 0)

Run score Not tested

See how to install

Files included (3)

  • SKILL.md1.3 KB
  • scripts/find_todos.py2.2 KB
  • tests/cases.json1.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

TODO extractor

Turns scattered comments into a planning list.

When to use

  • The user asks "what is left to do in this repo?".
  • Planning a cleanup sprint or a release, where known shortcuts must be reviewed.
  • Before archiving or handing over a project.

How to run

python scripts/find_todos.py src/
python scripts/find_todos.py . --tags TODO,FIXME

Hidden folders, node_modules, venv, dist, build and binary files are skipped.

Output

JSON with total, by_tag (counts) and items, a list of {"file", "line", "tag", "text"} sorted by file and line. The exit code is always 0 when the path exists.

After running

  1. Lead with the counts per tag. FIXME and HACK usually matter more than TODO.
  2. Group items by file or folder and point out hot spots.
  3. Propose an order of work, and mark items that look stale (they mention past dates or removed code).

Errors

A path that does not exist exits with code 2.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Runs a list of HTTP checks against a base URL from a JSON file and reports status codes, response time and body assertions. Use when the user asks whether an API is up, wants a smoke test after a deploy, or needs to verify that endpoints return what the docs promise.

The English summary is being prepared. Showing the original description.

Lethe044/agentskill-kit48Updated Oct 26, 2026

Turns git log output into a grouped markdown changelog using conventional commit prefixes such as feat, fix and docs. Use when the user prepares a release, asks for release notes, or wants a summary of what changed between two tags.

The English summary is being prepared. Showing the original description.

Lethe044/agentskill-kit48Updated Oct 26, 2026

Writes clear git commit messages in the conventional commits style from a diff or a description of the change. Use when the user asks for a commit message, wants to tidy up a message before pushing, or has staged changes and no wording yet.

The English summary is being prepared. Showing the original description.

Lethe044/agentskill-kit48Updated Oct 26, 2026

Profiles a CSV file column by column, reporting inferred type, missing values, unique counts and min, max and mean for numeric columns. Use when the user hands over a CSV and asks what is in it, whether the data is clean, or what to check before analysis.

The English summary is being prepared. Showing the original description.

Lethe044/agentskill-kit48Updated Oct 26, 2026

Checks a Dockerfile for common problems such as unpinned base images, running as root, ADD instead of COPY, secrets in ENV or ARG and apt-get without cleanup. Use when the user asks to review, harden or slim down a Dockerfile.

The English summary is being prepared. Showing the original description.

Lethe044/agentskill-kit48Updated Oct 26, 2026

Compares a .env file with its .env.example template and reports missing keys, undocumented extra keys, empty values and example files that contain real looking secrets. Use when the user asks why an app fails on startup with missing configuration, or wants to check environment files before committing.

The English summary is being prepared. Showing the original description.

Lethe044/agentskill-kit48Updated Oct 26, 2026

See all skills by Lethe044

Report a problem with this skill