todo-archive — скилл для Claude Code: что делает и как установить
Скилл todo-archive переносит выполненные задачи из .ai/TODO.md в ежедневные архивы. Оставляет незакрытые пункты на месте.
MIT 130 установок ★ 107 обновлён 2026-10-24
npx skills add PaulRBerg/agent-skills --skill todo-archive -a claude-codeЧто делает todo-archive
Скилл находит корень репозитория и проверяет наличие файла .ai/TODO.md. Отмеченные чекбоксы он вырезает и переносит в файл вида .ai/todos/YYYY-MM/DD.md. Незавершённые задачи и структура разделов остаются в основном списке.
Задачу выполняет скрипт scripts/archive_todo.py, который запускается через команду uv run python. Без установленного Python и пакетного менеджера uv скрипт работать не сможет.
Параметр --hint позволяет архивировать только нужную ветку заголовков по подстроке. Флаг --dry-run показывает итоговые пути и количество задач без записи изменений на диск.
Какие задачи решает
- очистить
.ai/TODO.mdот закрытых чекбоксов - сохранить историю выполненных задач по датам в
.ai/todos/ - архивировать задачи конкретной секции через
--hint - проверить результат переноса без записи через
--dry-run
Примеры запросов агенту
- Архивируй выполненные задачи из
.ai/TODO.md - Запусти архивацию раздела с флагом
--hint backend - Покажи через
--dry-run, какие задачи перенесутся в архив
Как установить todo-archive
1Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill todo-archive -a claude-code2Вручную: положить файлы
~/.claude/skills/todo-archive/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/todo-archive/
1Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill todo-archive -a codex2Вручную: положить файлы
.agents/skills/todo-archive/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill todo-archive -a cursor2Вручную: положить файлы
.cursor/skills/todo-archive/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install PaulRBerg/agent-skills skills/todo-archive2Вручную: положить файлы
.github/skills/todo-archive/SKILL.md1Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill todo-archive -a gemini-cli2Командой платформы
gemini skills install https://github.com/PaulRBerg/agent-skills --path skills/todo-archiveВручную: положить файлы
.devin/skills/todo-archive/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add PaulRBerg/agent-skills --skill todo-archive -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о todo-archive
Как установить todo-archive в Claude Code?
Выполните команду npx skills add PaulRBerg/agent-skills --skill todo-archive -a claude-code.
Что делает todo-archive?
Скилл переносит отмеченные задачи из .ai/TODO.md в файл .ai/todos/YYYY-MM/DD.md за текущую дату. Незакрытые задачи остаются в исходном файле.
Что требуется для работы скрипта архивации?
Скиллу нужны установленный Python и инструмент uv, потому что запуск вспомогательного файла происходит через uv run python.
Исходный текст
SKILL.md · MIT
--- argument-hint: "[path] [--hint TEXT] [--date YYYY-MM-DD|YYYY_MM_DD] [--dry-run]" disable-model-invocation: true effort: low model: sonnet name: todo-archive description: Archive checked `.ai/TODO.md` tasks into `.ai/todos/YYYY-MM/DD.md`, leaving unchecked tasks. --- # TODO Archive If a slash or dollar invocation already added these instructions to the conversation, follow them directly. In that case, do not invoke this skill again through a skill tool. ## Arguments - `path` (optional): Repository root or any path inside the repository. Default to the current directory. - `--hint TEXT` (optional): Archive only the section whose heading contains `TEXT` (case-insensitive substring), including its subsections. Without it, archive checked tasks from the whole file. Checked tasks outside the matched section stay in `.ai/TODO.md`. - `--date YYYY-MM-DD|YYYY_MM_DD` (optional): Archive date. Default to today's local date. - `--dry-run` (optional): Preview target paths and rendered content without writing. ## Workflow 1. Resolve the supplied `path`, or the current directory when omitted. For an existing file, use its containing directory. For a directory, use that directory. Store the absolute directory as `start_dir`, then resolve its Git root: ```sh git -C "$start_dir" rev-parse --show-toplevel ``` Store the result as `repo_root`. When `start_dir` is outside a Git repository, use it as `repo_root`. Stop on a missing input path or another resolution error. 2. Verify `.ai/TODO.md` exists under the root. If it is missing, stop and report the path checked. 3. Resolve the skill directory and run its helper: ```sh uv run python "<skill-dir>/scripts/archive_todo.py" --root "$repo_root" ``` Pass through `--hint`, `--date`, or `--dry-run` when the user requested them. 4. Report the rewritten `.ai/TODO.md`, the created or merged archive path, the matched section (when `--hint` was given), and the archived/remaining task counts. If an archive for the date already exists, the helper appends the new batch to it, retaining one matching top-level heading. If the helper reports no checked tasks, treat it as a no-op. If `--hint` matches no heading, the helper exits non-zero and lists the available sections. In that case, relay them. 5. If useful, inspect only `<repo_root>/.ai/TODO.md` and the exact archive path returned by the helper. Verify their contents directly. When Git ignores them, compare filesystem snapshots rather than relying on `git diff`. ## Helper Behavior `scripts/archive_todo.py` reads `<root>/.ai/TODO.md` and any existing archive for the date, writes archived tasks to `<root>/.ai/todos/YYYY-MM/DD.md`, and rewrites `<root>/.ai/TODO.md` with the remaining tasks. It preserves task-free sections and prose verbatim (a minimal stub with the source's first heading, or `# TODO`, only if everything was archived). With `--hint`, it restricts archiving to the matched heading's subtree and exits non-zero listing available headings when nothing matches. A same-day re-run appends its batch to that day's file, removing the new leading H1 only when it exactly matches the existing archive's leading H1. ## Completion Completion evidence is the helper's archive path plus archived and remaining task counts. A no-checked-task result is a successful no-op. Dry-run completion requires rendered paths/content with no filesystem changes, but the final message still follows the one-line formats below. Report the result as a single line (append a `(scope: "<hint>")` segment only when `--hint` was given), with the archive path relative to the repository root: - Success: `📦 Archived <n> → <archive path> (created|merged) · <remaining> remaining` - No-op: `✅ Nothing to archive · <remaining> remaining` - Dry run: `🔎 Would archive <n> → <archive path> (would create|would merge) · <remaining> would remain` Do not repeat full dry-run document content in the final message or add decoration to TODO/archive files, paths, commands, or helper diagnostics.
© PaulRBerg · MIT · PaulRBerg/agent-skills