Name: mobile-files-media
Author: bekaku

Imported from bekaku/vue-ionic-example-app (.agents/skills/mobile-files-media/SKILL.md). Install upstream with npx skills add bekaku/vue-ionic-example-app --skill mobile-files-media. Copyright stays with the author.

mobile-files-media — Canonical Skill

Purpose

Enforce the verified file/media pipeline with platform-safe URI handling.

When to use

Camera capture, photo picking, chunked upload, download/open/share, save to gallery, permissions, scoped-storage/sandbox paths.

Required reading

skills/mobile/FILES_MEDIA.md

Relevant project locations

src/composables/useFileSystem.ts (active picker/save path), src/composables/useUpload.ts (active upload path)
src/composables/useCamera.ts (currently no import callers)
src/composables/useFileDownload.ts, src/utils/FileUtils.ts
src/api/FileManagerService.ts

Mandatory rules

Camera: getPhoto Uri + webUseInput, pickImages. Web has no gallery: savePicture/saveFile fall back to a browser download.
Save pipeline: base64 → Filesystem.writeFile (Directory.Data) → Media.savePhoto into AppAlbumName album.
Upload defaults: 1 MB chunks, one attempt unless maxRetries is overridden; FormData uploadChunkApi then merge DTO mergeChunkApi. In-memory chunk tracking is not restart-safe resume.
Validate paths, MIME, filenames; respect scoped storage / sandbox; request minimal permissions with isWeb() guards.
Blob URLs from fethCdnData must be released: use useBlobUrls() (track + auto-revoke on unmount), as BaseImage/BaseAvatar do. Downloads that must land on the device use useFileDownload.

Implementation workflow

Trace the caller's capture/pick → convert → store/upload → cleanup chain; do not assume the unreferenced useCamera.ts is the active path.
Handle permission-denied, cancel, retry-exhausted, large-file paths.
Clean temp files; confirm user-visible export location.
Verify per mobile-testing, incl. SECURITY (untrusted files).

Verification

Mocked picker/upload unit tests; real capture/save/share only on device.

{ "ocm": "1", "id": "bekaku-vue-ionic-example-app-mobile-files-media", "kind": "skill", "name": "mobile-files-media", "description": "Use this skill when working on camera, gallery, file pick/upload/download, file preview, sharing, or filesystem-backed media. For Preferences keys, use mobile-local-data.", "publisher": "bekaku", "version": "1.0.0", "capabilities": { "domains": [ "coding", "customer_support" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Use this skill when working on camera, gallery, file pick/upload/download, file preview, sharing, or filesystem-backed media. For Preferences keys, use mobile-local-data." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/bekaku/vue-ionic-example-app", "path": ".agents/skills/mobile-files-media/SKILL.md", "ref": "1b12c8cea7770c7730fb1016a17a9ddcec447327", "url": "https://github.com/bekaku/vue-ionic-example-app/blob/1b12c8cea7770c7730fb1016a17a9ddcec447327/.agents/skills/mobile-files-media/SKILL.md", "key": "bekaku/vue-ionic-example-app/.agents/skills/mobile-files-media/SKILL.md" } }, "instructions": "# mobile-files-media — Canonical Skill\n\n## Purpose\n\nEnforce the verified file/media pipeline with platform-safe URI handling.\n\n## When to use\n\nCamera capture, photo picking, chunked upload, download/open/share, save to\ngallery, permissions, scoped-storage/sandbox paths.\n\n## Required reading\n\n- `skills/mobile/FILES_MEDIA.md`\n\n## Relevant project locations\n\n- `src/composables/useFileSystem.ts` (active picker/save path),\n `src/composables/useUpload.ts` (active upload path)\n- `src/composables/useCamera.ts` (currently no import callers)\n- `src/composables/useFileDownload.ts`, `src/utils/FileUtils.", "cost": { "context_tokens": 476 } }

mobile-files-media

About