os-check-work
ALWAYS invoke this skill when the user asks about work done outside this session - "check work", "check the others", "check other sessions" - or to accept one: "the session is done, check it", "can we merge it" - in any language.
Install / Use
npx skills add kharmanskyi/open-steps --skill os-check-workInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of os-check-work
os-check-work scores 89/100 on our quality scale, 1691st of 4,698 Development & Engineering skills we index (top 36%).
Its SKILL.md is 7.4 KB long, well organised into 10 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
It has 902 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so os-check-work is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
os-check-work compared with similar skills
All 4 of these similar skills score higher than os-check-work; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| os-check-work (this skill)by kharmanskyi | 89 | 902 | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install os-check-work?
- Run
npx skills add kharmanskyi/open-steps --skill os-check-work. The install tabs above show the steps for each supported agent. - Which AI agents does os-check-work work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is os-check-work safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is os-check-work still maintained?
- The repository was last updated about 2 months ago, so os-check-work is actively maintained.
Skill content
View source on GitHubname: os-check-work description: >- ALWAYS invoke this skill when the user asks about work done outside this session - "check work", "check the others", "check other sessions" - or to accept one: "the session is done, check it", "can we merge it" - in any language. You are the receiving party: treat the report as a claim, verify each part against machine state, name every gap between claimed and true. Verified-ready work merges in the same pass. End with what is left, one next step, and any reply another session needs, ready to paste. allowed-tools:
- "Read(~/.claude/open-steps/**)"
- "Bash(gh pr list *)"
- "Bash(gh pr view *)"
- "Bash(gh pr checks *)"
- "Bash(gh pr checks)"
- "Bash(gh pr diff *)"
- "Bash(gh pr diff)"
- "Bash(gh pr merge *)"
os-check-work
You are the receiving party: another session says it finished, and your job is to find out whether that is true. Reports run optimistic - they are written by whoever did the work. Triggers live in the description above; one more is taking over work you did not do.
Language
Write in the language the user speaks in this session, detected from the conversation. Code, file names and identifiers stay English.
The stance
- A report is a claim by the party being assessed, and its adjectives are not measurements: "tests are green" vs the count that ran. Ask for the number.
- "Done" is a snapshot. Reviews get revoked, branches fall behind and checks flip, often with no new commit. Re-read immediately before you act.
Two modes
Plural is a sweep: every sibling session, one line each, statuses only.
Singular - "accept this", a named session or pull request - is an accept:
full verification, then acceptance. A sweep that finds verified-ready work
rolls into accepting it - the accept steps run first, never skipped. Where
your tool cannot list other sessions, sweep the open pull requests instead
(gh pr list) and say so.
Sweep
One line per session, one call per pull request - the reader skims these and reads the closing block. No table:
<name a person recognises (#PR)> - <product change>; <all done? plus proof in 2-4 words, or what is missing>; <archive: yes / not yet>.
- Name from the ticket or PR title, never your shorthand; the change for the product, not a file list.
- A yes carries its proof ("checks green, review approved"); never a bare yes.
- "All done" ≠ "can archive": finished work can still await acceptance.
- Order: needs-the-user, then broken, then still-working - a running session is one word, not a finding.
- No deep verification in a sweep: say what you did not open and what that leaves unverified. Never announce your working mode - "cheap checks" is bookkeeping.
- A session waiting on an answer gets it in the same pass - see "The reply"; when that needs the deep read, the reply becomes the do-this-next.
- Name the sessions you could not read, and why.
Accept - steps 1 to 5 (never per-session inside a sweep)
-
Find the claim. Read the transcript tail where tools allow - the last message is the report; read it once, do not quote it back. No tools → the pull request is the artefact; say so.
-
Verify each claim at its source.
| The session claims | Where the truth lives | |---|---| | checks are green |
gh pr checks- counts and states, not the summary word | | it was approved |--json reviewDecision,latestReviews- revocable on the same commit | | no open discussions | the unresolved-thread count, not "I addressed the comments" | | ready to merge |mergeStateStatus- and again right before merging | | tests were added | find them ingh pr diff- the most common false report | | it stayed in scope |gh pr diff --name-onlyvs the task; flag unasked files | | linked to the task | the ticket in branch, title or body |Prefer numbers to words. Check what the report did not mention: scope creep and missing tests are never claimed - they are found.
-
Name the gaps - the deliverable. One line each:
Claimed: … Measured: …. No gaps → say so in one line; a clean intake is a real result. -
Accept, hand back, or unblock.
- Content does not hold → hand it back with the reply written (below); never fix it silently - that makes you the author of work you were checking.
- Mechanical unblocking is yours without asking: update a branch from the main line, restart a stuck check - reversible plumbing, no content change.
- Merging needs no word at all: work whose claims verified merges in any mode, no round-trip. Exactly two things stop it - a claim that failed, and an instruction on this task that merges happen on command only (an orchestrator may own the merge; that instruction beats any standing policy). The verification itself is never skipped.
-
Clean up. Remove its leavings - working copy, branch, temp files; ask before deleting what is not certainly its. Archive verdict → closing block.
The reply is part of the pass
When a checked session needs to hear something back - a defect, a question, a decision - write the reply in the same pass; do not leave the translation to the user.
**To <session name>** - paste this:
<the instruction, verbatim>
- Self-contained - the target never read this chat: name the PR, file, gap.
- It speaks as the user: a plain instruction, not a review essay.
- One best answer → one block; a real fork → two, recommended first and
marked; past three it is a decision for
os-ask-simple. - Carry the claimed/measured pair - evidence, not adjectives.
Ending the pass
Both modes end the same way, always last, nothing after it:
| | |
|---|---|
| **Still open** | <what remains, or "nothing"> |
| **Do this next** | <the one action> - <one clause of reasoning> |
| **On your word** | <what you will do once they say it> |
- Say whether anything is left, including what waits on the user; a remainder
past three items goes to
os-whats-next. - One action, never a choice: what unblocks the most goes first, and the reasoning clause says so.
- Nothing ready is a real answer - "nothing to accept yet, watch X". Never
invent an action; a step that is not yours → say whose (
os-step-by-step). - Word already given (in the ask, or by standing policy) → the third row
reports what you did. Pass closed everything → run
os-whats-next. - Never end on a question mark - you have the measurements, so the opinion.
Hard rules
- Never repair another session's work silently - name it, return it.
- Never accept on the strength of the report alone; detail is not evidence.
- Nothing irreversible without the word - given in the ask itself or by a standing policy; a task-scoped restriction beats both. Merging verified work already has that policy: step 4.
- Re-read state immediately before acting.
- Report gaps as measurements: what was claimed, what you found, in that order.
- Say what you could not check - no access is a gap, not absence of problems.
- End with the closing block; findings without a recommendation are unfinished.
Known gotchas
- Behind the main line ≠ conflicted: it needs an update, not the author.
- A conflicted branch may have run no checks: nothing-ran looks green.
- Delete a branch only from outside its own working copy.
- Shared state: stashes, containers, databases - do not clean up what another live session is using.
- A draft is not a finished session; check the author considers it done.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
