cmd-what
What
Give the user a high-signal, low-noise snapshot of what's happened in this session so they can re-enter the loop without scrolling back.
Output format
Reply with 3-5 bullet points only. No preamble, no closing summary, no headers, no follow-up questions. Each bullet must be:
- **1-3 word label**: explanation in less than 120 characters
Hard rules:
- 3-5 bullets, no more, no less in spirit (4 is the sweet spot)
- Label: 1-3 words, bolded, title-case or kebab-case, names a concrete thing (file, action, decision, blocker)
- Explanation: a single clause, < 120 characters including the label, present tense or past tense — never future tense ("will", "going to")
- No nested bullets, no code fences, no links, no emoji unless one is genuinely load-bearing
- Skip anything the user already knows from the last 1-2 turns — focus on what they'd miss if they just walked back to the terminal
What to include (in priority order)
- Current focus — what file/task is actively being worked on right now
- Most recent concrete change — what just got written, edited, run, or decided
- Blocker or open question — anything waiting on the user, or that's stuck
- Next step — the very next action the agent intends to take, if obvious
- Notable side effects — files created, branches touched, processes started, only if relevant
What to leave out
- Restating the original user request verbatim
- Tool-call narration ("I ran ls, then grep, then…")
- Anything that happened more than ~10 turns ago unless it's still load-bearing
- Hedging, qualifiers, or meta-commentary about the summary itself
Example
User: /cmd-what
Good response:
- **Editing**: refactoring `auth/session.py` to drop the legacy cookie path
- **Tests**: 14/16 passing, 2 failing on token refresh edge case
- **Blocked**: need to know if expired refresh tokens should silently re-auth or 401
- **Next**: wire the chosen behavior into `refresh_token()` once you decide
Bad response (too verbose, narrates tool calls, future-tense, missing labels):
- I started by reading the auth module and then I grepped for cookie usage
- I'm planning to refactor the session handling but first I want to check with you
- The tests will probably need updates too
More from olshansk/agent-skills
session-commit
Capture learnings from the current coding session and update AGENTS.md. Use when the user asks to close the loop, run session-commit, record best practices, or update agent instructions based on recent work.
30skills-dashboard
Scrape skills.sh and generate an interactive HTML dashboard showing skill distribution by publisher, installs, and categories. Rerun anytime to get fresh data.
29cmd-clean-code
Improve code readability without altering functionality using idiomatic best practices
25cmd-idiot-proof-docs
Simplify documentation for clarity and scannability with approval-gated edits
18cmd-rss-feed-generator
Generate Python RSS feed scrapers from blog websites, integrated with hourly GitHub Actions
18cmd-proofread
Proofread posts before publishing for spelling, grammar, repetition, logic, weak arguments, broken links, and optionally reformat for skimmability or shape the writing vibe toward a known author's style
17