agentsclimarketplace
Sign in

Trace

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

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.From its SKILL.md

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.

2 things 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.
  • runs commandsInstructs the agent to run 2 commands, including `node "$S" --read 12` and 1 more.

SKILL.md

2.1 KB, 461 tokens by cl100k_base, 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.

What ships with it: 2 files

9.1 KB alongside SKILL.md, 1 of them executable

references/

scripts/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.