1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | ima-sdk-basics-google-skills |
| 作者/维护者 | Google LLC（google/skills 官方仓库，数据来自 GitHub API） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/ads/ima-sdk-basics |
| 许可证 | Apache-2.0（数据来自 GitHub API） |
| GitHub Stars | 仓库整体 15,348★（合集仓库整体数字，不代表本技能个体热度，数据来自 GitHub API） |
| Forks | 仓库整体 1,201（数据来自 GitHub API） |
| 最新版本 | SKILL.md metadata 记录 version 1.0.0（数据来自 SKILL.md） |
| 安装方式 | npx skills add google/skills/skills/ads（数据来自官方 README） |
项目自述名称：SKILL.md 中的 name 字段为 ima-sdk-basics；为遵循命名规范（合集仓库子技能需带拥有者与仓库名，避免跨合集重名冲突），正式名称记为 ima-sdk-basics-google-skills。
2. 功能介绍与亮点
- 面向 Web（HTML5/ReactJs/NodeJs/Angular）、Android（含 AndroidTV/ReactNative）、iOS（含 tvOS/ReactNative）三大平台族群，指导 Agent 实现 IMA（Interactive Media Ads）SDK 的 client-side 广告插入，支持 VAST/VMAP 格式的插播视频/音频广告（in-stream）。
- 工作流分六步：SDK 导入 → 初始化配置 → 广告请求 → 加载成功/失败处理 → 播放事件监听 → 资源清理与销毁，并链接六份平台专属参考指南（Android/iOS/tvOS/Web/iframe 模式/Mobile Safari 各一份）。
- 明确排除动态广告插入（DAI/SSAI/SGAI）场景，与仓库内其他广告技能职责边界清晰。
- IMA SDK 本身是 Google 广告技术栈中历史悠久、跨平台覆盖最广的广告 SDK 之一，
developers.google.com为其单独开辟了多平台文档中心（HTML5/Android/iOS 各自的完整 API 参考与架构说明），并配有官方示例代码仓库（googleads/googleads-ima-html5、googleads/googleads-ima-ios等）。 - 所在仓库近乎每日更新，
skills/ads/目录下多个子技能协同维护、职责边界清晰。
3. 适用场景
固定分类：集成与工作流自动化
- 需要在自家 App/网站中插入插播视频广告（pre-roll/mid-roll/post-roll）实现内容变现的开发者，例如视频播放器、直播 App、内容类网站的开发团队。
- 需要跨 Web/Android/iOS/TV 多端统一实现广告插入逻辑、避免分别啃三四份平台官方文档的团队。
- 已完成 AdMob/Ad Manager 基础 SDK 接入、现需要进一步支持视频广告形式的开发者。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方 README 列出
claude plugin marketplace add google/skills安装命令。 - Codex：✅ 原生支持——官方 README 列出
codex plugin marketplace add google/skills安装命令。 - OpenClaw：✅ 支持——通用安装命令使用的 CLI 工具（
npx skills add，对应 npm 包skills，仓库vercel-labs/skills）README 明确列出 OpenClaw 支持，安装路径skills/或~/.openclaw/skills/。 - Hermes Agent：✅ 支持——同一 CLI README 列出 Hermes Agent 支持，安装路径
.hermes/skills/或~/.hermes/skills/。
注：google/skills 官方 README 本身只点名 Claude Code、Codex、Antigravity CLI 三款；OpenClaw 与 Hermes Agent 的支持证据来自其推荐通用安装器 CLI 自身 README 的兼容性列表，而非 google/skills 文档直接点名。
5. 推荐理由
IMA SDK 是 Google 广告技术栈里覆盖平台最广、历史最久的插播视频广告方案之一，但官方接入需要分别啃 Web/Android/iOS/tvOS 等好几份平台专属文档，新手容易在 SDK 初始化时机、资源销毁等细节上出错。这个技能把六步通用工作流与六份平台专属参考指南打包成 Agent 可执行的结构化清单，尤其适合已完成基础广告 SDK 接入、现在要补上视频广告形式的开发者按需查阅、快速接入。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | IMA SDK 是 Google 官方产品，developers.google.com 为其单独开辟 HTML5/Android/iOS 三端完整文档中心与 API 参考，并有独立的官方示例代码仓库（googleads-ima-html5、googleads-ima-ios）及第三方技术博客解读；仓库整体星数不计入本技能个体评分 |
| 可用性 | 8 | 官方给出多条安装命令（npx skills add/Claude Code 与 Codex 插件市场命令），SKILL.md 链接六份平台专属参考指南结构清晰，仓库近乎每日维护，零付费依赖；需额外查阅对应平台指南而非仅通用步骤即可完事，故未到 9 分 |
| 安全性 | 9 | 安装单元仅含 SKILL.md 与六份纯 Markdown 参考指南，无脚本文件；技能本身不执行 shell 命令，仅指导向 VAST 兼容广告服务器发起标准网络请求；不索取 API Key 或凭据；来源为官方仓库，Apache-2.0 完全开源可审计 |
安全检查清单：
① Shell 命令/权限范围：无——安装单元内除 SKILL.md 外仅有六份 Markdown 参考指南，不含任何可执行脚本 ② 联网外发数据：向 VAST 兼容的广告服务器请求广告内容，属行业标准协议、数据流向明确，非隐蔽外发 ③ API Key/凭据：不涉及——技能不代为处理广告位 ID 或账号凭据 ④ 可疑指令：未发现——内容为官方标准 SDK 接入步骤，无混淆代码或隐蔽指令 ⑤ 作者/组织信誉：Google LLC 官方出品，信誉良好 ⑥ License：Apache-2.0，明确
综合评分 = (7+8+9)/3 ≈ 8.0
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| google-mobile-ads-get-started（同仓库同目录技能） | AdMob/Ad Manager 标准广告位（横幅/插页/激励视频）的起步与 SDK 初始化技能 | 覆盖 Banner 等标准展示广告位的 SDK 接入起步流程，不处理 VAST/VMAP 插播视频/音频广告的专属请求与播放生命周期；本技能补齐“插播视频广告”这一独立细分场景 |
| 传统 IMA SDK 官方示例代码仓库（各平台 Sample 工程） | 提供可直接编译运行的完整示例工程，开发者需自行阅读工程结构、比对差异后手动移植到自己项目 | 是静态示例代码，不含 Agent 可执行的结构化步骤清单；本技能以六步工作流 + 平台参考指南驱动 Agent 直接在开发者自己的项目中完成集成，无需先读通一份独立示例工程 |
插播视频广告（in-stream video/audio ads）这一细分场景的替代方案，要么是覆盖更广但不涉及视频插播细节的标准广告位起步技能，要么是需要人工阅读移植的官方示例工程。
8. 用户评价
第三方 Agent Skill 注册平台 hub.decision.ai 已将本技能收录索引，但访问详情页未能取得具体评分数值或具名评论内容。该技能目前尚无可引用的具名第三方用户评价。
9. 其他补充
该技能与同目录下的 google-mobile-ads-get-started（起步）、google-mobile-ads-banner、interstitial、rewarded（标准广告位格式）共同构成完整的 Google 广告 SDK 接入技能簇，可按需选装以覆盖不同广告形式。
10. 安装使用方式
通用多 Agent CLI（推荐，支持 Claude Code / Codex / OpenClaw / Hermes Agent）：
npx skills add google/skills/skills/ads/ima-sdk-basicsClaude Code 专用插件市场：
claude plugin marketplace add google/skills
claude plugin install ima-sdk-basics@google-plugins安装后无需重启；后续更新用 npx skills update --all。当用户描述“帮我在视频播放器里接入插播广告”一类需求时，Agent 会自动匹配触发本技能，随后按提示打开对应平台（Web/Android/iOS/tvOS）的参考指南继续实施。
11. 注意事项
- 本技能仅覆盖 client-side 插播视频/音频广告（VAST/VMAP）的接入，不适用于 Dynamic Ad Insertion（DAI/SSAI/SGAI）场景，后者需要另外的技能或官方 DAI 文档。
- 通用工作流之外仍需查阅对应平台（Web/Android/iOS/tvOS）的专属参考指南才能完成实现细节，不能仅凭六步清单跳过平台文档。
- 使用前需自行在 Ad Manager 或第三方 VAST 兼容广告服务器一方获取广告标签（ad tag），技能本身不代为申请广告位或账号。
- 所在合集仓库（google/skills）规模较大，建议按需选择安装。