Onboard coding agents to use You.com's web search, research, finance, and content APIs...
Use this skill to set up You.com for the current host, then route the user to local use or to building an integration. Assume nothing is installed and no You.com code exists yet.
Sequence: install for the host -> have the user reload the session -> route by goal. Request approval before installing, connecting, or changing any configuration.
Ask which host the user is in and run the matching command. If the host is not listed, use npx skills add youdotcom-oss/agent-skills.
| Host | Install |
|---|---|
| Any Agent Skills client (default) | npx skills add youdotcom-oss/agent-skills |
| Claude Code | /plugin marketplace add youdotcom-oss/agent-skills then /plugin install you@you-com |
| GitHub Copilot CLI | copilot plugin marketplace add youdotcom-oss/agent-skills then copilot plugin install you@you-com |
| Codex | codex plugin marketplace add youdotcom-oss/agent-skills --sparse .agents/plugins |
| Cursor | Install this repository from the Cursor plugin UI or CLI |
| Kimi Code | /plugins install <repo url> |
| OpenCode | opencode plugin @youdotcom-oss/opencode |
| OpenClaw | openclaw plugins install clawhub:you or openclaw plugins install npm:@youdotcom-oss/openclaw |
| Pi | pi install npm:@youdotcom-oss/pi |
| Hermes | pip install hermes-youdotcom |
Install provides the shared You.com skills (you-web, you-research, you-finance, you-discover) and the remote MCP server configs.
MCP servers and skills load at session start. After install, have the user reload (hot-reload) or restart the session so you-discover, you-docs, and the You.com skills load. Do not continue until the session has reloaded.
Install and reload complete local setup. The user can use You.com now:
https://api.you.com/mcp when the client supports it. OAuth needs no API key; it is the default for local use.you-discover and you-docs immediately when needed; both are keyless.you-web for search, URL reads, and cited synthesis; you-research for multi-source cited research; you-finance for company and market research.IF the user only needs local use -> stop here. IF the user is building an integration (now or later) -> continue to step 4.
you-discover skill. It runs the planning loop that finds the smallest integration path across MCP, SDK, and direct API and verifies auth and setup against the docs. Start discovery immediately; you-discover and you-docs are keyless.YDC_API_KEY, and send Authorization: Bearer ${YDC_API_KEY}. An API key is the default for building.402 payment-required challenge and retries with Authorization: Payment ..., x-payment, or payment-signature. Use x402 for you-search and you-contents; use MPP or x402 for you-research and you-finance.Do not access account balance (you-balance) through keyless payment flows; it is private billing data.
IF the user is an integration partner, or wants an integration that exposes the You.com API to their own users -> have them email madison.lee@you.com.