skills.rest
davidkelley
davidkelleyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/davidkelley/searchlite --skill debugging-playbook
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
hw-native-syshw-native-sys
11

create-issue

Reproduce reported problems, collect dependency versions, and create GitHub issues.

Official
Advanced
GantisStormGantisStorm
91

gitlab-cli

Wrap the glab CLI to manage GitLab merge requests, issues, and pipelines.

Community
Intermediate
davidkelleydavidkelley

integration-testing

Automate end-to-end integration testing of Searchlite CLI and HTTP interfaces.

Community
Advanced
krishna-cyberkrishna-cyber

dev-browser

Connect to a persistent Chrome instance for fallback browser automation.

Community
Advanced