session-finishlisted
Install: claude install-skill niksavis/basicly
<!-- Generated by `basicly skills-build` from skill.yaml. Do not edit; edit the source. -->
# Session Finish
## Scope
Owns the end-of-session ritual: report what the session actually used
(tools and skills, from recorded telemetry), run the self-improvement
retro, and leave the repo pickup-clean with a handoff summary.
It is **not** for shipping the work itself — commits, gates, and issue
closure belong to the loop and its skills (`harness-loop`, `tool-br`,
`conventional-commits`). Run this after the work has landed.
## 1) Usage statistics
The `tool-usage` PostToolUse hook counts every shell command's pipeline
heads and every `Skill` invocation into `.basicly/usage/tool-usage.json`
(git-ignored, survives between sessions). Report it with:
```sh
basicly usage report
```
- The report tables terminal tools and skills by count with `last used`
dates, and names never-used catalog skills — the culling candidates.
- The counter file accumulates across sessions by design; do not reset or
delete it. When the command reports no usage data, say so (the hook may
not be active in this repo) and continue with the rest of the ritual.
## 2) Self-improvement retro
Follow the repo's retro rules:
- Only when the session hit a real rejection or a user-corrected mistake:
find the root cause and propose the exact fragment/skill/hook change
that would have prevented it.
- Environment/timing/platform traps become a quirks-fragment bullet: one
incident, one bullet, trap plus av