Trace

Skill mirkobozzetto/arsenal/plugins/trace/skills/trace

Mirko Bozzetto's curated skills for AI coding agents (Claude Code, Codex, Cursor, ...)

Install

npx -y skills add mirkobozzetto/arsenal --skill trace

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

12 stars12 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Read or hand-write the project progress ledger (.claude/trace.md). Use when the user says "/trace", "what did I do", "log this", "trace done", or wants to record or review what moved this session. The automatic Stop hook already logs file changes; this skill is the reader and the manual writer for the intent the hook cannot infer.

SKILL.md

2.1 KB, as published. Nobody here has run it

trace

One ledger: <project_root>/.claude/trace.md. The Stop hook writes mechanical entries automatically (which files changed, each turn that touched files). This skill is the reader and the manual writer for the why the hook cannot infer. It never invents a second format - it shells out to the same script.

Routing

Let S = ${CLAUDE_PLUGIN_ROOT}/skills/trace/scripts/trace.cjs. Run from the project root (so the ledger and git detection resolve to this repo).

/trace (no args) -> read recent entries:
```
node "$S" --read 12
```
Print the output as-is. Do not summarize unless asked.
/trace done <what> [flags] -> write one clean entry:
```
node "$S" done "<what>" [--files a,b] [--id N.x] [--status shipped|in_progress|wip] [--context prd:<slug>]
```
Map the user's words to <what>. Pass --files when they name files, --id for a prd Unit (N.x) or rfc task (T0n), --status shipped when the work is truly done and verified (default wip). Context is inferred from the files when omitted.
Anything else after /trace -> treat the free text as the <what> of a done entry, status wip, unless the user clearly meant to read.

Notes

The hook covers automatic capture; only reach for done when the user wants to record intent ("note that I finished the auth refactor") that bare file paths do not convey.
--status shipped is a claim of verified-done, not attempted. Use the user's evidence, do not upgrade a wip to shipped on your own.
For the entry format and how this relates to ship's per-run trace.md, see references/format.md.