Session finish

Skill niksavis/basicly/.agents/skills/session-finish

One-command harness distribution for coding agents — a versioned YAML catalog projected into agent instructions, skills, and deterministic git gates.

Install

npx -y skills add niksavis/basicly --skill session-finish

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

24 days oldThe repository was created 24 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
1 stars1 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

Close out a working session with a usage-statistics report, a self-improvement retro, and a pickup-clean handoff summary. Use when the user says the session is done ("wrap up", "finish the session", "close out"), before ending a long autonomous run, or whenever a summary of what changed and what the agent actually used is wanted.

SKILL.md

2.8 KB, as published. Nobody here has run it

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:

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 avoidance.
Present proposals for explicit approval — never self-apply a retro edit.
Nothing concrete surfaced? Skip the retro and say so; inventing findings is the anti-pattern.

3) Pickup-clean handoff

git status must be clean: no partial edits, stray debug output, or unexplained files. Anything intentional left behind gets named in the summary; anything unintentional gets removed before finishing.
Confirm the tracker matches reality (br ready; claimed issues either closed or annotated with their true state).
End with a summary of: what changed (with issue ids), what was verified (gates run, their results), what remains open, and the usage-statistics highlights from step 1.

Trigger examples

Should trigger: "wrap up the session" / "finish for today".
Should trigger: "what did this session actually use and change?"
Should not trigger: "close this issue" (that is tool-br).
Should not trigger: mid-task status updates while work is still open.