frappe-syntax-reports

Standardize Frappe Query Reports, Script Reports, and Report Builder column formats and permissions.

163|53|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package --skill frappe-syntax-reports
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: frappe-syntax-reports
Source: https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package/tree/main/skills/source/syntax/frappe-syntax-reports
Command: npx skills add https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package --skill frappe-syntax-reports

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill codifies best practices for building and validating Query Reports, Script Reports, and Report Builders in Frappe to prevent common errors and ensure reliable reports.

Core Features & Use Cases

  • Standardizes column formats, permission handling, and chart integration across Query Reports, Script Reports, and Report Builder workflows.
  • Provides concrete examples and anti-patterns (references) to guide development and troubleshooting.
  • Supports safe migration from legacy SQL alias formats to dict-based column definitions and explicit doc permissions.

Quick Start

Review the references folder and align a new or existing report with the documented patterns to ensure correct column definitions, filters, and permissions.

Frequently Asked Questions about frappe-syntax-reports

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

FAQPage Schema
How do I standardize column formats and permissions in Frappe reports?▼

Standardizing Frappe reports involves applying deterministic patterns for column formats and explicit doc permissions across Query Reports, Script Reports, and Report Builder workflows. This ensures compliant SQL and reliable data outputs.

What is the best way to migrate legacy SQL alias formats in Frappe Script Reports?▼

The best way to migrate legacy SQL alias formats is to transition to dict-based column definitions. This modernizes Script Reports and ensures your data formats remain compatible across v14 through v16 Frappe environments.

How do I handle reference doc permissions when building Frappe Query Reports?▼

Handling reference doc permissions in Frappe Query Reports requires enforcing explicit permission checks during development. Applying these deterministic reporting patterns prevents unauthorized data access and common reporting errors.

Do I need to update my Frappe Report Builder workflows for v14 to v16 environments?▼

You need to update Frappe Report Builder workflows for v14 to v16 environments to ensure compliant SQL and proper chart integration. Aligning with current best practices prevents legacy format errors and ensures reliable dashboards.

Why does my Frappe Script Report fail permission checks during development?▼

Frappe Script Reports often fail permission checks during development due to missing explicit doc permissions. Reviewing documented anti-patterns and applying correct reference doc permissions resolves these access errors.