diff --git a/README.md b/README.md
index aa7ad82b..7598dbd4 100644
--- a/README.md
+++ b/README.md
@@ -15,15 +15,13 @@ Use the latest Node v14, with all dependencies installed via `npm install`. Note
 - The general single-build-pass command is simply `npm start`
 - Continuous development is `npm test`
 
-Specialised commands:
+#### Specialised commands:
 
-- `pretty` runs prettier over the resultant HTML files
-- `link-checker` runs link checking on the resultant HTML files
-- `polish` runs `pretty` followed by `link-checker`
-- `svgo:pretty` runs a script that reformats the SVG files to an easier-for-humans form (**note: might be broken?)**
-- `clean` cleans up the timing file and temp directory
-- `lint:tools` runs prettier on all javascript in the `src` dir
-- `lint:lib` runs prettier on all site javascript (including the custom element code)
+- `polish` runs `prettier` on the final .html files, as well as `link-checker` to make sure there are no dead links in the content.
+
+#### Even more specialized commands:
+
+Please see the package.json `"scripts"` section for the full list of commands. Most of these are just build chain steps, and running them on their own basically makes no sense.
 
 ## Weird personal dependencies?