f-status
Skill14 starsChanged 20 days agoMITView on GitHub
Catch the owner up in plain English on a Topping Out job: where we are, what got done, the state now, what's next. Reads ONLY the live session; no subagents, no git, no file reads, no writes. Use when the user runs /f-status, says "catch me up", "where are we", "I'm lost", "refresh me", or comes back after stepping away. Not the 5-line status block every reply ends with (templates/J-STATUS.md).
In this repository32 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/llms-full.txtllms.txt
- docs/llms.txtllms.txt
- adjudicateSkill
- agent-councilSkill
- converseSkill
- f-archive-searchSkill
- f-archiveSkill
- f-blueprintSkill
- f-boardSkill
- f-cardSkill
- f-catchupSkill
- f-complySkill
- f-contextSkill
- f-distillSkill
- f-dreamSkill
- f-greploopSkill
- f-inspectSkill
- f-night-shiftSkill
- f-plancheckSkill
- f-scheduleSkill
- f-searchSkill
- f-setupSkill
- f-shiftSkill
- f-signoffSkill
- f-sketchSkill
- f-surveySkill
- model-councilSkill
- orca-pi-connectSkill
- pack-reviewSkill
- speakSkill
- xreviewSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 7 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 29
Read only what is already in this session's context.
- Very specific: line 35
If the session was compacted, work from the summary and say so in one clause (earlier detail is summarised).
- Distinctive: line 37
If the session is genuinely thin, just started, nothing done yet, say that in two lines and stop.
- Distinctive: line 69
Write it the way you'd explain it to a sharp friend who missed the last hour.
- Distinctive: line 71
Plain words: No jargon unless the owner has been using that word themselves this session.
- Distinctive: line 72
One idea per bullet: If a bullet needs a comma-spliced second clause, it's two bullets or it's cut.
- Distinctive: line 85
Not a report card. Don't congratulate, don't hedge, don't apologise for what isn't done.
- Distinctive: line 87
Don't re-open settled decisions.
- Very specific: line 89
Don't append offers, next-step menus, or "let me know if…".
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Topping Out: Status refresher
Give the owner the big picture in fifteen seconds of reading. For the moment they step back, or step away and come back lost.
Usage
/f-status # refresh on the whole session
/f-status <topic> # narrow to one threadHard constraint: conversation only
Read only what is already in this session's context. This skill must answer instantly.
Forbidden here: subagents, git commands, file reads, file writes, MCP calls, web fetches, any tool at all. If you reach for a tool, the skill has failed, the owner wanted a refresher, not an investigation.
You already know what happened. Say it.
If the session was compacted, work from the summary and say so in one clause (earlier detail is summarised). Never invent specifics to fill a gap.
If the session is genuinely thin, just started, nothing done yet, say that in two lines and stop. A short honest answer beats a padded one.
Output
Five blocks, in this order. Skip any block with nothing real in it. Hard cap ~200 words.
Where we are
<one sentence a non-engineer understands>
Done this session
• <what changed in the world>
• <3-5 bullets max>
Right now
<health line>
Next
<the single next action, and who does it, you or me. If nothing is needed from them: `nothing from you`>
Watch out
<only a real trap; otherwise omit entirely>Health line uses the house vocabulary: Healthy, <scope>: <evidence> · Blocked, <scope>: <what's in the way> · Waiting, <scope>: <on what> · Unknown, <scope>: <what we'd need to check>. Name the scope you actually checked. Never imply whole-system health from one green gate.
Language rules
Write it the way you'd explain it to a sharp friend who missed the last hour.
- Plain words. No jargon unless the owner has been using that word themselves this session. If a term is load-bearing and new to them, define it in four words inline.
- One idea per bullet. If a bullet needs a comma-spliced second clause, it's two bullets or it's cut.
- What changed in the world, not what tool ran.
the login page now remembers you, notedited auth-core.ts and ran typecheck. - No file paths, no command names, no SHAs in the body. They raise cognitive load and the owner can ask.
- Numbers beat adjectives where a number exists.
4 of 7 tests pass, notmostly passing. - No process replay. They don't need the order things happened in, only where it landed.
- No reasoning. State the situation; don't re-derive it.
- Status is not an action.
Right nowis state.Nextis a thing the owner does. Never write a non-action in imperative form (keep X,leave Y alone,don't touch Z) insideNext,keep Xis shaped exactly likedelete X, so it reads as a task when it is the absence of one. If there is nothing for them to do,Nextreadsnothing from youand stops. - Say a caveat once. A constraint already stated earlier in the session is a settled fact, not an open item. Repeating it makes it look unmet.
What this is not
Not a report card. Don't congratulate, don't hedge, don't apologise for what isn't done. If something failed, one flat line: what failed, and whether it blocks the next step.
Don't re-open settled decisions. If the owner already chose something, it's a fact now, not an option.
Don't append offers, next-step menus, or "let me know if…". End on Next.
Example
Where we are We're building a small skill that tells you where you are, so you can step away and come back without re-reading everything.
Done this session • Checked two public skill collections, neither had what you wanted, but both had usable parts • Settled the design: plain English, five blocks, reads only this conversation • Moved off the main branch so nothing can reach production by accident
Right now Healthy, the new skill file: written and mirrored, nothing committed yet.
Next You read it and tell me if the tone is right. Nothing is staged until you say so.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

