shio-console-review
Skill3 starsChanged 8 days agoApache-2.0View on GitHub
Review Shio's React console as a curator would, one iteration at a time, and file every finding as a roadkeep task. Boots a clean instance, runs the console check, asks e2e/ui-review-pick.mjs which route families to judge next, judges their screenshots against a fixed checklist (purpose, hierarchy, states, consistency, language, the curator's next step, P1/P7), files what it finds after searching the roadmap, and records the review so the next run moves on. Use when asked to review, audit, critique or improve the console's UI or UX, to look for interface problems, or to run a continuous or recurring console review under /loop or a scheduled headless run.
- Deletes or force-pushes
In this repository14 other files it gives its agents.
- agents.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- roadkeepSkill
- shio-agent-surfaceSkill
- shio-build-testSkill
- shio-console-uiSkill
- shio-content-apiSkill
- shio-content-filesSkill
- shio-databaseSkill
- shio-docs-syncSkill
- shio-docs-writeSkill
- shio-rendererSkill
- shio-replication-testSkill
- shio-roadmap-docsSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Read docs/agents/console-ui.md §"Reviewing the console" for the reasoning.
- Distinctive: line 41
Ask what to look at: Never choose routes yourself:
- Very specific: line 58
search first: mcp__roadkeep__list / section_find with the page's name or the symptom.
- Distinctive: line 81
It does not judge taste without a rule: Every finding cites a checklist item or a design law.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 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
Reviewing the console, continuously (SH1321)
console-check.mjs is the mechanical half: it walks every route, screenshots each one, runs axe,
records failed reads and gates the cost. This skill is the half that judges, and its whole
design is that one invocation is one bounded iteration, so a loop can repeat it without the
review drifting toward whatever page came to mind.
Read docs/agents/console-ui.md §"Reviewing the console" for the reasoning; this file is the procedure.
One iteration
A clean instance, not the dev box. The dev instance on
:2710carries every earlier session's content and hides empty states. Build and start a fresh store on:2711:./mvnw -pl shio-app -am package -DskipTests -Dskip.npm=true rm -rf /d/tmp/shio-review && mkdir -p /d/tmp/shio-review cd /d/tmp/shio-review && java -jar <repo>/shio-app/target/viglet-shio.jar --server.port=2711 # backgroundSkip the build when the jar is newer than the last commit and an instance is already up.
Provision and run the check against the jar (the production build, the one the cost budget was measured on):
export SHIO_URL=http://localhost:2711 SHIO_USER=admin SHIO_PASSWORD=shio-conformance node shio-react/e2e/provision.mjs --api $SHIO_URL node shio-react/e2e/console-check.mjs --base $SHIO_URL --api $SHIO_URL > /d/tmp/shio-review/check.logA red check is not a reason to stop the review: failing families are exactly what the picker puts first. Redirect, then read: never pipe the check into
grep.Ask what to look at. Never choose routes yourself:
node shio-react/e2e/ui-review-pick.mjs --count 3It prints, per family, the reason it was picked, the paths, the screenshots and the check's own problems for them. Three families per iteration is the default budget; raise
--countonly when asked.- Judge each picked family against checklist.md: read every screenshot, and
open the route in a real browser (Playwright, as
console-check.mjsdoes) for what a screenshot cannot show: the English locale, a narrow viewport, the dark theme, hover and focus, an empty or error state. Look for the cause inshio-react/src/app/**before writing anything down: a finding names the component, not only the pixel. - File each finding before moving on, never batch it into a summary:
- search first:
mcp__roadkeep__list/section_findwith the page's name or the symptom. An open line that already says it gets nothing new; a closed one that regressed is a new task that cites it. - then
mcp__roadkeep__addunder the block holding open console work (block_list; Block BG today), symptom as what the curator meets, never as the fix. One finding, one line. - a defect the check could have caught mechanically gets a second line: the probe or lint that would have caught it (SH322: the instrument is the deliverable).
- search first:
Record the review, findings or not, so the rotation advances:
node shio-react/e2e/ui-review-pick.mjs --record <family>,<family> --findings SH1400,SH1401- Commit the ledger with the filed lines:
run-commit.cmd -m "docs(roadmap): file the console review findings for <families> (SH…)", from the repo root, and only when the working tree holds nothing but this iteration's files. With nothing found:chore(console): record the review of <families>.
What it does not do
- It does not fix. Review and repair in one commit hides which finding a change answers. The
filed lines are drained by
execute-roadkeep-tasks, or by a later iteration the user asks for. - It does not judge taste without a rule. Every finding cites a checklist item or a design law; "I would have done it differently" is not filed.
- It does not re-review a family the ledger shows was reviewed at this commit, unless the check now fails it.
Running it continuously
- In a session:
/loop /shio-console-review, self-paced. Each firing is one iteration; stop when the picker offers only families reviewed at the current commit. - Unattended: a Windows scheduled task running
claude -p "/shio-console-review" --permission-mode acceptEditsfrom the repo root. It needs the local instance, so a cloud routine (/schedule) would have to build the jar each time. - After a console change: the iteration is the cheapest check that the change reads right to a
person. Run it with
--countcovering the families the change touched.
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.

