{"id":5562,"plugin_id":"plugin_asdk_app_695bfc98071c8191bac7bc479aa27de7","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T22:45:19.721Z","digest":"215363c76bfd99937ad9e29d7aae99687ddf9b7c0e014666386b36a433065bd8","against":null,"payload":{"name":"box","description":"Foundation skill for working with Box in ChatGPT or Codex. Use whenever a request involves Box files, folders, search, sharing, metadata, AI, Hubs, Doc Gen, authentication, MCP, Codex CLI or REST access, SDK code, webhooks, or Box errors. Start here to select the available tool path and relevant domain reference.","included_files":[{"relative_path":"references/ai-and-retrieval.md","size_in_bytes":4586},{"relative_path":"references/auth-and-setup.md","size_in_bytes":7977},{"relative_path":"references/box-cli.md","size_in_bytes":3841},{"relative_path":"references/bulk-operations.md","size_in_bytes":5357},{"relative_path":"references/collaboration.md","size_in_bytes":4095},{"relative_path":"references/content-workflows.md","size_in_bytes":3468},{"relative_path":"references/mcp-doc-gen.md","size_in_bytes":2871},{"relative_path":"references/mcp-hubs.md","size_in_bytes":2708},{"relative_path":"references/mcp-search.md","size_in_bytes":1765},{"relative_path":"references/rest-calls.md","size_in_bytes":4531},{"relative_path":"references/troubleshooting.md","size_in_bytes":3631},{"relative_path":"references/webhooks-and-events.md","size_in_bytes":1646}],"skill_md_contents":"---\nname: box\ndescription: \"Foundation skill for working with Box in ChatGPT or Codex. Use whenever a request involves Box files, folders, search, sharing, metadata, AI, Hubs, Doc Gen, authentication, MCP, Codex CLI or REST access, SDK code, webhooks, or Box errors. Start here to select the available tool path and relevant domain reference.\"\n---\n\n# Box\n\n## Overview\n\nThis skill targets OpenAI products. In ChatGPT, use Box MCP only and ignore all CLI and REST paths. In Codex, MCP, CLI, and REST are available as described below. When building application code in Codex, preserve the repository's existing Box SDK or REST architecture.\n\n## Route The Request\n\n### Identify the product and authenticated tools\n\n- **ChatGPT:** Use only Box MCP. Call `who_am_i`; a successful response confirms the connected Box user. If it fails with an authentication error, complete the client-provided Box OAuth flow and retry. If MCP is not configured, use `references/auth-and-setup.md`. Do not check for or use CLI or REST.\n- **Codex:** Check the available Box paths:\n  - **MCP:** Call `who_am_i`. A successful response confirms the connected Box user.\n  - **CLI:** Run `box users:get me --json`. A successful response confirms that Box CLI is installed, authenticated, and identifies the active CLI actor.\n  - **REST:** Confirm `BOX_ACCESS_TOKEN` is present without printing it, then call `GET https://api.box.com/2.0/users/me` to validate the token and identify its actor.\n\nIn Codex, use authenticated MCP when available. If a check fails, use `references/auth-and-setup.md`, `references/box-cli.md`, or `references/rest-calls.md` for the relevant path.\n\nTool definitions and current Box documentation are authoritative for live parameters, supported operations, and limits.\n\n### Domain routing\n\nChoose the matching domain reference regardless of tool path:\n\n\n| Request                                                                              | Reference                           |\n| ------------------------------------------------------------------------------------ | ----------------------------------- |\n| Authentication, actor selection, or initial setup                                    | `references/auth-and-setup.md`      |\n| Uploads, downloads, previews, files, folders, moves, copies, properties, or metadata | `references/content-workflows.md`   |\n| Collaborations, shared links, comments, or access changes                            | `references/collaboration.md`       |\n| Keyword, folder-name, or metadata search                                             | `references/mcp-search.md`          |\n| Box AI Q&A, extraction, summarization, or document retrieval                 | `references/ai-and-retrieval.md`    |\n| Box Hubs creation, curation, or Q&A                                                  | `references/mcp-hubs.md`            |\n| Box Doc Gen templates or generated documents                                         | `references/mcp-doc-gen.md`         |\n| Bulk organization, folder trees, migrations, moves, or metadata writes               | `references/bulk-operations.md`     |\n| Webhooks, events, ingestion, or catch-up synchronization                             | `references/webhooks-and-events.md` |\n| 401, 403, 404, 409, 429, missing content, missing tools, or wrong-actor errors       | `references/troubleshooting.md`     |\n\n\n### Codex-only CLI and REST fallbacks\n\nIgnore these paths in ChatGPT.\n\n- **Use CLI in Codex** only after `box users:get me --json` confirms it is configured and authenticated. Use it when the required operation is unavailable through MCP, the user explicitly requests CLI, or the deliverable requires a local reproducible command. For bulk actions, prefer CLI only when this availability check succeeds. Read `references/box-cli.md` in addition to the domain reference.\n- **Use REST in Codex** when building or debugging application code that calls the Box API, or when neither MCP nor CLI can perform the required operation. Use it only after confirming REST authentication is configured. Read `references/rest-calls.md` in addition to the domain reference. Prefer an existing official Box SDK or HTTP abstraction in application code.\n\n## MCP\n\nThe Box MCP server is the only Box tool path in ChatGPT. It provides structured operations for content, search, collaboration, AI, metadata, Hubs, and Doc Gen.\n\n### Tool availability and documentation\n\nThe maintained list of Box MCP tools is at [https://docs.box.com/en/box-mcp/tools](https://docs.box.com/en/box-mcp/tools). If an expected tool is absent, check that list first, then use the MCP-tool section of `references/troubleshooting.md` for client and Box Admin Console enablement steps."},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}