14f4eb1410
Document how ChatGPT widgets should handle uploads, library reuse, and file download URLs. ## Current state The ChatGPT apps reference lists the core `window.openai` helpers, but it does not explain the newer file-library flows or when app authors should choose one file API over another. That leaves widget implementations to guess between local upload, library-backed upload, and existing-file selection. ## What this PR does - updates the API surface list to show `uploadFile(file, options?)` - documents `selectFiles()` alongside the other ChatGPT-only helpers - adds a file-patterns section describing when to use plain uploads, library saves, library selection, and `getFileDownloadUrl` ## Riskiest parts This is a docs-only change, so the main risk is semantic accuracy if the described file-helper behavior drifts from the host implementation. ## Testing - Searched the repo for a checked-in automated test or CI entrypoint and did not find one: no root `package.json`, `pyproject.toml`, `Makefile`, `justfile`, workflow files, or documented test commands. - No automated tests were run because this repo does not appear to expose an automated test harness. ## Manual testing - Review the rendered markdown for `skills/.curated/chatgpt-apps/references/window-openai-patterns.md`. - Confirm the guidance matches current ChatGPT widget file flows for upload, library save, selection, and download URL access. ## Spiciness 1/5 Co-authored-by: Codex <noreply@openai.com>
Agent Skills
Agent Skills are folders of instructions, scripts, and resources that AI agents can discover and use to perform at specific tasks. Write once, use everywhere.
Codex uses skills to help package capabilities that teams and individuals can use to complete specific tasks in a repeatable way. This repository catalogs skills for use and distribution with Codex.
Learn more:
Installing a skill
Skills in .system are automatically installed in the latest version of Codex.
To install curated or experimental skills, you can use the $skill-installer inside Codex.
Curated skills can be installed by name (defaults to skills/.curated):
$skill-installer gh-address-comments
For experimental skills, specify the skill folder. For example:
$skill-installer install the create-plan skill from the .experimental folder
Or provide the GitHub directory URL:
$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan
After installing a skill, restart Codex to pick up new skills.
License
The license of an individual skill can be found directly inside the skill's directory inside the LICENSE.txt file.