maji-todolisted
Install: claude install-skill Ijam18/MAJI-Skills
# maji-todo — Codebase TODO Extractor
A skill that scans a codebase for TODO/FIXME/HACK comments and outputs a triaged list — by category, by file, by age. Helps you decide what to address vs what to delete.
---
## When to Use
Type `maji-todo <target>` where target is:
- Whole repo (`maji-todo .`)
- Subfolder (`maji-todo src/`)
- Specific file (`maji-todo src/auth.ts`)
Optional filters — just ask in plain language (this is a skill, not a CLI):
- "only stale ones" — items whose line was **last edited** > 30 days ago (via `git blame`)
- "by <author>" — filter by the author `git blame` last attributes
- "FIXME only" / "just the HACKs" — filter by tag
---
## What Gets Captured
### Tag Categories (default)
| Tag | Meaning | Default urgency |
|---|---|---|
| `TODO` | Future work, not blocking | 🟢 Low |
| `FIXME` | Known bug, should fix | 🟡 Medium |
| `HACK` | Workaround, technical debt | 🟡 Medium |
| `XXX` | Mark of caution / surprise | 🟡 Medium |
| `BUG` | Confirmed bug | 🔴 High |
| `NOTE` | Important context | ⚪ Info |
| `WARNING` | Future hazard | 🟡 Medium |
### What's Captured
- Tag type
- File:line
- Comment text
- Author (via git blame)
- Last touched (days since the line was last edited, via `git blame` — approximate; `git blame` reports the last edit, not when the comment was first introduced)
---
## Output Format
```
[N] TODOs found in [target]
🔴 High Priority (BUG)
──────────────────��──
src/auth.ts:42 — BUG: token refresh fails on Safari
Author: