Skip to content
Skills Library
Personal productivity · Automation

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.

Licence
MIT
Last repository change
27.10.2026

Assessment and security

85/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content20 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
7
Scripts
6
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

  1. Run the toggle
  2. Status lines
  3. Layout
Original SKILL.md headings · 26 lines, 186 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.