chess-teacher-logs

Search and inspect JSON-lines application logs across local buffers and shipped S3 segments.

1|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/daniel-brus/chess_teacher --skill chess-teacher-logs-daniel-brus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chess-teacher-logs
Source: https://github.com/daniel-brus/chess_teacher/tree/main/.agents/skills/chess-teacher-logs
Command: npx skills add https://github.com/daniel-brus/chess_teacher --skill chess-teacher-logs-daniel-brus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Debugging the chess_teacher app requires knowing where logs live: an active local JSON-lines buffer, rotated .ready segments awaiting upload, and historical segments shipped to S3. This Skill gives a read-only, structured way to search, tail, and inventory logs across all three tiers without guessing paths or credentials. ## Core Features & Use Cases - Buffer status and tailing: Inspect active log files, pending upload counts, and the most recent JSON log lines from the local buffer. - Cross-tier search: Filter log records by level, logger, substring, environment, time window, date, or pod hostname across local files and/or S3 segments. - Segment inventory and reading: List local pending and S3 shipped segments, then read a single segment by relative path or S3 key. - Use Case: A user asks why ingestion failed at 3pm in production. The agent runs a search against S3 with --level ERROR and --since filters, summarizes the matching JSON records, and correlates with pod hostnames. ## Quick Start Ask the agent to search production logs for errors in the last 24 hours using the log query script with the prod Doppler config.

Frequently Asked Questions about chess-teacher-logs

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

FAQPage Schema
How do I search application logs stored in S3?▼

Run the log query script with the search command and --source s3, filtering by --level, --since, --date, or --hostname. It lists segment keys under the logs/python/buffer prefix, reads each segment, and returns matching JSON records.

How do I check if logs are being shipped to S3?▼

Run the buffer-status command and inspect pending_upload_count. A count above zero while log shipping is enabled indicates upload lag or failures; the output also lists recent pending .ready segments.

What is the difference between local and S3 log sources?▼

Local source reads the active buffer and rotated .ready segments under LOG_BUFFER_DIR, covering the most recent minutes. S3 source reads shipped historical segments, which is the right choice for production history after the local buffer was cleared.

Can this tool modify or delete log files?▼

No. The skill is strictly read-only: it performs local file reads and S3 read_bytes and list_keys calls only. It never deletes .ready segments, triggers uploads, or runs the LogShipper.

Why does a local log search return no results?▼

Empty local results usually mean the app is not running or LOG_BUFFER_DIR points elsewhere; run the info command to confirm the resolved buffer directory. Also verify the Doppler config matches the environment under investigation.

How do I find logs from a specific Kubernetes pod?▼

Use search or segments with --hostname set to the pod name, since shipped segment paths include the HOSTNAME folder taken from the k8s pod name. For live container stdout instead, use kubectl logs via the VPS skill.