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

todo-tracker · jdrhyne — скилл для Claude Code: задачи и установка

Скилл todo-tracker ведёт список задач в локальном Markdown-файле и сохраняет стабильные ID между сессиями. Попросите добавить, найти, завершить или удалить задачу.

MIT ★ 239 обновлён 2026-08-30

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

Что делает todo-tracker

Задачи хранятся в TODO.md в рабочей папке; путь можно изменить через TODO_FILE. Скилл запускает скрипт scripts/todo.sh для чтения списка и сводки, добавления задач с приоритетом и отметки о завершении. Для каждой новой задачи назначается стабильный ID, а совпадение текста проверяется точно, не по части строки.

Для работы нужны Bash и стандартные утилиты awk, cp, chmod, mkdir, mktemp и mv. Записи защищены блокировкой и атомарным обновлением файла; предыдущая версия сохраняется в .bak. Это важно при удалении: сначала скрипт показывает ID и текст задачи, затем нужно получить подтверждение и повторить команду с тем же ID. Heartbeat выключен, его можно включить только отдельной настройкой; он выдаёт лишь счётчики.

Какие задачи решает

  • добавить задачу с приоритетом и получить её ID
  • показать все задачи или задачи выбранного приоритета
  • отметить задачу завершённой по ID
  • удалить выбранную задачу после подтверждения
  • получить сводку по количеству задач

Примеры запросов агенту

  • Добавь задачу с высоким приоритетом: проверить список релиза.
  • Покажи задачи со средним приоритетом и общую сводку.
  • Найди задачу с ID T000001 и отметь её завершённой.

Как установить todo-tracker

1Через Skills CLI (Vercel)

npx skills add jdrhyne/agent-skills --skill todo-tracker -a claude-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о todo-tracker

Как установить todo-tracker в Claude Code?

Выполните npx skills add jdrhyne/agent-skills --skill todo-tracker -a claude-code. Файл скилла находится по пути ~/.claude/skills/todo-tracker/SKILL.md.

Что делает todo-tracker?

Скилл управляет задачами в локальном Markdown-файле: добавляет их, показывает список и сводку, отмечает завершённые и удаляет после подтверждения. У задач есть стабильные ID.

Что нужно для работы todo-tracker?

Нужны Bash и стандартные утилиты awk, cp, chmod, mkdir, mktemp и mv. Heartbeat по умолчанию выключен.

Исходный текст

SKILL.md · MIT
---
name: todo-tracker
description: Persistent TODO scratch pad for tracking tasks across sessions. Use when the user asks to add, list, complete, remove, or summarize tasks in a portable workspace Markdown file. Uses stable task IDs and exact matching; heartbeat reporting is opt-in and count-only.
---

# TODO Tracker

Maintain a portable Markdown task file without a service or database. Use the bundled script for every operation; do not edit task lines with ad hoc regex commands.

Runtime requirements: Bash and standard `awk`, `cp`, `chmod`, `mkdir`, `mktemp`, and `mv` utilities. Tasks are stored in a user-configurable local Markdown file.

## File and Script

- `TODO_FILE` selects the task file. Default: `TODO.md` in the current workspace.
- Always invoke the bundled script through `{baseDir}` so execution does not depend on the current directory.
- Read operations do not create a file.
- Writes use an adjacent lock, atomic same-directory renames, mode `600`, and a recoverable previous-state backup at `${TODO_FILE}.bak`.
- `${TODO_FILE}.next-id` is an adjacent mode-`600` monotonic ID counter. Keep it with the task file when moving or restoring the tracker; backup rotation must not replace or delete it.

```bash
TODO_FILE="$PWD/TODO.md" bash "{baseDir}/scripts/todo.sh" list
```

Do not use a machine-specific path. Quote `TODO_FILE`, IDs, and item text.

## Stable Identity

New tasks receive monotonic IDs such as `T000001`. Task text is matched literally and exactly, never as a regex or substring.

- Under the same writer lock, the script bootstraps the counter from the current task file, `${TODO_FILE}.bak`, and any valid existing counter. It reserves and atomically persists the next counter value before publishing a task-file mutation, so a crash may create an ID gap but cannot reuse an ID.
- Only the structured ID field immediately after a task checkbox participates in counter bootstrapping. ID-looking text inside a task title remains literal task content and never advances the counter.
- A missing counter is created safely on the next write. A corrupt, symbolic-link, non-regular, or non-`0600` counter fails closed; do not delete or reset it to bypass the check.
- Prefer an ID for `done` and always use an ID for approved removal.
- An exact-text target must match one task only.
- Duplicate open task text is rejected.
- An ambiguous exact-text target is rejected and the script reports the matching IDs.
- On the first operation that must resolve or mutate a legacy file, task lines without IDs are assigned deterministic IDs under the writer lock and the migration is persisted atomically; the original remains in the backup. A removal preview can trigger this recoverable metadata migration even though it removes no task.

## Commands

### Read

```bash
TODO_FILE="$PWD/TODO.md" bash "{baseDir}/scripts/todo.sh" list
TODO_FILE="$PWD/TODO.md" bash "{baseDir}/scripts/todo.sh" list high
TODO_FILE="$PWD/TODO.md" bash "{baseDir}/scripts/todo.sh" summary
```

If the file does not exist, `list` reports that fact and `summary` returns zero counts. Neither creates state.

