error-review

Parse `errors.jsonl` files to diagnose agent errors and patch instruction files.

Updated Jun 4, 2025

Search Tags:#debugging #error analysis #developer tool #code fixing #instruction tuning #agent errors

Ready to run

npx skills add https://github.com/expectedparrot/vernon --skill error-review

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: error-review
Source: https://github.com/expectedparrot/vernon/tree/main/macaw/ep-agent/skills/error-review
Command: npx skills add https://github.com/expectedparrot/vernon --skill error-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill helps developers identify the root causes of agent errors from a run and interactively patch the agent's instruction files to prevent recurrence.

Core Features & Use Cases

Error Diagnosis: Analyzes errors.jsonl files to categorize and pinpoint the source of agent failures.
Instruction Patching: Guides the developer in making targeted edits to agent prompts and skill files to fix identified issues.
Use Case: After an agent run produces errors, use this skill to quickly find the most recent error log, understand why the agent failed (e.g., incorrect API usage, wrong file path), and apply the necessary corrections to the agent's configuration.

Quick Start

Use the error-review skill to find and fix the most recent agent errors.

Frequently Asked Questions about error-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I debug agent errors from a recent execution run?▼

Debug agent errors by parsing `errors.jsonl` log files to diagnose root causes like incorrect working directories or EDSL API misuse, then interactively applying targeted fixes to instruction files.

What causes agent execution failures related to EDSL API misuse?▼

Agent execution failures stem from EDSL API misuse, incorrect working directories, file format errors, and script path problems. Reviewing `errors.jsonl` files pinpoints these specific sources of agent failures.

How do I fix incorrect working directories and file format errors in agent prompts?▼

Fix incorrect working directories and file format errors by applying targeted edits to agent instruction files. The skill guides developers in patching `system_prompt.md` and skill-specific `.md` files.

What's the best way to patch instruction files after an agent run produces errors?▼

Patch instruction files after an agent run produces errors by interactively diagnosing the `errors.jsonl` log and applying minimal corrections to `system_prompt.md` or skill-specific `.md` files.

Agent instruction patching not working for script path problems, what are the limitations?▼

Instruction patching for script path problems is limited to suggesting and applying targeted fixes to `.md` instruction files. It corrects agent configurations but does not modify underlying executable script code.