health

Diagnose workspace knowledge base health issues and generate ranked reports.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/kinnerkarmanish/mak --skill health-kinnerkarmanish
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/kinnerkarmanish/mak/tree/main/library/skills/analysis/health
Command: npx skills add https://github.com/kinnerkarmanish/mak --skill health-kinnerkarmanish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Workspace health diagnostics identify structural problems and signal integrity issues in the knowledge base, enabling proactive maintenance.

Core Features & Use Cases

  • Run targeted checks for orphaned content, stale signals, missing cross-references, index drift, duplicates, broken references, and embeddings presence.
  • Generate a ranked health report with color-coded severities and recommended fixes for workflows and governance.
  • Use-case: routinely verify knowledge assets before publishing, preventing broken links and data gaps.

Quick Start

Run a full health check against the workspace to surface issues and actionable recommendations.

Frequently Asked Questions about health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my knowledge base for broken references and orphaned content?▼

Run a workspace health diagnostic to identify and prioritize orphaned content, stale signals, and broken references. The check applies targeted diagnostics to all files or specific nodes, generating a machine-parseable report with severity rankings and recommended fixes.

What is index drift in a workspace knowledge base?▼

Index drift occurs when workspace knowledge base structures fall out of sync over time. Health diagnostics detect this drift alongside duplicates and missing cross-references, providing a color-coded severity report to help maintain data integrity before publishing.

How do I find stale signals and missing cross-references in my workspace files?▼

Execute a full health check against the workspace to surface stale signals and missing cross-references. The diagnostic scope covers all files or targeted nodes, ensuring results are machine-parseable and include actionable recommendations for governance workflows.

Can I automatically fix trivially fixable items found during workspace health diagnostics?▼

Yes, the health diagnostic supports auto-fix for trivially fixable items where feasible. It identifies structural problems and signal integrity issues, then generates a ranked health report with recommended fixes to enable proactive knowledge base maintenance.

Does the workspace health check verify embeddings presence across targeted nodes?▼

Yes, diagnostics include checks for embeddings presence alongside orphaned content and index drift. You can apply these checks to targeted nodes or all files, producing machine-parseable results with severity rankings to prevent data gaps.

What is the best way to verify knowledge assets before publishing to prevent broken links?▼

Use workspace health diagnostics to routinely verify knowledge assets before publishing. This prevents broken links and data gaps by identifying duplicates, stale signals, and quality concerns, then outputting a ranked report with color-coded severities and recommended fixes.