Audit siblings
Pure read-only audit of per-kind sibling files vs `microscope.md` `## References` sections. Detects dangling references (named but file absent) + orphan files (present but unreferenced). Emits `[!warning]` per dangling + `[!info]` per orphan + `[!success]` when clean. Invoked as `/cowork audit-siblings` (all kinds) or `/cowork audit-siblings <kind>` (single kind).From its SKILL.md
npx -y skills add willfell/sauce --skill audit-siblingsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
5.3 KB, as published. Nobody here has run it
cowork:audit-siblings
Pure read-only audit. No writes, no MCP gather calls. Surfaces inconsistency between microscope.md ## References entries and the actual sibling files in spice/cowork/prompts/per-mcp/<kind>/. Use after a microscope-authoring round to confirm what you wrote is consistent on disk.
When to run
- After running
/cowork microscope <kind>and scaffolding new siblings, to verify the new## Referenceslines all point at extant files. - After hand-editing a sibling file (renamed, deleted, added) to verify
microscope.mdstill describes the right set. - Periodically, before a high-stakes morning briefing, as a sanity check.
Inputs
kind(string, optional): a single kind name to audit. When omitted, audits all kinds inprefs.priorities.
Outputs
dangling(list[{kind, name}]): entries frommicroscope.md's## Referencesthat don't have a corresponding file on disk.orphans(list[{kind, name}]): files inper-mcp/<kind>/(excludingmicroscope.mdand_*.md) that aren't named inmicroscope.md's## Referencessection.kinds_audited(int): how many kinds were checked.
Steps
-
Read preferences. Call
cowork:read-user-preferencesto loadprefs. Captureprefs.priorities(the ordered kind list). -
Resolve scope. If the
kindinput is set:- Verify it appears in
prefs.priorities. If not, emit[!warning]"Kind<kind>is not in yourprefs.priorities. Available kinds: <list>." and exit cleanly. - Set
kinds = [kind].
Otherwise, set
kinds = prefs.priorities.If
kinds.length === 0, emit[!info]"No kinds inprefs.priorities— nothing to audit. Run/cowork preferencesfirst." and exit cleanly. - Verify it appears in
-
Gather per-kind state. Initialize empty objects
kinds_dir_listing = {}andmicroscope_bodies = {}. For eachkind_nameinkinds:- List
spice/cowork/prompts/per-mcp/<kind_name>/viamcp__obsidian__list_files_in_dir. Treat a not-found error as an empty listing. - Filter to
*.md, excludingmicroscope.mdand any filename matching^_.*\.md$. Assign the remaining list tokinds_dir_listing[kind_name]. - Read
spice/cowork/prompts/per-mcp/<kind_name>/microscope.mdviamcp__obsidian__get_file_contents(treat not-found as absent). When present, strip leading frontmatter and assign the body tomicroscope_bodies[kind_name].
This step is PURE — no MCP gather calls, no writes.
- List
-
Audit. Call
auditSiblings({ kinds_dir_listing, microscope_bodies })fromplatform/blueprints/cowork/helpers/audit-siblings-helper.js. The helper returns{ dangling: [{kind, name}, ...], orphans: [{kind, name}, ...] }, both arrays sorted deterministically by(kind, name). -
Render findings. Emit one callout per finding, in the order returned.
For each entry in
dangling:[!warning] Dangling sibling reference Kind:
<kind>microscope.md's## Referencesnames<name>but no such file exists atspice/cowork/prompts/per-mcp/<kind>/<name>. Did you delete the sibling? Or forget to scaffold it? Re-run/cowork microscope <kind>to re-author + scaffold, or hand-editmicroscope.mdto remove the dangling reference line.For each entry in
orphans:[!info] Orphan sibling file Kind:
<kind><name>exists atspice/cowork/prompts/per-mcp/<kind>/<name>but is not listed inmicroscope.md's## Referencessection. The gather will still inject it (siblings are glob-discovered, not microscope-driven), butmicroscope.mdshould document why this sibling exists. Re-run/cowork microscope <kind>to re-record the reference, or hand-add a- **<name>** — <your role description>line tomicroscope.md's## Referencessection.Note on em-dash: the
## Referencesparser requires an em-dash (—, U+2014) between**<name>**and the role description, matching whatcomposeMicroscopeemits. If you hand-edit a## Referencesbullet with a hyphen (-) or en-dash (–), the audit will silently flag the sibling as an orphan (the entry is unparseable; the file is still on disk). Use em-dash to keep audit-siblings honest. -
Summary. Emit one final callout:
-
If
dangling.length === 0 && orphans.length === 0:[!success] All sibling files consistent Audited
<N>kind(s) — no dangling references, no orphan files. -
Otherwise:
[!info] Audit summary Audited
<N>kinds;<D>dangling reference(s),<O>orphan file(s).
-
Returns
{ dangling, orphans, kinds_audited } per Outputs.
Test fixtures
HC-V0810-A1..A4 (parseReferences), HC-V0810-B1..B6 (auditSiblings), HC-V0810-C1 (this SKILL.md prose-lint), HC-V0810-D1 (claude_surface materialization + CS-MIG-1 count bump) in the workshop's harness suite.