Skip to content
Skills Library
Management & product · Planning

task-tracker

/task-tracker

Task tracking per project folder with an HTML board. Use for "track this", importing plan progress, resuming work, what is left/ready, task dependencies, the board, and every request where a [task-tracker] notice is present.

Repository
rafal-tools ↗
Licence
MIT
Last repository change
11.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
10
Scripts
5
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 11.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 5 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/chain-lib.mjs, scripts/chain.mjs, scripts/chain.test.mjs, scripts/tt.mjs, scripts/tt.test.mjs

What it does and when to use it

Task tracking per project folder with an HTML board. Use for "track this", importing plan progress, resuming work, what is left/ready, task dependencies, the board, and every request where a [task-tracker] notice is present.

Triggers from the description

track this
Original author description

Task tracking per project folder with an HTML board. Use for "track this", importing plan progress, resuming work, what is left/ready, task dependencies, the board, and every request where a [task-tracker] notice is present.

How it works

  1. 1. One task per independent unit
  2. 2. Record progress
  3. 3. Resume cheaply
Original SKILL.md headings · 45 lines, 702 words
SKILL.md preview
---
name: task-tracker
description: Task tracking per project folder with an HTML board. Use for "track this", importing plan progress, resuming work, what is left/ready, task dependencies, the board, and every request where a [task-tracker] notice is present.
---

# Task Tracker

`tt` = `node "<this skill's base directory>/scripts/tt.mjs"`; hook notices print the exact path. Never type `tt` literally. Write only through the CLI; `tt help` lists every command. Keep token use minimal: open reference files only when their topic comes up, and never read the tracker's data files directly.

| When | Do |
|---|---|
| Invoked with no request (e.g. bare `/rafal-tools:task-tracker`) | `tt usage`, show its output unchanged in a code block, then stop |
| "track this" / "track <folder>" | `tt init [dir] [--name ".."]`. After a first init, follow `references/import.md` unless the user wants to start empty. Never init a folder the user did not mark |
| Import or re-assess plans | `references/import.md` |
| Dependencies (also across projects) | `references/dependencies.md` |
| Board location, moving it, config | `references/data-location.md` |
| "What is left?" / "what is ready?" | `tt list` / `tt list --ready` |
| Change a task's goal, title or work-done text | `tt goal <ID> ".."` / `tt rename <ID> ".."` / `tt summary <ID> ".."` |
| Stop / resume tracking · board · all projects | `tt off` / `tt on` · `tt open` · `tt projects` |
| Archive / restore tasks | `tt archive <ID>...` / `tt unarchive <ID>...`; archived tasks are hidden and never hold up dependents. Mention tasks it reports as ready |
| Role chain (Opus, Codex, Sonnet, Haiku stages) | `tt chain new "Name" ["Description"]`. `tt chain run` needs the user's confirmations, so never run it yourself: give the user the exact command for their own terminal |

No `[task-tracker]` notice: with hooks installed the folder is untracked, so do nothing. Without hooks (other agents, standalone install), run `tt resume` once per session; "not tracked" means do nothing.

## 1. One task per independent unit
- Every request that changes the project maps to at least one task. Questions and read-only turns need no tracker call.
- A plan with N tasks becomes N tasks sharing one `--group`. For more than 3, use `tt bulk <temp folder>/t.json` (scratchpad or OS temp, never the repo) with `[{"title","goal","group","next":[..],"deps":["#1"]}]`.
- A task is finishable and verifiable on its own. Split anything larger than a session.
- `--goal` holds the outcome and acceptance criteria in 1–2 sentences.
- A follow-up continues the existing task; never duplicate it.
- If a task needs another task's output, add `--dep T-004`.

## 2. Record progress
Use as few calls as possible; one per task per turn is usually enough. Unknown flags are rejected.
1. Before working: `tt start <ID>`, or for a new task `tt add "Title" --goal ".." --start`. Both refuse tasks that wait for dependencies; use `tt start --force` only if the user insists. `tt log` never changes the status; when it reminds you that a task is still todo and you are working on it, run `tt start`.
2. Before ending a turn, for every task you touched: `tt log <ID> "what was done" --next "step" [--next ".."] [--note "durable context"]`. `--next` replaces the next steps, so make them concrete (files, functions, commands). `--note` keeps decisions and gotchas.
3. Verified → `tt done <ID> --summary "what was built and where"`, then mention any tasks it reports as ready. Stuck → `tt status <ID> blocked --note "why"`.
4. The stop hook checks only turns that edited project files. If those edits were not task work → `tt skip`.

## 3. Resume cheaply
1. Use the session-start list or `tt resume`.
2. Pick, in this order: the task the user names, the first in-progress task, the first ready todo. Never pick one marked `WAITS FOR`; name its dependencies and offer to do them first.
3. Load only that task with `tt show <ID>`. It shows the last 5 log entries; use `--full` only if needed. Do not reload the original plan when the task file suffices.
4. Phrases:
   - "continue" → the first in-progress task;
   - "resume/start T-005" → `tt start` it if it is todo;
   - "T-004 is unblocked: …" → `tt log` the reason, then `tt start`.
5. Tell the user in one line which task you are resuming and its next step, then continue.
Files in this package (10)
  • SKILL.md 4 KB
  • references/data-location.md 2 KB
  • references/dependencies.md 2 KB
  • references/import.md 2 KB
  • scripts/chain-lib.mjs 9 KB
  • scripts/chain.mjs 5 KB
  • scripts/chain.test.mjs 11 KB
  • scripts/tt.mjs 57 KB
  • scripts/tt.test.mjs 9 KB
  • templates/board.html 44 KB

Versions

The database has no other skills named task-tracker.

Database snapshot: 13.11.2026 · package version 7a793901a0ce (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90build-tracker
    Live HTML progress page for multi-step work - current task with elapsed time, done tasks with durations, to-do tasks with estimates, overall ETA, updating in real time. Use when the user says "set up the build tracker", "track progress of this work", "show me task progress", or…
  • 95obsidian-tracker-task
    Create a new task in an Obsidian project with kanban board. Use when the user invokes /task.
  • 100agent-ticket-tracker
    Agent-kept TRACKER.md, the owner's single entry point for a repo (what needs them, what runs, what is next, what is done). Use when the owner asks to set up a tracker, or when a task starts, changes state, needs the owner, or finishes in a repo that has TRACKER.md.
  • 100planning-and-progress-tracking
    Plan substantial multi-step work in a structured tracking folder and keep task status, dependencies, decisions, model and effort choices, and resumable handoffs accurate. Use for roadmaps, execution plans, trackers, progress updates, and work spanning sessions, chats, or subagents.
  • 100harness-progress
    Generate a Progress Tracker HTML for non-engineer vibecoders to glance at session progress (cc:WIP / cc:TODO / cc:done counts, percentage, elapsed/estimated minutes, cost so far/estimate, drift alerts). Uses Plans.md as source of truth, renders a single-file HTML with…
  • 100board
    The user's desktop task board (cstatus). Use when you take on a user request that takes more than a couple of minutes, make visible progress, need something from the user (an answer, a merge, a deploy, a decision), get blocked, or finish; and when asked "show/update the board",…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.