version: "1.0.2" name: link-health description: Use at the start of Link work when readiness is unclear, after installs or upgrades, and before repairs; verify health, inspect interrupted writes, back up, and repair generated indexes without MCP.

Link Health

Use the lnk CLI. Load this skill before trusting a new or changed Link wiki, after installs/upgrades, and before broad repair or restore work. In a source checkout, replace lnk with python3 link.py. MCP and the local web viewer are optional; lnk serve is only for humans to browse the wiki.

1. Check readiness first:

``bash lnk health [link-root] ``

1. If the output mentions interrupted or stale operations, inspect them before repair:

``bash lnk operations [link-root] ``

1. Before broad repairs, migrations, or restore work, create a backup:

``bash lnk backup [link-root] ``

1. Repair only generated or structural state that Link reports as safe:

``bash lnk doctor --fix [link-root] lnk rebuild-index [link-root] lnk rebuild-backlinks [link-root] ``

1. Validate before saying the wiki is healthy:

``bash lnk validate [link-root] lnk health [link-root] ``

If the user asks whether MCP is ready, run lnk verify-mcp [link-root]. Do not start lnk serve for MCP or CLI work.

To check whether optional local semantic recall is active (lexical is always the fallback):

lnk semantic [link-root]

It reports the provider tier, model, and index state, and prints the exact setup command when the layer is available but not yet enabled.