frappe-agent-debugger

Classify Frappe/ERPNext errors and guide bench and log investigation.

163|53|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-debugger-impertio-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frappe-agent-debugger
Source: https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package/tree/main/skills/source/agents/frappe-agent-debugger
Command: npx skills add https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-debugger-impertio-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It eliminates wasted trial-and-error debugging when Frappe/ERPNext fails in ways that look correct but break in production, such as misleading tracebacks, silent failures, or background-job errors.

Core Features & Use Cases

  • Error classification & mechanism detection: Systematically identifies whether an issue is Python, JavaScript, database, permission, hook, scheduler, or build related, then maps it to the likely Frappe mechanism (controller, server script, client script, hook, scheduler, API, build pipeline).
  • Evidence-first investigation: Guides you to use bench console, frappe.logger, browser DevTools, and the Error Log DocType to find the decisive evidence rather than guessing.
  • Deterministic diagnosis checklists: Applies targeted checklists for each error class (common patterns, likely causes, and safe remediation steps) and ends by producing a fix plus verification steps.
  • Use case: When a Sales Invoice submit fails with an ImportError or when a scheduled task runs but does nothing, this Skill provides a step-by-step path to identify the failing code path, the correct logs/tables to inspect, and the precise fix to apply.

Quick Start

When you see a failing request or traceback, tell the AI to classify the error, identify the mechanism, point to the relevant Frappe logs/files/bench commands, and produce a corrected fix with verification steps.

Frequently Asked Questions about frappe-agent-debugger

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

FAQPage Schema
How do I debug a Frappe traceback when the error message is misleading?

To debug a misleading Frappe traceback, use bench console and frappe.logger to trace the exact failing code path. This Skill classifies the Python error and guides evidence-based inspection to find the true underlying mechanism.

Why does my Frappe scheduler run but not execute the background job?

A Frappe scheduler that runs without executing background jobs often indicates hook misfires or silent behavioral failures. Use bench doctor and Error Log DocType inspection to find the decisive evidence for a targeted fix.

What is the best way to diagnose silent failures in ERPNext?

Diagnosing silent failures in ERPNext requires evidence-first investigation using browser DevTools and frappe.logger. This approach systematically maps the issue to the correct Frappe mechanism and applies a targeted diagnosis checklist.

Can I fix Frappe permission problems causing document submit to fail?

You can fix Frappe permission problems by classifying the error and inspecting role-based access controls. This Skill guides you through specific database and permission diagnosis checklists to identify and resolve the access denial.

How do I troubleshoot database schema runtime issues in Frappe?

Troubleshooting Frappe database schema runtime issues involves using bench mariadb to inspect the database directly. This Skill provides deterministic checklists to classify the database problem and apply safe remediation steps.

Does this approach work for JavaScript console errors in Frappe?

Yes, this approach works for JavaScript console errors by classifying them as client script or build pipeline issues. It guides you to use browser DevTools to find the decisive evidence and produce a corrected fix with verification steps.