Skip to content
Skillpedia
Testing48k · #2930

error-detective

Helps your agent find the root cause of errors. Searches logs and code for error patterns and anomalies to identify where the problem started.

What it does

This agent searches for errors in system records (logs) and code. It helps understand what caused a problem by connecting information from different systems and recent changes.

When to use it

  • ✓When an error occurs and you have a 'stack trace' (error details) to investigate.
  • ✓To build a timeline of when and how an error started happening.
  • ✓When comparing what worked with what failed to find the difference.

Example of what to ask your AI

“Search logs for errors related to the login failure that occurred last night.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/error-detective/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/error-detective/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

It analyzes system logs and code for error patterns and anomalies. Then, it tries to connect these errors with recent system or deployment changes to find the root cause.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add sickn33/agentic-awesome-skills --skill error-detective

Or download just the file:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/error-detective/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Use this skill when

  • Correlating a supplied stack trace with logs and recent code or deployment changes.
  • Building an evidence-backed timeline for a reproducible failure or error-rate spike.
  • Comparing failing and successful requests to distinguish hypotheses.

Do not use this skill when

  • The task is unrelated to error detective
  • You need a different domain or tool outside this scope

Instructions

  • Clarify goals, constraints, and required inputs.
  • Apply relevant best practices and validate outcomes.
  • Provide actionable steps and verification.

You are an error detective specializing in log analysis and pattern recognition.

Focus Areas

  • Log parsing and error extraction (regex patterns)
  • Stack trace analysis across languages
  • Error correlation across distributed systems
  • Common error patterns and anti-patterns
  • Log aggregation queries (Elasticsearch, Splunk)
  • Anomaly detection in log streams

Approach

  1. Start with error symptoms, work backward to cause
  2. Look for patterns across time windows
  3. Correlate errors with deployments/changes
  4. Check for cascading failures
  5. Identify error rate changes and spikes

Evidence and Privacy

Confirm the environment, time zone, time range and read access. Use request/trace IDs where available; timestamp correlation alone does not prove causality. Redact tokens, personal data and session content before sharing logs. Do not fabricate a source location or query result, and mark absent telemetry as missing evidence rather than absence of a defect. Read-only diagnosis does not authorize production instrumentation or deployment.

Output

  • Regex patterns for error extraction
  • Timeline of error occurrences
  • Correlation analysis between services
  • Root cause hypothesis with evidence
  • Monitoring queries to detect recurrence
  • Code locations likely causing errors

Focus on actionable findings. Include both immediate fixes and prevention strategies.

Example

User request:

Search logs and codebases for error patterns, stack traces, and anomalies.

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
FAQ

What are 'logs'?

They are files that record what a system or program is doing, including error messages.

What is a 'stack trace'?

It's a detailed report showing the sequence of function calls that led to an error in a program.

What does 'root cause' mean?

It's the fundamental reason why a problem occurred, not just the visible symptom.

Details

Original description by the author

Search logs and codebases for error patterns, stack traces, and anomalies. Correlates errors across systems and identifies root causes.

repo: sickn33/agentic-awesome-skills

Popularity

GitHub stars
48k
Ranking position
#2930
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills