SKILL.md

os-done-or-not

ALWAYS invoke this skill when work wraps up or the user asks how it went - "done or not", "are we done", "what happened", "report", "what's the status of this ticket" - in any language, and when a Stop hook asks for a session report. Produces a ten-line plain- language report: a lead, a checkmark table, and a verdict - fully done, anything needed from you, new debt, safe to close. Every "yes" names its proof; unverified says "not checked". Saves the report so the next session starts from it instead of re-exploring the repo.

install os-done-or-not

# install the open-steps pack with the skills CLI

npx skills add kharmanskyi/open-steps

# or add only this skill to Claude Code: copy the folder

skills/os-done-or-not/

# into

~/.claude/skills/os-done-or-not/ (all projects)

.claude/skills/os-done-or-not/ (one project)

skills/os-done-or-not/SKILL.md

MITFull file

1# os-done-or-not
2 
3One question, one screen: **did the agent finish, and what actually happened**,
4in words a reader who does not code will understand. Nothing happened (pure
5questions, no files touched) → one line saying so, no report.
6 
7## Language
8 
9The user's language in this session, detected from the conversation. Translate
10every template label. Code, files, commands stay English.
11 
12## Step 1 - gather proof that takes seconds
13 
14Fast checks only; never re-run the test suite - use results this session
15already produced. Not confirmable in seconds, or still running → **"not
16checked"**, never "yes".
17 
18```bash
19git status --porcelain            # uncommitted?
20git log --oneline -10             # what landed
21git log HEAD --not --remotes --oneline 2>/dev/null | head -20   # unpushed? (no remote: say so)
22gh pr view --json state,mergeStateStatus && gh pr checks   # if a PR exists
23```
24 
25## Step 2 - name the outcome
26 
27Sessions end one of eight ways; pick the match **before** writing, or the
28report says "fully done: yes" and "safe to close: no" in the same breath.
29 
30| # | Outcome | Verdict shape |
31|---|---|---|
32| 1 | Shipped and verified | done Yes · nothing needed · close Yes |
33| 2 | Done - one action is yours | done Yes · needed = that action · close Yes |
34| 3 | Stalled on your decision | done No · needed = the decision · close No |
35| 4 | Partly done, rest deferred | core Yes, rest recorded as debt · close Yes |
36…

Excerpt shown under the repository's MIT license.

How to install os-done-or-not

skills/os-done-or-not/SKILL.md

More skills in open-steps

Newsletter

Join the Community