leek/agent-skills / skills/scratch-status
scratch-status
VerifiedReport what is still open across .scratch/ and the next skill to run for each effort. Read-only.
Scratch Status
A quick answer to "what's left to do in .scratch/", with nothing written or removed. For
the full sweep (filing research, removing done efforts, judging contradictions), that is
scratch-cleanup; this skill only ever reports.
$ARGUMENTS is an effort slug to scope to .scratch/<slug>/ alone; empty means every effort.
In Claude Code with the leek-skills plugin, /scratch [slug] shows the effort board live in a pane without a turn; point the user at it for a quick look. You cannot read that board, so always run the steps below: they add the commit-ancestry checks and the per-artifact report the board lacks.
1. Scan .scratch/
From inside the repository, run bash <this-skill-dir>/scripts/scratch-state.sh $ARGUMENTS once (<this-skill-dir> is this skill's directory).
The script walks .scratch/ (or .scratch/<slug>/ when scoped), reads .agents/triage-labels.md
(fallback docs/agents/triage-labels.md) when present, parses frontmatter and legacy Status:
lines across maps, specs, decisions/, tickets/ (or legacy issues/), and triage request
files, checks every cited commit SHA against default_branch (git merge-base --is-ancestor,
merged PRs via gh api, git cherry, and commit subject match), and emits one JSON object
ranking efforts most urgent first:
- done: every file's status is closed or the wontfix role string, every cited commit is on
default_branch, and nothing contradicts (mismatchisnull). A spec with tickets is closed by derivation: it is complete (spec.complete) once every ticket is closed, whatever its own status, because nothing writesclosedonto it. A spec with no tickets was implemented directly and needs its own closed status. - mismatched: fails the contradiction check (
mapstill open whilespec.mdexists, a closed ticket whose cited commit is missing fromdefault_branch, or a file with no readable status). - open: has any open file, with
stale: truewhen its newest file is older than 30 days (a tracked file's last commit, an untracked file's modification time).
These rules are the source of truth; the /scratch board's hooks/mods/scratch-scan.ts must
change with them, so a drift shows as the board and this report disagreeing. Two things stay
skill-only: the cited-commit check, and the also alternatives.
Done when scripts/scratch-state.sh has returned the JSON state for every effort in scope.
2. Report
One block per effort in efforts, in the order the script returned them (unblocked open work,
then blocked open work, then stale, then mismatched, then done). A done effort collapses to
one line:
`.scratch/<slug>/` — done, last change <last_change>. Next: `/scratch-cleanup`. Every other
effort gets the full block:
### `.scratch/<slug>/`: <open | mismatched> · last change <date><, stale>
<⚠️ mismatched: <mismatch> | ⚠️ stale: no change in <stale_days> days>
**Map**: <title>, <status>. Destination: <one line>.
**Spec**: <title>, <status | complete>. <problem, one line>. <n> open questions.
**Decisions**: <n> open of <n>
| # | Decision | Status | Resolution or blocker |
|---|---|---|---|
| 01 | <title> | closed | <resolution, one line> |
| 02 | <title> | blocked | by 01 |
**Tickets**: <n> open of <n>
| # | Ticket | Status | Detail |
|---|---|---|---|
| 01 | <title> | ready | |
| 02 | <title> | blocked | by 01 |
| 03 | <title> | in progress | claimed by <claimant> |
| 04 | <title> | closed | <short SHA>, on <default-branch> |
**Next**: `<command>`: <why, one line>.
<Also: up to two alternatives, one line each, only when they exist.>
Section rules:
- An absent artifact gets one line, so its absence is visible:
**Map**: none.,**Spec**: none.,**Decisions**: none.,**Tickets**: none.Older efforts'issues/folder reports as Tickets; a loose triage request file inrequestsgets its own line,**Request** <file>: <title>, <status>. - List every decision and ticket, closed ones too, in number order.
- Status uses
derived_status(closed,in progress,blocked,ready, orunreadable, which you print as⚠️ unreadable; whenwontfixis true, saywontfixin Detail). - Detail for a ticket:
open_blockers(by 01, 03),claimed_by, or for a closed ticket its citedcommits(<sha>, on <default_branch>or⚠️ <sha> missing). Empty when there is nothing to say. A decision's last column is itsresolutiononce closed, itsopen_blockersorclaimed_bywhile open. - The heading carries the plain words
mismatchedandstale, never a mark. The ⚠️ status line under it appears only for a mismatched or stale effort; an effort that is neither has no such line. - Spec prints
completein place of the status whenspec.completeis true and the spec's own status is not closed. - Mark nothing else with ⚠️: only stale, mismatched, unreadable, and missing commits.
- Next uses
nextandnext_why; when mismatched,nextis the contradiction already on the ⚠️ status line, so Next printsnext_whyalone. Also prints the entries inalsowhen non-empty.
After the last block, one line naming any path in unreadable_efforts, then a one-line total
from counts: <open> open, <stale> stale, <mismatched> mismatched, <done> done. Stop there:
no plan, no questions, no approval prompt.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |