Menu
Lint the knowledge base for broken links, orphan pages, stale captures, and wikilink convention violations. Run as a periodic health check.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | mml |
| description | Lint the knowledge base for broken links, orphan pages, stale captures, and wikilink convention violations. Run as a periodic health check. |
| allowed-tools | Read Glob Grep Bash(obsidian *) |
Run eighteen health checks on the knowledge base and report all findings by severity.
This command is operational only. Do not write /mml, /memory-mason:mml, or their execution chatter back into the vault.
Before any other reasoning, resolve vault config in this priority order:
./.env./memory-mason.json~/.memory-mason/.env~/.memory-mason/config.jsonResolve:
Use the source that provides the vault path.
Subfolder: .env sources use MEMORY_MASON_SUBFOLDER when present, else ai-knowledge. JSON sources use their subfolder field.
If no location provides a vault path, fail fast with an explicit error naming every location checked.
Checks run against {vault}/{subfolder}/{atlas|concepts|synthesis}/*, index.md, _meta/{state.json, manifest.json, context.md}, _raw/*.
_raw/ or _meta/ as knowledge articles, except for the explicit checks below against _meta/manifest.json and _meta/context.md.[[target]] from article content.{subfolder}/_raw/ as valid source references. Links starting with bare _raw/ (missing subfolder prefix) are flagged by Check 13.[[foo]] as format violations handled by Check 13.See detailed specifications for exact rules, report formats, and edge cases for every check.
[[link]] whose target file does not exist under {vault}/{subfolder}._raw/YYYY-MM-DD/ folders absent from state.json ingested map.state.json.001.md files and session-scoped HHMMSS-{sid8}-NNN.md files)._meta/manifest.json structure, page references, and hash agreement with state.json._meta/context.md exists, has required frontmatter, and is not older than last_compile.[!contradiction] callouts in concepts/ articles.[!gap] callouts in concepts/ articles.{subfolder}/ prefix.{subfolder}/._raw/{YYYY-MM-DD}/meta.json (schemaVersion 2) but the corresponding sessions/YYYY-MM-DD-{sid8}.md file is missing.atlas/bases/*.base files expected after at least one compile are absent or contain invalid YAML.superseded_by target wikilink does not resolve; a superseded concept (has superseded_by) has status: evergreen; or has_contradiction flag does not match callout presence.sessions/ with no corresponding session row in index.md.### Errors (must fix), ### Warnings (should fix), ### Suggestions (nice to fix), and a ### Summary with counts. If no issues: โ Knowledge base is healthy.Archive log entries when they exceed 32 entries, using batches of 2^k for compact storage. Extractive only โ no invented facts. Run whenever _meta/log.md grows unwieldy.
Compile today's or a specified daily capture into the Vault Architecture v2 structure. Runs a three-stage EXTRACT -> TRANSFORM -> LOAD pipeline that updates concepts, atlas MOCs, synthesis pages, the root index, build log, manifest, state, session bootstrap context, and auto-archive folds. Triggers: "compile today", "/mmc", "compile YYYY-MM-DD", "--all" for batch. Use /mmq instead to query the vault without modifying it.
Query the knowledge base. Reads session context first, then the root index, then relevant atlas, concept, and synthesis pages, and synthesizes a clear answer with [[wikilink]] citations. Use when you want to ask about past decisions, patterns, lessons, or technical knowledge captured in previous AI conversations. Use the `insights` argument to surface workflow-coaching advisories from hook-generated data.
Show vault health: files, token metrics, compilation status, knowledge graph quality, and raw capture inventory. Invoke whenever user checks Memory Mason status or audits the knowledge base.
Set up, reconfigure, or remove Memory Mason. Configures vault path, installs hooks if missing, or uninstalls everything. Use when the user says "set up memory mason", "install hooks", "configure memory mason", "reconfigure memory mason", "get memory mason running", "my hooks aren't working", "uninstall memory mason", "remove memory mason", or runs /mmsetup.