step-notes
/step-notes
Turns the status-line gate for step notes on or off. While on, a hook asks for a short status line naming each tool action, like a progress caption, so the user can follow the session. Use when the user types /step-notes or asks to turn step notes on or off.
- Author
- jl-cmd-projects ↗
- Repository
- claude-dev-env ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 7
- Scripts
- 6
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 6 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/step_notes_constants/__init__.py, scripts/step_notes_constants/config/__init__.py, scripts/step_notes_constants/config/constants.py, scripts/step_notes_constants/config/test_constants.py, scripts/test_toggle_step_notes.py, scripts/toggle_step_notes.py
What it does and when to use it
Turns the status-line gate for step notes on or off. While on, a hook asks for a short status line naming each tool action, like a progress caption, so the user can follow the session. Use when the user types /step-notes or asks to turn step notes on or off.
Arguments
/step-notes [on | off | status]
Original author description
Turns the status-line gate for step notes on or off. While on, a hook asks for a short status line naming each tool action, like a progress caption, so the user can follow the session. Use when the user types /step-notes or asks to turn step notes on or off.
How it works
- Run the toggle
- Status lines
- Layout
SKILL.md preview
---
name: step-notes
description: Turns the status-line gate for step notes on or off. While on, a hook asks for a short status line naming each tool action, like a progress caption, so the user can follow the session. Use when the user types /step-notes or asks to turn step notes on or off.
argument-hint: "[on | off | status]"
---
# /step-notes
The step-notes gate is a PreToolUse hook (`hooks/blocking/step_note_gate.py`). It is off by default. While it is on, each message that calls a tool starts with a short status line naming the action, such as "Reading hooks.json." or "Running the gate tests." A call with no status line fails with "Status line missing".
## Run the toggle
Pass the user's argument through. With no argument, the toggle flips the current state.
Run `python "${CLAUDE_SKILL_DIR}/scripts/toggle_step_notes.py" <on|off|status>`.
Tell the user the line the script prints. The change applies at once, to every session on this machine.
## Status lines
A status line names the action and its target in a few words. One status line covers every call in the same message. Subagent calls pass without a check.
## Layout
| File | Role |
|---|---|
| `SKILL.md` | This flow: run the toggle, add status lines while the gate is on |
| `scripts/toggle_step_notes.py` | The on, off, flip, and status CLI for the flag file |
| `scripts/test_toggle_step_notes.py` | Behavior tests for each action |
| `scripts/step_notes_constants/config/constants.py` | Flag path, action names, report lines |
Files in this package (7)
- SKILL.md 1 KB
- scripts/test_toggle_step_notes.py 2 KB
- scripts/toggle_step_notes.py 2 KB
- scripts/step_notes_constants/__init__.py 1 KB
- scripts/step_notes_constants/config/__init__.py 1 KB
- scripts/step_notes_constants/config/constants.py 1 KB
- scripts/step_notes_constants/config/test_constants.py 1 KB
Versions
The database has no other skills named step-notes.
Database snapshot: 13.11.2026 · package version 5e3393e23d5b (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90handoff
Prepare a session handoff — summarize progress, annotate tasks with current status, and identify what's ready for the next session. Use at the end of a work session or when the user says they're done for now. - 100progress
Report live progress from long-running agent tasks. Use when a task takes more than a few seconds, so the user can watch status in the runs tray instead of staring at a spinner. - 100backup-apple-notes
Keep a current Markdown backup of the user's Apple Notes on disk with the Exporter Mac app and its exporter command line, as a nightly cron job, dated snapshots or a backup tool pre-flight step. Use when asked to back up Apple Notes, schedule a notes backup, snapshot notes to a… - 100progress-panel
Keep the Progress pane current — the pane beside every Claude Code session on this machine that shows each session's "now", what needs the user, and its tasks. Use the progress_update tool from the FIRST step of any multi-step task (now + the task list), on every status change,… - 100linked-notes
Captures the user's ideas as atomic, cited, linked Markdown notes. Use when saving learning insights, turning a session into durable notes, or when the user says \"save this as notes\" or \"make me notes\". - 100note
Record reading notes to a structured notes file. Use when the user says "take notes" or "record this" during reading sessions.