{"id":48892949,"url":"https://github.com/box/box-for-ai","last_synced_at":"2026-04-16T09:40:26.892Z","repository":{"id":346660708,"uuid":"1187616611","full_name":"box/box-for-ai","owner":"box","description":"A toolkit for developers to get the most out of the Box Platform using AI","archived":false,"fork":false,"pushed_at":"2026-04-01T21:50:56.000Z","size":80,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-02T09:23:46.909Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/box.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-20T23:53:24.000Z","updated_at":"2026-04-01T03:29:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/box/box-for-ai","commit_stats":null,"previous_names":["box/box-for-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/box/box-for-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/box%2Fbox-for-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/box%2Fbox-for-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/box%2Fbox-for-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/box%2Fbox-for-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/box","download_url":"https://codeload.github.com/box/box-for-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/box%2Fbox-for-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31880877,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T09:23:21.276Z","status":"ssl_error","status_checked_at":"2026-04-16T09:23:15.028Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-16T09:40:26.338Z","updated_at":"2026-04-16T09:40:26.884Z","avatar_url":"https://github.com/box.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Box Agent Skills\n\nAgent Skills to help developers using AI agents work with Box. Whether you're building Box integrations in code, working with Box content via MCP tools, configuring webhooks, or using Box AI retrieval — this plugin gives your assistant the context it needs to do it right.\n\nThe skills in this repo follow the [Agent Skills](https://agentskills.io/) format and can also be installed as a plugin for platforms like Codex, [Cursor](https://cursor.com), and [Claude Code](https://code.claude.com).\n\n## Installation\n\n### As an Agent Skill\n\n```bash\nnpx skills add box/box-for-ai\n```\n\nCheck out the latest and full list of skills [here](https://skills.sh/box/box-for-ai).\n\n### As a Platform Plugin\n\nThis repo can also be installed as a plugin for supported platforms. You configure the Box MCP server connection through your platform's MCP settings — see the setup guide for your platform below.\n\n| Platform | Setup guide |\n|---|---|\n| Codex | [`.codex-plugin/README.md`](.codex-plugin/README.md) |\n| Cursor | [`.cursor-plugin/README.md`](.cursor-plugin/README.md) |\n| Claude Code | [`.claude-plugin/README.md`](.claude-plugin/README.md) |\n\n## Usage\n\nSkills are automatically available once installed. The agent will use them when relevant tasks are detected. Here are some example prompts:\n\n### Implement Box content workflows\n\n`Add Box file upload to my app`\n\n`Create a shared link for this folder`\n\n`Set up Box webhooks for new file events`\n\n### Build document-driven flows\n\n`Search my Box account for invoices`\n\n`Use Box AI to classify documents`\n\n`Wire webhooks to process new uploads`\n\n### Troubleshoot integrations\n\n`Debug 401 errors with my Box JWT auth`\n\n`Fix webhook signature verification`\n\n## Skill Structure\n\nThe Box skill follows the [Agent Skills Open Standard](https://agentskills.io/):\n\n- `SKILL.md` - Skill manifest with frontmatter, routing table, workflow steps, and guardrails\n- `references/` - Individual reference files (auth, content workflows, MCP tool patterns, AI/retrieval, etc.)\n- `examples/` - Example prompts\n\n## Prerequisites\n\n- **Box CLI** (optional) — Install from [developer.box.com/guides/cli](https://developer.box.com/guides/cli) for CLI-first verification.\n- **BOX_ACCESS_TOKEN** (optional) — For direct REST verification when Box CLI is unavailable.\n\n## Quick Verification\n\nPreferred order for agent tooling is MCP first, Box CLI second, and direct REST only as a last-resort fallback.\n\n```bash\n# With Box CLI installed and authenticated:\nbox users:get me --json\nbox folders:items 0 --json --max-items 5\n\n# Last-resort fallback (for sessions where MCP/CLI are unavailable):\nexport BOX_ACCESS_TOKEN=\"your-token\"\ncurl -sS -H \"Authorization: Bearer $BOX_ACCESS_TOKEN\" -H \"Accept: application/json\" \"https://api.box.com/2.0/folders/0\"\n```\n\n## Contributing\n\nSkills follow the [Agent Skills specification](https://agentskills.io). The Box skill is a directory with a `SKILL.md` file containing YAML frontmatter and markdown instructions, plus a `references/` directory for feature-specific deep dives.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbox%2Fbox-for-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbox%2Fbox-for-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbox%2Fbox-for-ai/lists"}