debugging-playbook

Guide debugging of Searchlite failures across CLI, HTTP, storage, and indexing surfaces.

Updated Dec 20, 2025

Search Tags:#debugging #troubleshooting #CLI #triage #HTTP #searchlite #inspecting

Ready to run

npx skills add https://github.com/davidkelley/searchlite --skill debugging-playbook

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: debugging-playbook
Source: https://github.com/davidkelley/searchlite/tree/main/.codex/skills/debugging-playbook
Command: npx skills add https://github.com/davidkelley/searchlite --skill debugging-playbook

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a concise playbook for diagnosing Searchlite issues across the CLI, HTTP API, storage, and indexing layers, reducing mean time to resolution during triage.

Core Features & Use Cases

Structured triage workflow: guides engineers through surface areas (commit/refresh, durability, and reader visibility) to identify root causes.
Reproducible debugging steps: captures versions, feature flags, and minimal reproduction scenarios to ensure consistent testing.
CLI/HTTP guidance: prescribes inspection commands (inspect, stats), maintenance actions (compact), and common remedies for stale reads or missing commits.

Quick Start

To begin debugging, collect environment details, run a minimal reproduction of the failure with small data, then apply the triage checklist using the CLI or HTTP endpoints described in this playbook.

Frequently Asked Questions about debugging-playbook

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

FAQPage Schema

How do I troubleshoot Searchlite indexing failures and stale reads?▼

Triage Searchlite indexing failures by inspecting commit/refresh lifecycles and reader visibility via CLI and HTTP endpoints to pinpoint root causes.

What is the best way to debug Searchlite commit and refresh lifecycle issues?▼

Debug Searchlite commit and refresh lifecycle issues by capturing exact versions, generating minimal reproductions with small data, and applying a targeted triage checklist using CLI inspection and HTTP API endpoints.

Can I inspect Searchlite storage durability artifacts using the HTTP API?▼

Yes, you can inspect Searchlite storage durability artifacts using prescribed HTTP API endpoints and CLI inspection commands to identify missing commits and guide targeted maintenance actions.

How do I fix missing commits or stale reads during Searchlite triage?▼

Fix missing commits and stale reads during Searchlite triage by applying common maintenance remedies and commands, such as compact actions, prescribed through the CLI and HTTP API inspection surfaces.

What steps are needed to reproduce Searchlite HTTP and CLI errors consistently?▼

To reproduce Searchlite HTTP and CLI errors consistently, collect environment details and feature flags, run a minimal reproduction scenario with small data, and capture exact versions before applying the triage checklist.