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
Ready-to-paste message
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-detectiveOr 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.mdTechnical 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
- Start with error symptoms, work backward to cause
- Look for patterns across time windows
- Correlate errors with deployments/changes
- Check for cascading failures
- 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.
Popularity
- GitHub stars
- 48k
- Ranking position
- #2930
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
cpp-testing
Makes your agent write and improve tests for C++ code. It helps set up testing tools and fix errors.
affaan-m/ECC
csharp-testing
Helps your agent create tests for C# and .NET code. It uses best practices to ensure tests are efficient and reliable.
affaan-m/ECC
django-tdd
Enables your agent to apply testing strategies for Django with pytest-django and TDD. It's useful for writing robust tests and ensuring code quality, especially for DRF APIs.
affaan-m/ECC