# Markdown Sweep Todos

> Find TODO comments in the codebase and add them to .llm/todo.md as tasks.

- Skill: `motlin/markdown-sweep-todos` (Agent Skill)
- Install (CLI): `npx skillmds@latest add motlin/markdown-sweep-todos`
- Raw SKILL.md: https://api.skillmd.com/api/skills/motlin/markdown-sweep-todos/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: motlin (https://skillmd.com/u/motlin)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/motlin/markdown-sweep-todos

---


# Markdown Sweep TODOs

Use the `markdown-tasks` skill for task format and script path rules.

Search the codebase for TODO comments. For each occurrence, capture:

- File path.
- Line number.
- Full TODO text with comment markers removed.

Compose all TODO tasks before writing. Add the complete batch in one shell command by chaining one call per TODO with `&&`:

```bash
python <plugin-root>/scripts/task_add.py .llm/todo.md "Implement TODO from <file>:<line>: <todo text>" && \
python <plugin-root>/scripts/task_add.py .llm/todo.md "Implement TODO from <another-file>:<line>: <todo text>"
```

Never add a multi-TODO batch across separate shell commands. Keeping the writes together reduces the chance that concurrent sessions interleave their tasks.

Report how many TODO tasks were added.