Does this skill work with JSON-formatted logs?

Yes, it includes specialized utility scripts for parsing and filtering JSON logs using jq, allowing you to filter by severity level or specific metadata fields.

How does this skill handle extremely large log files?

It follows a 'Filter First' strategy, using grep and bash tools to extract only relevant lines before attempting to read the content, ensuring efficiency and preventing context window overflow.

Can I trace a single user request across multiple logs?

Yes, the skill includes specific workflows and scripts to trace correlation IDs or request IDs across multiple log files to reconstruct a transaction history.

What kind of statistical analysis can it perform on logs?

The skill can aggregate errors by frequency, show error distribution over time (hourly or minute buckets), and identify slow operations by duration.

Log Analysis & Debugging

Name: Log Analysis & Debugging
Author: rileyhilliard

byrileyhilliard

•

Analytics & Monitoring

Analyzes large-scale application logs efficiently through targeted filtering and iterative refinement to identify root causes and patterns.

The Reading Logs skill provides a high-performance framework for Claude to navigate complex log environments without exhausting context windows. Built on the 'Filter First' iron law, it utilizes advanced grep strategies, time-window isolation, and specialized utility scripts to aggregate errors, trace correlation IDs across files, and extract stack traces. This skill is essential for developers performing incident response, debugging performance bottlenecks, or analyzing recurring error patterns in high-volume production logs.

Key Features

0162 GitHub stars

02Error aggregation and frequency analysis for pattern detection

03Targeted filtering using grep and regex to isolate relevant log events

04Time-window isolation to narrow searches to specific incident periods

05Request ID tracing to follow specific transactions across multiple files

06Specialized parsing for JSON logs and stack trace extraction

Use Cases

01Debugging recurring application issues by analyzing frequency and distribution

02Extracting and grouping stack traces from large log files for root cause analysis

03Investigating production timeouts and errors using correlation IDs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rileyhilliard/claude-essentials reading-logs

For use in Claude.ai and ChatGPT

Download Skill