← Back to Skills Marketplace
Error Diagnosis
by
charlie-morrison
· GitHub ↗
· v1.0.0
· MIT-0
51
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install error-diagnosis
Description
Analyze error messages and logs to identify root causes of crashes, build failures, or runtime errors and suggest actionable fixes with code examples.
README (SKILL.md)
Error Diagnosis
Analyze error messages, stack traces, and log output to diagnose root causes and suggest fixes. Use when debugging crashes, runtime errors, build failures, or unexpected behavior.
Usage
Diagnose this error: [paste error message or stack trace]
Or with context:
Diagnose: [error]. Language: [lang]. Framework: [framework]. Recent changes: [what changed].
How It Works
- Parse — extract error type, message, file locations, line numbers from raw output
- Classify — categorize the error (syntax, runtime, dependency, config, permission, network, OOM, etc.)
- Trace — follow the call stack to identify the originating code vs. where the error surfaced
- Diagnose — determine root cause using error patterns, common pitfalls, and framework-specific knowledge
- Fix — provide actionable fix with code snippets
Supported Error Sources
- Stack traces: Python, JavaScript/Node.js, Java, Go, Rust, C/C++, Ruby, PHP
- Build errors: npm, pip, cargo, gradle, maven, webpack, vite, tsc
- Runtime errors: segfaults, OOM, deadlocks, race conditions, type errors
- Infrastructure: Docker, Kubernetes, systemd, nginx, database connection errors
- CI/CD: GitHub Actions, GitLab CI, CircleCI failure logs
Output Format
## Error Type
[Classification: e.g., "TypeError — accessing property of undefined"]
## Root Cause
[1-2 sentences explaining WHY this happened]
## Fix
[Code snippet or command to resolve]
## Prevention
[How to avoid this in the future: type check, test, lint rule, etc.]
Advanced Features
Multi-Error Analysis
Paste multiple errors — the skill identifies whether they share a root cause or are independent issues.
Regression Detection
This error started after [commit/change]. Analyze whether the change could cause this.
Environment Comparison
Works in dev, fails in prod. Error: [error]. Dev config: [config]. Prod config: [config].
Scripts
scripts/parse_stacktrace.py
Extracts structured data from raw stack traces:
python3 scripts/parse_stacktrace.py \x3C error.log
Returns JSON with error type, message, frames (file, line, function), and suggested search queries.
Usage Guidance
This skill looks coherent and low-risk: it includes a harmless Python parser and no extra permissions. Before using it, do not paste secrets, credentials, or entire unredacted production logs (the tool generates search queries that include snippets of your input). If you plan to run the included script locally, inspect it yourself (it's simple regex parsing) and run it in a sandboxed environment if you have any doubt. Finally, treat any suggested fixes as guidance—verify in a safe test environment before applying to production.
Capability Analysis
Type: OpenClaw Skill
Name: error-diagnosis
Version: 1.0.0
The skill bundle is a legitimate utility for parsing and diagnosing software error messages. The primary script, `scripts/parse_stacktrace.py`, uses standard regular expressions to extract file names and line numbers from stack traces (Python, JavaScript, Java, Go) and outputs structured JSON. There is no evidence of data exfiltration, network activity, or malicious prompt injection in SKILL.md.
Capability Assessment
Purpose & Capability
The name/description match the provided SKILL.md and the included parse_stacktrace.py. The script purpose (extracting error type, frames, and search queries) is directly relevant to diagnosing errors.
Instruction Scope
SKILL.md confines runtime behavior to parsing provided error text, classifying, tracing, and suggesting fixes. It does not instruct the agent to read system files, environment variables, or external config paths beyond what the user pastes or provides explicitly.
Install Mechanism
No install spec is present (instruction-only plus a small included Python script). There are no downloads, external installers, or archive extraction steps. The included script is readable, not obfuscated, and contains no network or exec calls.
Credentials
The skill declares no required env vars or credentials, which is appropriate. Note: the SKILL.md encourages pasting logs/configs and the parser builds search queries containing error text; these could contain sensitive info (tokens, file paths, emails) if users paste raw logs—so avoid or redact secrets before use.
Persistence & Privilege
always is false, no install writes or system modifications are requested, and the skill does not request persistent privileges or access to other skills' configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install error-diagnosis - After installation, invoke the skill by name or use
/error-diagnosis - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the error-diagnosis skill:
- Diagnoses root causes from error messages, stack traces, and logs for multiple languages and frameworks.
- Supports multi-error analysis, regression detection, and environment comparison workflows.
- Outputs structured diagnosis with error classification, root cause, actionable fix, and prevention guidance.
- Includes stack trace parsing script to extract structured error data from logs.
Metadata
Frequently Asked Questions
What is Error Diagnosis?
Analyze error messages and logs to identify root causes of crashes, build failures, or runtime errors and suggest actionable fixes with code examples. It is an AI Agent Skill for Claude Code / OpenClaw, with 51 downloads so far.
How do I install Error Diagnosis?
Run "/install error-diagnosis" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Error Diagnosis free?
Yes, Error Diagnosis is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Error Diagnosis support?
Error Diagnosis is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Error Diagnosis?
It is built and maintained by charlie-morrison (@charlie-morrison); the current version is v1.0.0.
More Skills