К основному содержанию
скилл CX Codex

todo-archive — скилл для Claude Code: что делает и как установить

Скилл todo-archive переносит выполненные задачи из .ai/TODO.md в ежедневные архивы. Оставляет незакрытые пункты на месте.

MIT 130 установок ★ 107 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add PaulRBerg/agent-skills --skill todo-archive -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/todo-archive/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/todo-archive/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
Linear Todo Sync qdhenry Скилл Linear Todo Sync для Claude Code собирает открытые задачи из Linear в Markdown-файл в корне проекта. Формирует список дел на день. CX Codex +1 ★ 1 357звёзд репо todo-tracker jdrhyne Скилл todo-tracker ведёт список задач в локальном Markdown-файле и сохраняет стабильные ID между сессиями. Попросите добавить, найти, завершить или удалить задачу. CX Codex +1 ★ 239звёзд репо todo davila7 Ведёт список задач в файле todos.md в корне проекта. Добавляет, завершает и удаляет задачи через слэш-команду. CX Codex +1 2 723установок todo-branch qdhenry Команда todo-branch для Claude Code пошагово реализует задачи из списка в текущей ветке Git, запрашивая подтверждение на каждом этапе и создавая один итоговый коммит. CX Codex +1 ★ 1 357звёзд репо question_moved_to_todo nwverse Субагент question_moved_to_todo для Claude Code переносит вопрос без ответа в список задач пользователя. Он ждёт решения, а агент продолжает работу, не зависящую от этого вопроса. CX Codex ★ 395звёзд репо glab-todo vince-winkintel Скилл glab-todo для Claude Code управляет списком задач GitLab через CLI. Он показывает назначенные и упомянутые задачи, а также отмечает их выполненными. CX Codex +1 115установок

Из того же набора16

Весь набор →
cli-cast Скилл cli-cast управляет операциями Foundry Cast: готовит, симулирует, подписывает и отправляет транзакции. Также кодирует ABI и подписывает сообщения. CX Codex +1 309установок spreadsheets Скилл spreadsheets для Claude Code проверяет структуру CSV, TSV и .xlsx, правит нужные строки и столбцы и пересчитывает формулы. Работает с таблицей как основным файлом задачи. CX Codex +1 267установок vitest Руководство для ИИ-агентов по написанию и отладке тестов на Vitest в проектах на Node, Bun или React. CX Codex +1 186установок evm-atlas Скилл evm-atlas для Claude Code собирает проверяемые сведения о сетях EVM, кошельках и транзакциях. Показывает балансы, историю переводов и данные о DeFi-позициях. CX Codex +1 153установок agents-introspection Скилл agents-introspection изучает локальные транскрипты Codex и Claude Code, чтобы найти повторяющиеся сбои поведения агентов и предложить точечную правку. CX Codex +1 123установок frontend-design Скилл frontend-design для Claude Code, Codex и Cursor создаёт веб-интерфейсы и лендинги с проработанной визуальной частью. Он задаёт арт-дирекцию и проверяет результат в отрисованном интерфейсе. CX Codex +1 111установок node-deps-bumper Скилл node-deps-bumper для Claude Code и Codex строит структурированный план обновлений пакетов через Taze и сверяет тесты до и после изменений. Запускается при обновлении зависимостей npm, pnpm, yarn или bun. CX Codex +1 106установок release-bumper Скилл release-bumper для Claude Code автоматизирует выпуск релизов в репозитории. Подготавливает версионирование, пишет changelog, делает коммиты и проставляет аннотированные теги. CX Codex +1 105установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой