link-health

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:

   lnk health [link-root]
   

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

   lnk operations [link-root]
   

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

   lnk backup [link-root]
   

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

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

5. Validate before saying the wiki is healthy:

   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.