Jia-ben00

Log Triage — Code Quality skill for Claude Code

Code Quality community

Triage application logs and find the root cause fast.

How to install Log Triage

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Jia-ben00/log-triage and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Log Triage does

Triage application logs and find the root cause fast. Multi-format parser (JSON/syslog/nginx/Python-Java stacktraces), error correlation, pattern clustering, ranked root-cause hypotheses with next steps. Agent Skill + stdlib Python.

Alternatives in Code Quality

Import Drawio — Redraw a draw.io file as an editorial diagram at a chosen format, size, and detail level 27.2k ★
Job Stories — Create job stories with acceptance criteria in JTBD format 7.8k ★
Video Script: Claude SEO V1.7.2 — What's New — Duration: ~5 minutes Tone: Natural, conversational, like talking to a friend who knows Claude Code Format: Scr 5k ★

README

log-triage

[![CI](https://github.com/Jia-ben00/log-triage/actions/workflows/smoke.yml/badge.svg)](https://github.com/Jia-ben00/log-triage/actions) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Turn raw application logs into a ranked root-cause report — no more blind grepping. An Agent Skill for Claude Code / Codex / Cursor, with zero dependencies (Python stdlib only).

What it does

Parses multi-format logs (JSON lines, plain text, syslog, nginx, Python/Java stacktraces) into structured events
Correlates errors by request-id / trace-id / time proximity into error chains
Clusters repeating error patterns (variables stripped)
Ranks root-cause hypotheses by confidence (12 signature patterns: connection refused, timeout, OOM, disk full, circuit breaker, etc.)
Rebuilds a compact timeline of key events
Outputs an actionable report with severity, impact, and concrete next steps

Quick start

**As a GitHub Action (no agent required):**

- uses: Jia-ben00/log-triage@v0.1.0
  with:
    log-path: ./build-logs
    fail-on: error   # never | warning | error | critical

Outputs: `severity`, `root-cause`, `error-count`. Perfect for analyzing CI failure logs.

**As a CLI / agent skill:**

# Parse a log file or directory (auto-detects format)
python scripts/parse_logs.py /var/log/app > events.json

# Triage parsed events
python scripts/triage.py events.json

# One-liner: parse and triage in one shot
python scripts/parse_logs.py app.log | python scripts/triage.py -

Example output

=== TRIAGE REPORT ===
Severity: CRITICAL | Events: 27 | Errors: 11 | Warnings: 2
Most likely root cause: downstream service unreachable (confidence: high)
Next steps:
  - Check if the target service is running
  - Verify network policy / firewall rules
  - Check service discovery / DNS resolution

The full JSON report includes root-cause hypotheses, error chai