index1-doctor

What This Skill Does

The index1-doctor skill serves as the primary diagnostic engine for the index1 ecosystem. When executed, it performs a comprehensive system health audit to ensure that your environment is fully capable of handling vector search and document retrieval tasks. It automates the verification of critical dependencies, including Python environment versioning, SQLite compatibility—specifically checking for the essential sqlite-vec extension—and verifying the availability of embedding models such as bge-small-en-v1.5. Beyond static analysis, the skill queries the active index status to provide a high-level overview of document and chunk counts, database size, and collection health. Finally, it probes local Ollama instances to ensure that necessary embedding models are active and reachable, providing a consolidated report that helps users identify misconfigurations or missing dependencies that might cause search anomalies.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command in your terminal:

clawhub install openclaw/skills/skills/gladego/index1-doctor

Once installed, no further configuration is required as the skill automatically taps into your existing local environment variables and index1 configurations.

Use Cases

This skill is indispensable during the onboarding phase when you are initially setting up index1 for the first time, as it validates your environment against all minimum requirements. It is also highly effective as a troubleshooting tool; if you find that search queries are returning zero results or producing degraded accuracy, running the doctor will immediately pinpoint if a model has been uninstalled or if an index has become corrupted. Developers should incorporate this check into their maintenance routine, particularly after major system updates or index1 package upgrades, to ensure continuous compatibility.

Example Prompts

1. "Run a health check on my index1 environment and report any issues."
2. "/doctor - please diagnose why my search results seem outdated."
3. "Can you check if my environment is ready for CJK processing in index1?"

Tips & Limitations

When interpreting the results, focus on the 'Fail Fix' column provided in the diagnostic summary. Ensure that if you are working with Chinese or CJK documents, you explicitly install the index1[chinese] extras, as the standard installation does not bundle the jieba tokenizer. Be aware that this skill performs read-only checks on your files and database; it does not perform automated repairs. Always ensure your Ollama service is running in the background before invoking the command to avoid false negatives regarding model availability.