{
  "markdown": "# BidMachine Plus SDK Agents\n\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)\n[![SDK](https://img.shields.io/badge/BidMachine%20Plus-0.1.0-brightgreen.svg)](#sdk-versions--coordinates)\n[![Platforms](https://img.shields.io/badge/platforms-Android%20%7C%20iOS%20%7C%20Unity-lightgrey.svg)](#whats-inside)\n[![Runtimes](https://img.shields.io/badge/runtimes-Claude%20Code%20%7C%20Codex%20%7C%20Gemini-8A2BE2.svg)](#installation)\n\nA cross-agent toolkit for integrating the **BidMachine Plus** SDK, built to run on three\nAI coding runtimes — **Claude Code**, **Codex**, and **Gemini**. It ships two layers:\n\n- **Skills** — portable, runtime-agnostic integration knowledge (one identical `SKILL.md`\n  per platform), with on-demand references and an executable verifier.\n- **Role subagents** — authored once per role and rendered into each runtime's native format by\n  the installer. Each platform ships a single read-only guide that diagnoses integration problems and\n  never edits code: `bidmachine-android-guide` and `bidmachine-ios-guide` work from the official docs\n  and the project's local API references, and `bidmachine-unity-guide` works from the installed\n  `com.bidmachine.plus` plugin source.\n\n```\nskills/                         # portable knowledge (copied verbatim into each runtime)\n  bidmachine-android/\n    SKILL.md                    # main path: install, init, load ads, routing\n    references/                 # loaded on demand: ad-units, privacy, revenue, error-codes\n    scripts/verify_integration.py   # read-only project checker (PASS/WARN/FAIL)\n  bidmachine-ios/  …            # same shape, Swift / Obj-C\n  bidmachine-unity/  …          # same shape, C#\n\nagents/<platform>/<role>/       # single-source role definition\n  meta.yaml                     # flat metadata (name, description, tools, uses_skill, model_claude)\n  agent.md                      # the system prompt / instructions\n\nscripts/\n  install.sh                    # renders + installs skills and agents into each runtime\n  _render_agent.py              # meta.yaml + agent.md -> Claude/Gemini .md or Codex .toml\n```\n\n## What's Inside\n\n### Skills\n\nOne runtime-agnostic skill per platform — install, init, load ads, privacy, mediation:\n\n- **bidmachine-android** — BidMachine Plus on Android (Kotlin/Java/Gradle, `io.bidmachine.plus`).\n- **bidmachine-ios** — BidMachine Plus on iOS (Swift/Obj-C, CocoaPods/SPM).\n- **bidmachine-unity** — BidMachine Plus **First Look** on Unity (C#, UPM + EDM4U): BidMachine queried\n  first on a timeout, fall-through to the project's existing mediation (MAX / AdMob / LevelPlay / other).\n\n### Agents\n\nOne read-only guide per platform — **bidmachine-android-guide**, **bidmachine-ios-guide**, **bidmachine-unity-guide** — to diagnose integration problems when the skill's happy path fails. None of them edit code.\n\n## SDK versions & coordinates\n\nAll three platforms are on **`0.1.0`**. Each skill states the version directly; the coordinate\nlocation differs per ecosystem:\n\n- **Android** — the skill declares `io.bidmachine.plus:sdk:0.1.0` from the public `bidmachine` Maven\n  repo.\n- **iOS** — the install snippets declare `BidMachinePlus` `0.1.0` (CocoaPods) / `BidMachinePlus-SPM`\n  tag `0.1.0` (SPM); full coordinates (sources, package URLs) live in\n  [`skills/bidmachine-ios/references/distribution.md`](skills/bidmachine-ios/references/distribution.md).\n- **Unity** — the skill declares `com.bidmachine.plus` `0.1.0` from the BidMachine scoped registry\n  (`https://npm.bidmachine.com`, scope `com.bidmachine`); External Dependency Manager resolves from\n  OpenUPM (`https://package.openupm.com`) as a dependency. The native `io.bidmachine.plus` Maven SDK\n  and the iOS pod are resolved by EDM and are build-environment, not taught.\n\n## Requirements\n\n- **Tooling** — `bash` + `python3` (stdlib only, zero dependencies). One of the supported\n  runtimes: Claude Code, Codex, or Gemini CLI.\n- **Android** — `minSdk 24` (Android 7.0); the SDK is published with `minSdkVersion 24`.\n- **iOS** — iOS 13.0+, Xcode 16.4+ (last-known minimums; confirm against the current SDK docs).\n- **Unity** — Unity 2021.3+ (the plugin's minimum), with EDM4U resolving the native dependencies.\n\n## Installation\n\nEach coding agent installs separately — set it up for every harness you use.\n\n### Claude Code\n\n- Register the marketplace:\n\n  ```bash\n  /plugin marketplace add bidmachine/bidmachine-sdk-agents\n  ```\n\n- Install the plugin:\n\n  ```bash\n  /plugin install bidmachine-sdk-agents@bidmachine\n  ```\n\n### Gemini CLI\n\n- Install the extension:\n\n  ```bash\n  gemini extensions install https://github.com/bidmachine/bidmachine-sdk-agents\n  ```\n\n- Update later:\n\n  ```bash\n  gemini extensions update bidmachine-sdk-agents\n  ```\n\n### npx (Agent Skills CLI)\n\n- Add the skills to any supported agent:\n\n  ```bash\n  npx skills add bidmachine/bidmachine-sdk-agents\n  ```\n\n### All runtimes (script)\n\n```bash\n# everything, into your user config (Claude + Codex + Gemini)\nscripts/install.sh\n\n# scope / filters\nscripts/install.sh --local                       # into ./.claude, ./.agents, ./.gemini\nscripts/install.sh --runtime=claude              # one runtime\nscripts/install.sh --platform=ios,unity          # subset of platforms\nscripts/install.sh --agent=bidmachine-ios-guide    # a single agent\nscripts/install.sh --dry-run                     # show actions, write nothing\n```\n\nTargets (global scope):\n\n| Runtime | Skills                          | Agents                   |\n|---------|---------------------------------|--------------------------|\n| Claude  | `~/.claude/skills/`             | `~/.claude/agents/*.md`  |\n| Codex   | `~/.agents/skills/`             | `~/.codex/agents/*.toml` |\n| Gemini  | `~/.gemini/antigravity/skills/` | `~/.gemini/agents/*.md`  |\n\nNo dependencies beyond `bash` + `python3` (stdlib only). Skills are copied verbatim;\nagents are rendered from the single-source `meta.yaml` + `agent.md`.\n\n## Verify an integration\n\nEach skill bundles a read-only checker — no SDK, no build, pure stdlib:\n\n```bash\npython3 skills/bidmachine-android/scripts/verify_integration.py /path/to/project\n```\n\nIt scans for the dependency, init call + chosen mode, required config, and leftover\ntest-mode / placeholder keys, printing `PASS` / `WARN` / `FAIL` per check (exit 1 on any\nfail). iOS and Unity ship the equivalent.\n\n## Validate the skills\n\nThe skills pass the validators from the official Claude Code `skill-creator` plugin\n(install it from the `claude-plugins-official` marketplace, then point `SC` at its path):\n\n```bash\nSC=~/.claude/plugins/marketplaces/claude-plugins-official/plugins/skill-creator/skills/skill-creator\npython3 \"$SC/scripts/quick_validate.py\" skills/bidmachine-android   # -> Skill is valid!\n```\n\n## License\n\n[Apache License 2.0](LICENSE).\n",
  "bytes": 6799,
  "sha": "678b72cff9a5838f753cd45a6e5325fb78f679fdb9342dfce6577fc9db399468",
  "repo_slug": "bidmachine/bidmachine-sdk-agents",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_bidmachine_bidmachine_sdk_agents_90fe40e9/readme"
}