Skip to main content
ClaudeWave
Skill65 repo starsupdated yesterday

link-health

The link-health skill provides diagnostic and repair commands for Link wikis using the `lnk` CLI tool. Use it when users need to verify wiki readiness, diagnose interrupted writes or stale operations, repair indexes and backlinks, create backups, or validate wiki integrity without requiring MCP setup or the web viewer.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/gowtham0992/link /tmp/link-health && cp -r /tmp/link-health/skills/link-health ~/.claude/skills/link-health
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Link Health

Use the `lnk` CLI. 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]
   ```
2. If the output mentions interrupted or stale operations, inspect them before repair:
   ```bash
   lnk operations [link-root]
   ```
3. Before broad repairs, migrations, or restore work, create a backup:
   ```bash
   lnk backup [link-root]
   ```
4. 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]
   ```
5. 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.