# Knowledge Base Builder Error Handling

> Sub-skill of knowledge-base-builder: Error Handling.

- Skill: `vamseeachanta/knowledge-base-builder-error-handling` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/knowledge-base-builder-error-handling`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/knowledge-base-builder-error-handling/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/knowledge-base-builder-error-handling

---


# Error Handling

## Error Handling


### Common Errors


**Error: sqlite3.OperationalError (database is locked)**
- Cause: Concurrent access without proper timeout
- Solution: Use `timeout=30` when connecting

**Error: FTS5 not available**
- Cause: SQLite compiled without FTS5 support
- Solution: Upgrade SQLite or use FTS4 fallback

**Error: Empty search results**
- Cause: FTS index not synced with data
- Solution: Rebuild FTS index with `INSERT INTO chunks_fts(chunks_fts) VALUES('rebuild')`

**Error: Memory issues with large collections**
- Cause: Loading all chunks at once
- Solution: Process in batches, commit every 500 documents