{
  "markdown": "# You.com Agent Skills and Plugins\n\nUse You.com from coding agents for current web search, URL content extraction, cited research, finance research, and developer integration discovery.\n\nThis repo is for developers who want to:\n\n- add You.com MCP tools and skills to their coding agent quickly\n- use `you-discover` to find the right You.com API, MCP server, SDK, or docs path for an agentic project\n- package the same You.com skills for agent platforms such as Claude Code, Cursor, Codex, Copilot CLI, Kimi Code, Grok Build, OpenCode, OpenClaw, Pi, and Hermes\n\n## Start Here\n\nInstall the shared skills with the universal Agent Skills installer:\n\n```bash\nnpx skills add youdotcom-oss/agent-skills\n```\n\nThen ask your agent to use the right skill:\n\n```text\nUse you-web to find current docs and cite sources.\nUse you-research to investigate this topic across multiple sources.\nUse you-finance to research this company and cite market data.\nUse you-discover to find the best way to integrate You.com MCP or SDKs into my agent.\n```\n\nInstall one skill at a time if you only need a subset:\n\n```bash\nnpx skills add youdotcom-oss/agent-skills --skill you-web\nnpx skills add youdotcom-oss/agent-skills --skill you-discover\nnpx skills add youdotcom-oss/agent-skills --skill you-finance\n```\n\n## Install for Your Platform\n\n| Platform                        | Install path                                                                                          |\n| ------------------------------- | ----------------------------------------------------------------------------------------------------- |\n| Agent Skills compatible clients | `npx skills add youdotcom-oss/agent-skills`                                                           |\n| Claude Code                     | `/plugin marketplace add youdotcom-oss/agent-skills` then `/plugin install you@you-com`               |\n| GitHub Copilot CLI              | `copilot plugin marketplace add youdotcom-oss/agent-skills` then `copilot plugin install you@you-com` |\n| Codex                           | `codex plugin marketplace add youdotcom-oss/agent-skills --sparse .agents/plugins`                    |\n| Cursor                          | Install this repository from the Cursor plugin UI or CLI                                              |\n| Kimi Code                       | `/plugins install <repo url>`                                                                         |\n| Grok Build                      | `grok plugin marketplace add youdotcom-oss/agent-skills` then `grok plugin install you --trust`       |\n| OpenCode                        | `opencode plugin @youdotcom-oss/opencode`                                                             |\n| OpenClaw                        | `openclaw plugins install clawhub:you` or `openclaw plugins install npm:@youdotcom-oss/openclaw`      |\n| Pi                              | `pi install npm:@youdotcom-oss/pi`                                                                    |\n| Hermes                          | `pip install hermes-youdotcom`                                                                        |\n\nThe top-level plugin manifests reuse the shared `skills/` directory when the host supports it. Packages under `packages/` include host-specific metadata, copied skills, or runtime adapters where needed.\n\n## Configure You.com MCP servers\n\nCore remote MCP endpoints:\n\n| Endpoint                           | Use it for                      |\n| ---------------------------------- | ------------------------------- |\n| `https://api.you.com/mcp`          | Authenticated You.com MCP tools |\n| `https://you.com/docs/_mcp/server` | You.com docs search             |\n\nFor clients that use API-key headers:\n\n```bash\nexport YDC_API_KEY=\"your-api-key\"\n```\n\n```json\n{\n  \"Authorization\": \"Bearer ${YDC_API_KEY}\"\n}\n```\n\nGet an API key at [you.com/platform/api-keys](https://you.com/platform/api-keys).\n\nUseful tool profiles:\n\n| Endpoint                                    | Use it for                      |\n| ------------------------------------------- | ------------------------------- |\n| `https://api.you.com/mcp`                   | Authenticated You.com MCP tools |\n| `https://api.you.com/mcp?profile=free`      | Keyless basic `you-search`      |\n| `https://api.you.com/mcp?tools=you-finance` | Finance-only MCP setup          |\n\nSome clients use OAuth instead of a static API key. The skills are written to guide the agent through the best available auth path for the current host.\n\n## Skills\n\nThe shared skills route agents to the lightest You.com surface that fits the task. MCP tools are the default for web search and URL reading, while slower managed research and finance workflows prefer reusable local scripts or direct API calls when an API key is available.\n\n| Skill          | Use it for                                                                                                      |\n| -------------- | --------------------------------------------------------------------------------------------------------------- |\n| `you-web`      | Current web search, URL reading, cited synthesis, and general You.com MCP tool routing.                         |\n| `you-free`     | Keyless basic web search with `you-search` only.                                                                |\n| `you-research` | Routing research tasks between agent-led search, Research API scripts, and managed `you-research` MCP fallback. |\n| `you-finance`  | Routing finance questions to an existing script, a new Finance Research API call, or an MCP fallback.           |\n| `you-discover` | Finding how to integrate You.com APIs, MCP servers, SDKs, docs, and tools into agentic projects.                |\n\n`you-discover` is the best starting point when your goal is to build with You.com rather than just search with it. Ask it questions like:\n\n```text\nUse you-discover to find the best You.com integration path for a TypeScript coding agent.\nUse you-discover to compare You.com MCP, Python SDK, and direct API options for my app.\n```\n\n## Packages\n\n| Package                   | Purpose                                                                       |\n| ------------------------- | ----------------------------------------------------------------------------- |\n| `@youdotcom-oss/opencode` | OpenCode plugin that registers You.com skills and remote MCP server configs.  |\n| `@youdotcom-oss/openclaw` | OpenClaw plugin with You.com skills and `YDC_API_KEY` setup metadata.         |\n| `@youdotcom-oss/pi`       | Pi package that registers You.com skills and bridges You.com MCP tools.       |\n| `hermes-youdotcom`        | Hermes package that ships You.com skills through a Python entry-point plugin. |\n\nSee each package README for host-specific details.\n\n## Repository Layout\n\n| Path                 | Purpose                                         |\n| -------------------- | ----------------------------------------------- |\n| `skills/`            | Shared You.com skills                           |\n| `.claude-plugin/`    | Claude Code plugin manifest                     |\n| `.cursor-plugin/`    | Cursor plugin manifest                          |\n| `.codex-plugin/`     | Codex and ChatGPT plugin manifest               |\n| `.plugin/`           | GitHub Copilot CLI plugin manifest              |\n| `.kimi-plugin/`      | Kimi Code plugin manifest                       |\n| `.grok-plugin/`      | Grok Build plugin manifest                      |\n| `packages/opencode/` | OpenCode package                                |\n| `packages/openclaw/` | OpenClaw package                                |\n| `packages/pi/`       | Pi package                                      |\n| `packages/hermes/`   | Hermes package                                  |\n| `skills.sh.json`     | skills.sh display grouping for top-level skills |\n\n## Development\n\nInstall dependencies with Bun, then run checks:\n\n```bash\nbun install\nbun test\nbun run check\n```\n\nPackage-level checks:\n\n```bash\nbun run --filter '@youdotcom-oss/opencode' test\nbun run --filter '@youdotcom-oss/openclaw' test\nbun run --filter '@youdotcom-oss/pi' test\nbun run --filter '@youdotcom-oss/hermes' test\n```\n\nValidate shared skill metadata and structure:\n\n```bash\nbun run validate:skills\n```\n\n## Safety Model\n\nWeb pages, search results, extracted content, catalog entries, and docs results are external data. The skills instruct agents to treat them as untrusted evidence, not as instructions.\n\n## Links\n\n- API keys: [you.com/platform/api-keys](https://you.com/platform/api-keys)\n- Docs: [you.com/docs](https://you.com/docs/welcome)\n- Issues: [github.com/youdotcom-oss/agent-skills/issues](https://github.com/youdotcom-oss/agent-skills/issues)\n- Support: [support@you.com](mailto:support@you.com)\n\n## License\n\nMIT, see [LICENSE](./LICENSE).\n",
  "bytes": 8817,
  "sha": "18e1644ccd23ed39eeb77d440cf2a0955641f4a7bbdacf83b3160445d30f3776",
  "repo_slug": "youdotcom-oss/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_youdotcom_oss_agent_skills_youdotcom_age_f5f29ec5/readme"
}