### Add

```bash
TODO_FILE="$PWD/TODO.md" bash "{baseDir}/scripts/todo.sh" add high "Review launch checklist"
```

Priority must be `high`, `medium`, or `low`. Capture the returned stable ID.

### Complete

```bash
TODO_FILE="$PWD/TODO.md" bash "{baseDir}/scripts/todo.sh" done T000001
```

Exact text is accepted only when it identifies one open task. Completion preserves the stable ID and moves the task to Done.

### Remove

Removal is destructive and requires an exact preview plus action-time approval.

1. Resolve and preview without removing the task. For a legacy file, this first operation may atomically persist stable IDs and the adjacent monotonic counter before returning the preview. The pre-migration file remains in `${TODO_FILE}.bak`, and no task is removed:

   ```bash
   TODO_FILE="$PWD/TODO.md" bash "{baseDir}/scripts/todo.sh" remove "exact task text"
   ```

   The command exits without removal and prints the exact stable ID. Repeating the operation uses the persisted ID rather than migrating or advancing the counter again.

2. Show the user that ID and task text. Ask for approval to remove that exact task.
3. Only after approval, run the command contract naming and confirming the same ID:

   ```bash
   TODO_FILE="$PWD/TODO.md" bash "{baseDir}/scripts/todo.sh" remove T000001 --confirm T000001
   ```

Never infer approval from a partial name, prior unrelated removal, or a bulk request. Remove tasks one exact stable ID at a time.

## Heartbeat

Heartbeat access is off by default. Enable it only when the user explicitly opts in by configuring `TODO_HEARTBEAT_ENABLED=1` for that heartbeat workflow.

```bash
TODO_FILE="$PWD/TODO.md" TODO_HEARTBEAT_ENABLED=1 \
  bash "{baseDir}/scripts/todo.sh" heartbeat
```

Heartbeat output contains counts only: total, high, medium, low, and stale. It never prints task titles or notes. Do not create a schedule merely because this skill is installed.

## File Format

```markdown
# TODO Tracker

*Last updated: 2026-08-29*

## 🔴 High Priority
- [ ] [T000001] Review launch checklist (added: 2026-08-29)

## 🟡 Medium Priority

## 🟢 Nice to Have

## ✅ Done
- [x] [T000002] Verify release notes (done: 2026-08-29)
```

If a write fails because the lock exists, do not remove the lock while another process may be active. Investigate the writer and retry only after the lock is known to be stale.

© jdrhyne · MIT · jdrhyne/agent-skills

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

Все скиллы по теме «Заметки, задачи и проекты» →

Сначала — todo-tracker от других авторов.

todo-tracker sundial-org Скилл todo-tracker для отслеживания задач между сеансами работы. Сохраняет TODO в файл, позволяет добавлять, помечать выполненные и фильтровать по приоритету. Напоминает о застарелых пунктах при каждом запуске. CX Codex +1 176установок todo-archive PaulRBerg Скилл todo-archive переносит выполненные задачи из .ai/TODO.md в ежедневные архивы. Оставляет незакрытые пункты на месте. CX Codex +1 130установок Linear Todo Sync qdhenry Скилл Linear Todo Sync для Claude Code собирает открытые задачи из Linear в Markdown-файл в корне проекта. Формирует список дел на день. CX Codex +1 ★ 1 357звёзд репо new-work Garrick Aden-Buie (@gadenbuie) Скилл new-work для Claude Code ведёт markdown-файл с чек-листом, решениями и ссылками на issue и PR. Хранит контекст задачи между сессиями. CX Codex +1 405установок 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звёзд репо

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

Весь набор →
elegant-reports Скилл elegant-reports собирает PDF из markdown в сдержанной скандинавской вёрстке: брифинги для руководства, аналитические разборы, презентационные страницы. CX Codex +1 ★ 239звёзд репо gsc Скилл gsc подключает Claude Code к Google Search Console в режиме чтения для проверки аналитики поиска, индексации страниц и карт сайта. CX Codex +1 ★ 239звёзд репо senior-engineering Скилл senior-engineering для Claude Code задаёт инженерный порядок для нетривиальных задач: сначала критерии готовности, затем код и чек-лист перед сдачей. CX Codex +1 ★ 239звёзд репо ga4 Запрашивает отчёты и метаданные Google Analytics 4 через GA4 Data API без ручной выгрузки из браузера. CX Codex +1 ★ 239звёзд репо frontend-design Скилл frontend-design для Claude Code задаёт порядок работы над интерфейсом: сначала схема и тема, затем анимация и код. Создаёт лендинги, дашборды и отдельные компоненты. CX Codex +1 ★ 239звёзд репо nudocs Связывает агента с сервисом Nudocs.ai для выгрузки файлов, получения ссылок на совместное редактирование и скачивания готового контента. CX Codex +1 ★ 239звёзд репо jira Скилл помогает читать и искать задачи Jira, готовить черновики и вносить изменения после согласования. Он срабатывает при явном контексте Jira или Atlassian, ссылке Jira либо ключе вроде PROJ-123. CX Codex +1 ★ 239звёзд репо gallery-scraper Скилл gallery-scraper для Claude собирает ссылки на полноразмерные картинки в галерее под логином и скачивает их пачкой через прикреплённую вкладку браузера. CX Codex +1 ★ 239звёзд репо

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

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