OP
export-download-debugging
Диагностика и исправление сбоев экспорта и скачивания в браузере, превью или Electron. Помогает при проблемах с Save As, Blob/Data URL, File System Access API, createWritable и файлами размером 0 КБ.
Что делает навык
Навык диагностирует и исправляет сбои экспорта и скачивания файлов, когда результат — пустой, отсутствующий или нерабочий файл. Он помогает отладить проблемы с Save As, Blob/Data URL, File System Access API, createWritable и файлами размером 0 КБ в браузере, iframe и Electron.
Когда применять
- Экспорт или скачивание визуально завершается, но создается файл размером 0 КБ.
- Проблемы с превью в браузере или iframe, связанные с MIME-типами или песочницей.
- Сбои при использовании File System Access API (showSaveFilePicker, createWritable) в браузере.
- Некорректная обработка скачиваний в оболочке Electron (will-download).
Как работает
- Разделите захват данных и сохранение: убедитесь, что полезная нагрузка экспорта имеет ненулевую длину, прежде чем отлаживать путь сохранения.
- Запишите тип полезной нагрузки, MIME-тип, длину в байтах, путь к объекту/Data URL и возникшую ошибку; проверьте консоль браузера и логи приложения.
- Проверьте параметры showSaveFilePicker, createWritable, <a download>, URL.createObjectURL и отзыва URL; в Electron проверьте путь will-download (имя файла, MIME, фильтры, отмену, размер).
- Подтвердите фактический размер файла на диске и возможность его открытия в обычном просмотрщике изображений.
- Подготовьте и проверьте полезную нагрузку; отключите кнопку Save, пока байты не станут доступны.
- Используйте самый простой стабильный канал сохранения: если createWritable() не работает, используйте <a download> или менеджер загрузок Electron.
Примеры запросов агенту
Почему при экспорте в PNG создается файл размером 0 КБ?
Исправь ошибку с сохранением файла через showSaveFilePicker в браузере.
Помоги отладить скачивание в Electron: файл создается, но не открывается.
Что понадобится
- Доступ к консоли браузера и логам приложения.
- Инструменты проверки размера файла на диске.
- Среда выполнения с поддержкой File System Access API или Electron.
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «export-download-debugging» из репозитория:
# https://github.com/nexu-io/open-design
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r export-download-debugging/ ~/.claude/skills/export-download-debugging/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.