From memory-mason
Returns a concise snapshot of a Memory Mason knowledge base: file counts by type, raw capture statistics, token economics, and health summary.
How this skill is triggered — by the user, by Claude, or both
Slash command
/memory-mason:mmsThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Show a concise snapshot of the Memory Mason knowledge base state.
Show a concise snapshot of the Memory Mason knowledge base state.
This command is operational only. Do not write /mms, /memory-mason:mms, 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 rules:
.env file, use MEMORY_MASON_SUBFOLDER from that same file when present, otherwise default to ai-knowledge.memory-mason.json or ~/.memory-mason/config.json, use its subfolder.Do not claim config is missing until you have attempted all four locations above. If none provide a vault path, fail fast with an explicit error that names every location checked.
Use these paths:
1.5 Read {vault}/{subfolder}/_meta/manifest.json if it exists.
home.md2.5 For each raw capture entry in {vault}/{subfolder}/_raw/:
001.md, 002.md, and so on.meta.json for size calculations.{YYYY-MM-DD}/ plus total size.state.json, read:total_cost_usd if presentingested entries and each compiled_at timestampcapture_metrics if present:
capture_counttotal_raw_tokenstotal_stored_tokenstotal_savings_tokenstotal_savings_percentlast_capture_atlast_capture.sourcelast_capture.raw_tokenslast_capture.stored_tokenslast_capture.savings_tokenslast_capture.savings_percent3.2 Determine token economics status.
capture_metrics is missing, invalid, or capture_count is 0, report token
economics as not tracked yet and use zero totals with never for last capture.capture_metrics.3.5 From _meta/manifest.json, read:
sources object size)compiled_at timestampingested entries.state.json has no ingested entries but _meta/manifest.json exists, use the most recent manifest compiled_at._raw/ but is not present in the ingested map.5.5 Identify large raw captures.
_raw/ directory size exceeds 2MB, flag it.5.6 Determine manifest status.
present when _meta/manifest.json exists and parses successfully.missing when it does not exist.stale references.5.7 Determine session context status.
updated timestamp.context.md updated against the most recent compile timestamp.fresh when context.md is updated at or after the most recent compile timestamp.stale when context.md exists but is older than the most recent compile timestamp.missing when context.md does not exist.[[...]] wikilinks in the body (exclude frontmatter, exclude {subfolder}/_raw/ source references).[!contradiction] callouts (unresolved contradictions).[!gap] callouts (knowledge gaps).[[foo]] across knowledge articles and the root index.md (short-form wikilinks).[[concepts/foo]], [[atlas/foo]], [[synthesis/foo]], or [[_raw/...]] that lack the {subfolder}/ prefix across knowledge articles and the root index.md (missing subfolder prefix).{subfolder}/ across knowledge articles and the root index.md (cross-project refs).7.5 Count concept page status field values from frontmatter across all concept pages in {vault}/{subfolder}/concepts/. Tally: seedling count, growing count, evergreen count. Treat missing or invalid status as seedling.
Return status exactly like this:
## Knowledge Base Status
**Vault:** {vaultPath}/{subfolder}
**Articles:** {concept count} concepts, {synthesis count} synthesis, {moc count} MOCs
**Raw captures:** {total} total, {uncompiled} uncompiled
**Last compiled:** {ISO timestamp or "never"}
**Manifest:** {present/missing} ({tracked source count} sources)
**Context:** {fresh/stale/missing} ({updated timestamp or "never"})
## Token Economics
- Captures tracked: {capture count or 0}
- Raw tokens: {total raw tokens or 0}
- Stored tokens: {total stored tokens or 0}
- Savings: {total savings percent or 0}% ({total savings tokens or 0} tokens)
- Last capture: {last capture source or "never"} ({last capture timestamp or "never"})
- Last capture savings: {last capture savings percent or 0}% ({last capture raw tokens or 0} -> {last capture stored tokens or 0} tokens)
## Knowledge Graph
- Avg wikilinks per concept: {N.N}
- Isolated concepts (0 links): {count}
- Unresolved contradictions: {count}
- Knowledge gaps: {count}
- Short-form wikilinks: {count}
- Missing subfolder prefix: {count}
- Cross-project refs: {count}
## Maturity
- Seedling: {seedling count}
- Growing: {growing count}
- Evergreen: {evergreen count}
- Total concepts: {total}
## Recent Index (first 5 entries)
{index preview}
## Health
{healthy / N raw captures need compilation}
- Manifest: {present / missing / stale references}
- Context: {fresh / stale / missing}
- Token economics: {tracked / not tracked yet}
## Raw Capture Sizes
{table: folder | size | status}
- status: "OK" if under 500KB, "LARGE" if over 500KB, "⚠ VERY LARGE" if over 2MB
**Total _raw/:** {total size in MB}
{If any capture is LARGE: "Tip: Run /mmc on recent captures to keep the vault current."}
uncompiled is 0, report healthy.uncompiled is greater than 0, report N raw captures need compilation.npx claudepluginhub s-gryt/memory-mason --plugin memory-masonRuns 14 health checks on an Obsidian knowledge base: broken wikilinks, orphan pages, stale articles, and more. Reports issues by severity.
Shows knowledge base health metrics: file counts, backlog depth, audit status, codemap dates, tag stats, and coverage gaps. Invoke with /stats.
Upgrades existing Knowledge Base to latest Claude plugin practices: Obsidian graph-view links, structured 'When to Load' format, CLAUDE.md preamble, index schema, frontmatter health. Safe, preview-first, re-runnable.