# 安装 iMario Agent Skill

> 连接 MCP 之后，给外部智能体装上配套的调研指引。

Source: https://imario.ai/zh/docs/agent-setup/install-skill

## 要安装的是什么
`imario` 技能教外部智能体做这几件事：选人群；给调研估价，花积分之前先征得你同意；运行调研；再用具体人数和原话，汇报受访者说了什么。它还会告诉智能体哪些事不该接手：案头研究、市场规模测算，还有分析你手头已有的数据。这个技能要和 iMario MCP 连接配合使用。

技能发布在 [github.com/laugherxiao/imario-skills](https://github.com/laugherxiao/imario-skills)，采用开放的 Agent Skills 格式：`SKILL.md` 里是工作流程和始终适用的规则，`references/` 里是细节内容，智能体只在任务需要时才去读。

先[连接 MCP](https://imario.ai/zh/docs/agent-setup/mcp)，确认它能列出你的人群。

## 让智能体自动安装（Claude Code、Codex、Cursor）
在 Claude Code、Codex 或 Cursor 里粘贴 `Connect iMario to this agent: imario.ai/SKILL.md`。这在 ChatGPT 和 claude.ai 里行不通，它们只读页面，不照着执行。在这两个应用里要[添加连接器](https://imario.ai/zh/docs/agent-setup/mcp#1a-approve-a-connection-chatgpt-claude-claude-code-codex-vs-code)，claude.ai 还要按下文的方法上传技能。这个地址上的页面是一份接入说明：智能体会照着注册服务器，用 `npx skills add laugherxiao/imario-skills` 安装这个技能，然后请你授权连接。下面是手动安装的几种方法。

## 在 Claude Code 里安装```
/plugin marketplace add laugherxiao/imario-skills
/plugin install imario@imario
```

插件还会顺带注册服务器地址。如果还没授权连接，运行 `/mcp`，选中 `imario`，再选择 **Authenticate** 完成授权。

不想用插件市场的话，可以把仓库里的 `skills/imario` 文件夹复制到 `~/.claude/skills/`。复制后的路径必须是 `~/.claude/skills/imario/SKILL.md`。

## 在 Codex 里安装
把仓库里的 `skills/imario` 文件夹复制到 `~/.agents/skills/`，然后重启 Codex。Codex 从技能的 `agents/openai.yaml` 读取显示名称、图标和对 iMario 服务器的依赖。可以用 `$imario` 显式调用，也可以让 Codex 根据请求自己选用。

## 在 Claude 里安装（claude.ai 和桌面应用）
1. 下载仓库，把 `skills/imario` 文件夹打包成 zip。
2. 打开 **Customize > Skills**，点击 **+**，再选 **Create skill > Upload a skill**，选中这个 zip 文件。

必须先开启代码执行：Free、Pro 和 Max 套餐在 **Settings > Capabilities** 里开启，Team 和 Enterprise 套餐在 **Organization settings > Skills** 里开启。

## 在 Claude API 或 Agent SDK 里使用
技能不会在不同平台之间同步。把 `skills/imario` 打包成 zip，用 Skills API 上传，然后在请求的 container 里引用它的 `skill_id`，同时带上代码执行工具。具体做法见 Anthropic 的官方指南[通过 API 使用 Agent Skills](https://platform.claude.com/docs/en/build-with-claude/skills-guide)。

## 其他智能体
把 `skills/imario` 文件夹放到智能体读取 Agent Skills 的位置就行。

## 分别验证技能和连接
可以这样问：“用 iMario 技能列出人群，再说明你会怎么预估一道开放题。不要提交调研。”

检查要看三点：客户端认出了这个技能，MCP 返回了真实的人群列表，智能体在花积分之前先讲清了预估。回答写得再流畅，也证明不了真的调用了工具。

之后你授权运行调研时，智能体应该沿用你选定的人群，按实际范围做预估，标出不完整的结果，最后给出这次调研的 `web_url`。技能不会突破工作区的每日上限，也不会放宽任何人的权限。

## 更新或移除
在 Claude Code 里，`/plugin marketplace update imario` 拉取最新版本，`/plugin uninstall imario@imario` 卸载技能。如果是复制文件夹装的，替换文件夹就是更新，删掉文件夹就是移除。在 Claude 里，到 **Customize > Skills** 关闭或删除这个技能。

移除技能后，MCP 连接还在。要让智能体再也访问不了工作区，就在 **Settings > MCP & API** 里断开这个应用的连接，或者重新生成 API 密钥。

## 隐私与支持
技能本身不存储任何内容。它发起的调研保存在你的工作区里，受 iMario 的[隐私政策](https://imario.ai/privacy)和[服务条款](https://imario.ai/terms)约束。有问题可以发邮件到 [support@imario.ai](mailto:support@imario.ai)。