What problem does it solve?
This Skill helps frontend code use the authenticated app-file and API surface correctly, avoiding unsafe path assumptions and permission mistakes when reading, writing, discovering, or downloading app data.
Core Features & Use Cases
- Permission-aware file operations: Use space.api wrappers for listing, reading, writing (including incremental edits), deleting, copying, and moving app files.
- Indexed discovery and pattern matching: Discover files with server-side file_paths using patterns and optional writable-only constraints.
- User identity and scope: Snapshot the current user via userSelfInfo and apply logical path rules for ~, L1, and L2.
- Secure downloads and preflight checks: Generate authenticated folder download URLs and optionally preflight with fileInfo or folder_download HEAD.
- Git history workflows (if enabled): Leverage gitHistoryList/diff/preview/rollback/revert on writable history roots when CUSTOMWARE_GIT_HISTORY=true.
Quick Start
Use the App Files And APIs skill to list the current user's writable files under L2/alice/ and then append a line to a target log file using the appropriate space.api helpers.