frappe-errors-hooks

Diagnose Frappe/ERPNext hooks.py errors and map symptoms to corrected configurations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you diagnose and fix Frappe/ERPNext failures caused by misconfigured hooks.py, so hook handlers actually fire and production errors don’t silently break workflows.

Core Features & Use Cases

  • Hook registration diagnosis: Identifies why doc_events, scheduler_events, permission_query_conditions, and extend_bootinfo don’t work (wrong dotted path, wrong dict structure, DocType key typos, missing assets path format).
  • Safe error-handling patterns: Enforces production-safe practices like never throwing in permission hooks, never committing inside doc_events, and isolating wildcard handlers with try/except to prevent system-wide save failures.
  • Version-aware resolution for Frappe v14-v16: Covers scheduler not running, circular imports, override/extend behavior, fixture loading problems, and extend_doctype_class [v16+] conflicts.

Quick Start

Ask the AI to analyze your hooks.py symptom and provide the exact fix for the failing hook type using the mapping rules and safe patterns for your Frappe version.

Frequently Asked Questions about frappe-errors-hooks

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

FAQPage Schema
Why are my Frappe doc_events not firing in production?

Frappe scheduler_events fail when hooks.py uses incorrect dict structures or wrong dotted paths. Map these scheduler hook symptoms to root causes and apply corrected configurations to restore scheduled task execution.

How do I fix permission_query_conditions failures in Frappe?

Fix Frappe permission_query_conditions by ensuring hooks never throw exceptions and applying production-safe error-handling guardrails. This prevents system-wide save failures and resolves incorrect path mappings.

How to resolve override_doctype_class circular imports in Frappe v16?

Resolve override_doctype_class circular imports in Frappe v16 using version-aware conflict resolution. Map import symptoms to corrected configurations to safely extend doctype classes without breaking production.

What is the best way to debug app_include_js not loading in ERPNext?

The best way to debug app_include_js not loading is verifying the assets path format in hooks.py. Diagnosing hook registration identifies missing path formats and maps them to corrected configurations.

Can I use wildcard handlers in extend_bootinfo without breaking Frappe?

Wildcard handlers in extend_bootinfo are safe when wrapped in try/except blocks. Isolate wildcard handlers to prevent system-wide save failures and maintain production-safe error handling.

Why do my Frappe fixtures fail to load during installation?

Frappe fixtures fail during installation due to hook loading mistakes in hooks.py. Diagnose fixture loading problems and map them to corrected configurations to ensure proper installation.