export-download-debugging

Diagnose and resolve failed browser or Electron file exports and download operations.

93.2k|10.8k|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/nexu-io/open-design --skill export-download-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: export-download-debugging
Source: https://github.com/nexu-io/open-design/tree/main/skills/export-download-debugging
Command: npx skills add https://github.com/nexu-io/open-design --skill export-download-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the frustration of silent export failures, 0 KB file downloads, and broken file system access in web and Electron-based design applications.

Core Features & Use Cases

  • Diagnostic Workflow: Systematically isolates capture failures from save failures to identify the root cause of empty or unusable files.
  • Platform-Specific Fixes: Provides targeted strategies for browser-based showSaveFilePicker issues, Blob/Data URL handling, and Electron will-download event management.
  • Use Case: When a user reports that an image export results in a 0 KB file, use this Skill to verify payload readiness, validate MIME types, and implement a stable fallback save channel.

Quick Start

Analyze the current export failure by checking the payload byte length and browser console logs for errors related to showSaveFilePicker or createWritable.

Frequently Asked Questions about export-download-debugging

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

FAQPage Schema
How do I fix a 0 KB file download in my app?

A 0 KB file usually indicates the file handle was created but the write operation failed. Ensure the export payload is fully prepared and contains non-zero bytes before triggering the save dialog or file picker.

Why does showSaveFilePicker fail in my browser app?

The File System Access API may fail due to sandbox restrictions, lack of user gesture, or unsupported MIME types. Verify that the call is triggered by a direct user action and consider falling back to an anchor tag download.

How to handle image exports in Electron?

Use the Electron will-download event to intercept the download process. Inspect the filename, MIME type, and save dialog filters to ensure the file is correctly routed and saved with the expected extension.

When should I use a data URL instead of a blob URL?

Use a verified non-empty data URL as a fallback when blob URLs fail due to revocation timing, CSP restrictions, or iframe sandboxing issues. Data URLs are self-contained and avoid issues with object URL lifecycle management.