fabric-pyspark-perf-remediate

Diagnose and remediate Spark performance issues in Microsoft Fabric PySpark workloads.

16|1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/PatrickGallucci/fabric-skills --skill fabric-pyspark-perf-remediate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fabric-pyspark-perf-remediate
Source: https://github.com/PatrickGallucci/fabric-skills/tree/main/skills/fabric-pyspark-perf-remediate
Command: npx skills add https://github.com/PatrickGallucci/fabric-skills --skill fabric-pyspark-perf-remediate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyspark, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Diagnose and remediate Spark performance problems in Microsoft Fabric PySpark workloads across notebooks, job definitions, and pipelines, enabling faster runtimes and more reliable analytics.

Core Features & Use Cases

  • Triage workflow to identify bottlenecks in Spark applications (skew, shuffle, OOM, and capacity throttling)
  • Prebuilt diagnostic scripts (identify_skew.py, spark_health_check.py, delta_table_health.py) and notebook templates
  • Guidance for applying remediation steps and best practices

Quick Start

Activate the skill in your Fabric workspace and run the diagnostic scripts to identify the root cause and apply recommended remedies.

Frequently Asked Questions about fabric-pyspark-perf-remediate

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

FAQPage Schema
How do I diagnose slow PySpark performance in Microsoft Fabric notebooks?

To diagnose slow PySpark performance in Fabric, run prebuilt diagnostic scripts like spark_health_check.py to identify bottlenecks such as stage skew, shuffle issues, or capacity throttling. It provides a structured triage workflow for notebooks and pipelines.

Why does my Fabric PySpark job fail with out of memory errors?

PySpark out of memory errors in Fabric can be diagnosed using the identify_skew.py script to detect stage skew and OOM conditions. The skill provides remediation steps and best practices to resolve memory exhaustion and capacity throttling.

Can I use this to troubleshoot Delta Lake write performance in Fabric?

Yes, you can troubleshoot Delta Lake write performance using the delta_table_health.py diagnostic script. It identifies bottlenecks in Delta writes and applies structured remediation workflows to optimize write operations across Fabric data pipelines.

Do I need pyspark installed to use these Fabric performance diagnostics?

Yes, pyspark is a required dependency. The diagnostic scripts and remediation workflows are built for PySpark workloads running in Microsoft Fabric environments, including Spark Job Definitions and data pipelines.

What is the best way to identify data skew in a Fabric Spark Job Definition?

The best way to identify data skew in Fabric Spark Job Definitions is running the identify_skew.py diagnostic script. It detects stage skew and shuffle bottlenecks, then applies targeted remediation quick fixes to improve runtime reliability.