index1-doctor
Diagnose index1 environment - check Python, Ollama, models, index health.
Packaged view
This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.
Install command
npx @skill-hub/cli install openclaw-skills-index1-doctor
Repository
Skill path: skills/gladego/index1-doctor
Diagnose index1 environment - check Python, Ollama, models, index health.
Open repositoryBest for
Primary workflow: Ship Full Stack.
Technical facets: Full Stack, Integration.
Target audience: everyone.
License: Apache-2.0.
Original source
Catalog source: SkillHub Club.
Repository owner: openclaw.
This is still a mirrored public skill entry. Review the repository before installing into production workflows.
What it helps with
- Install index1-doctor into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
- Review https://github.com/openclaw/skills before adding index1-doctor to shared team environments
- Use index1-doctor for development workflows
Works across
Favorites: 0.
Sub-skills: 0.
Aggregator: No.
Original source / Raw SKILL.md
---
name: index1-doctor
description: Diagnose index1 environment - check Python, Ollama, models, index health.
version: 2.0.3
license: Apache-2.0
author: gladego
tags: [index1, diagnostics, mcp, troubleshooting]
---
# index1 Doctor
Environment diagnostic skill for index1. Runs health checks and provides fix recommendations.
## Usage
Type `/doctor` or ask the agent to diagnose index1.
## What it checks
The skill runs three commands sequentially and analyzes results:
### 1. Environment Check
```bash
index1 doctor
```
Checks:
- Python version (>= 3.10 required)
- SQLite version (>= 3.43.0 for full features)
- sqlite-vec extension
- ONNX embedding (built-in, bge-small-en-v1.5)
- Ollama connectivity (optional, for multilingual/CJK)
- Embedding model availability
- CJK/Chinese support (jieba)
### 2. Index Status
```bash
index1 status
```
Shows:
- Document count and chunk count
- Collections list
- Last index time
- Database size
### 3. Ollama Models
```bash
ollama list
```
Shows installed models. Recommended embedding models:
- `nomic-embed-text` — Standard, 270MB
- `bge-m3` — Best for CJK content, 1.2GB
## Interpreting Results
| Check | Pass | Fail Fix |
|-------|------|----------|
| Python | >= 3.10 | Install Python 3.11+ |
| SQLite | >= 3.43.0 | Auto-degrades, no action needed |
| sqlite-vec | Loaded | `pip install index1` (bundled) |
| Ollama | Connected | `curl -fsSL https://ollama.com/install.sh \| sh` |
| Model | Available | `ollama pull nomic-embed-text` |
| CJK | jieba loaded | `pip install index1[chinese]` |
| Index | Has documents | `index1 index ./src ./docs` |
## When to use
- First-time setup verification
- After upgrading index1
- When search returns unexpected results
- When vector search stops working
- Before reporting issues
---
## Skill Companion Files
> Additional files collected from the skill directory layout.
### _meta.json
```json
{
"owner": "gladego",
"slug": "index1-doctor",
"displayName": "index1 Doctor",
"latest": {
"version": "2.0.3",
"publishedAt": 1771336740844,
"commit": "https://github.com/openclaw/skills/commit/6fed0d047cb8489f163bbcf0e8bf1efca4e2947c"
},
"history": [
{
"version": "2.0.1",
"publishedAt": 1771300657535,
"commit": "https://github.com/openclaw/skills/commit/7c8c184e7346e84a759b740196954703823b76a4"
}
]
}
```