sketch-upload-pipeline
Upload pipeline troubleshooting for Sketch Magic. Use when HEIC uploads fail, previews don’t render, files are too large, or upload validation errors appear.
📖 中文导读:Upload pipeline troubleshooting for Sketch Magic. Use when HEIC uploads fail, previews don’t render, files are too large, or upload validation errors appear. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: sketch-upload-pipeline description: Upload pipeline troubleshooting for Sketch Magic. Use when HEIC uploads fail, previews don’t render, files are too large, or upload validation errors appear.
Sketch Upload Pipeline
Overview
Standardize debugging for uploads, HEIC conversion, size limits, and preview lifecycle issues.
Workflow
1) Confirm client validation
- Allowed types: PNG, JPG, HEIC/HEIF, WebP.
- Size limit:
MAX_UPLOAD_MB/DEFAULT_MAX_UPLOAD_BYTES(10 MB default).
2) HEIC conversion path
- Client converts HEIC to JPEG via
heic2anybefore upload when possible. - If conversion fails, original file is still used and may preview as blank in some browsers.
3) Preview lifecycle
- Ensure object URL creation/revocation is stable (no early revoke).
- Confirm
sketch-preview-imageloads withnaturalWidth > 0.
4) Server constraints
- Check server body limits (Next.js proxy body size).
- Confirm
/api/converthandles large payloads within timeout.
5) Report safely
- Do not log image bytes or PII.
- Capture file type/size and error code only.
References
references/upload-pipeline.md