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.