health

Check knowledge store health, verifying paths and model/schema compatibility.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/blueraai/bluera-knowledge --skill health-blueraai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/blueraai/bluera-knowledge/tree/main/skills/health
Command: npx skills add https://github.com/blueraai/bluera-knowledge --skill health-blueraai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps identify and diagnose problems with your knowledge stores, such as missing files, outdated schemas, or incompatible embedding models, ensuring your AI has reliable access to information.

Core Features & Use Cases

  • Comprehensive Health Checks: Verifies the existence of store paths and checks for model/schema compatibility.
  • Actionable Insights: Provides clear error messages and suggested fixes for identified issues.
  • Use Case: If your AI agent is failing to retrieve information, you can run this health check to quickly pinpoint if a store's path has been deleted or if it needs re-indexing due to a model update.

Quick Start

Run a health check on all your knowledge stores.

Frequently Asked Questions about health

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

FAQPage Schema
How do I diagnose a knowledge store when my AI agent fails to retrieve information?

To diagnose knowledge store retrieval failures, run a health check to verify store path existence and model or schema compatibility. It provides clear error messages and actionable suggested fixes for issues like missing files or outdated schemas.

How do I run a health check on a specific knowledge store?

Run a health check on a specific knowledge store by passing the --store argument. This executes a targeted check for an individual store, verifying its path existence and embedding model compatibility.

What causes an incompatible embedding model error in a knowledge store?

An incompatible embedding model error occurs when a knowledge store schema does not match the currently configured model. Running a diagnostics check identifies this mismatch and suggests re-indexing the store to resolve the issue.

Can I automate knowledge store diagnostics using exit codes for scripting?

Yes, you can automate knowledge store diagnostics using exit codes for scripting. The health check provides specific exit codes that indicate overall health, warnings, or critical errors for automated workflows.

Why does my knowledge store health check report a missing path error?

A knowledge store health check reports a missing path error when the configured store directory has been deleted or moved. The check verifies path existence and provides actionable insights to restore or update the configuration.