bidmachine-sdk-agents
BidMachine Plus SDK integration skills for Android, iOS, and Unity.
Open source Open in the app JSON README (API)
About
BidMachine Plus SDK integration skills for Android, iOS, and Unity.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- bidmachine
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.1.0
- Last push
- 2026-07-16T14:35:16Z
- Repository state
- ativo
- Language
- Python
- License
- Apache-2.0
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
bidmachine/bidmachine-sdk-agents
README
# BidMachine Plus SDK Agents
[](LICENSE)
[](#sdk-versions--coordinates)
[](#whats-inside)
[](#installation)
A cross-agent toolkit for integrating the **BidMachine Plus** SDK, built to run on three
AI coding runtimes — **Claude Code**, **Codex**, and **Gemini**. It ships two layers:
- **Skills** — portable, runtime-agnostic integration knowledge (one identical `SKILL.md`
per platform), with on-demand references and an executable verifier.
- **Role subagents** — authored once per role and rendered into each runtime's native format by
the installer. Each platform ships a single read-only guide that diagnoses integration problems and
never edits code: `bidmachine-android-guide` and `bidmachine-ios-guide` work from the official docs
and the project's local API references, and `bidmachine-unity-guide` works from the installed
`com.bidmachine.plus` plugin source.
```
skills/ # portable knowledge (copied verbatim into each runtime)
bidmachine-android/
SKILL.md # main path: install, init, load ads, routing
references/ # loaded on demand: ad-units, privacy, revenue, error-codes
scripts/verify_integration.py # read-only project checker (PASS/WARN/FAIL)
bidmachine-ios/ … # same shape, Swift / Obj-C
bidmachine-unity/ … # same shape, C#
agents/<platform>/<role>/ # single-source role definition
meta.yaml # flat metadata (name, description, tools, uses_skill, model_claude)
agent.md # the system prompt / instructions
scripts/
install.sh # renders + installs skills and agents into each runtime
_render_agent.py # meta.yaml + agent.md -> Claude/Gemini .md or Codex .toml
```
## What's Inside
### Skills
One runtime-agnostic skill per platform — install, init, load ads, privacy, mediation:
- **bidmachine-android** — BidMachine Plus on Android (Kotlin/Java/Gradle, `io.bidmachine.plus`).
- **bidmachine-ios** — BidMachine Plus on iOS (Swift/Obj-C, CocoaPods/SPM).
- **bidmachine-unity** — BidMachine Plus **First Look** on Unity (C#, UPM + EDM4U): BidMachine queried
first on a timeout, fall-through to the project's existing mediation (MAX / AdMob / LevelPlay / other).
### Agents
One 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.
## SDK versions & coordinates
All three platforms are on **`0.1.0`**. Each skill states the version directly; the coordinate
location differs per ecosystem:
- **Android** — the skill declares `io.bidmachine.plus:sdk:0.1.0` from the public `bidmachine` Maven
repo.
- **iOS** — the install snippets declare `BidMachinePlus` `0.1.0` (CocoaPods) / `BidMachinePlus-SPM`
tag `0.1.0` (SPM); full coordinates (sources, package URLs) live in
[`skills/bidmachine-ios/references/distribution.md`](skills/bidmachine-ios/references/distribution.md).
- **Unity** — the skill declares `com.bidmachine.plus` `0.1.0` from the BidMachine scoped registry
(`https://npm.bidmachine.com`, scope `com.bidmachine`); External Dependency Manager resolves from
OpenUPM (`https://package.openupm.com`) as a dependency. The native `io.bidmachine.plus` Maven SDK
and the iOS pod are resolved by EDM and are build-environment, not taught.
## Requirements
- **Tooling** — `bash` + `python3` (stdlib only, zero dependencies). One of the supported
runtimes: Claude Code, Codex, or Gemini CLI.
- **Android** — `minSdk 24` (Android 7.0); the SDK is published with `minSdkVersion 24`.
- **iOS** — iOS 13.0+, Xcode 16.4+ (last-known minimums; confirm against the current SDK docs).
- **Unity** — Unity 2021.3+ (the plugin's minimum), with EDM4U resolving the native dependencies.
## Installation
Each coding agent installs separately — set it up for every harness you use.
### Claude Code
- Register the marketplace:
```bash
/plugin marketplace add bidmachine/bidmachine-sdk-agents
```
- Install the plugin:
```bash
/plugin install bidmachine-sdk-agents@bidmachine
```
### Gemini CLI
- Install the extension:
```bash
gemini extensions install https://github.com/bidmachine/bidmachine-sdk-agents
```
- Update later:
```bash
gemini extensions update bidmachine-sdk-agents
```
### npx (Agent Skills CLI)
- Add the skills to any supported agent:
```bash
npx skills add bidmachine/bidmachine-sdk-agents
```
### All runtimes (script)
```bash
# everything, into your user config (Claude + Codex + Gemini)
scripts/install.sh
# scope / filters
scripts/install.sh --local # into ./.claude, ./.agents, ./.gemini
scripts/install.sh --runtime=claude # one runtime
scripts/install.sh --platform=ios,unity # subset of platforms
scripts/install.sh --agent=bidmachine-ios-guide # a single agent
scripts/install.sh --dry-run # show actions, write nothing
```
Targets (global scope):
| Runtime | Skills | Agents |
|---------|---------------------------------|--------------------------|
| Claude | `~/.claude/skills/` | `~/.claude/agents/*.md` |
| Codex | `~/.agents/skills/` | `~/.codex/agents/*.toml` |
| Gemini | `~/.gemini/antigravity/skills/` | `~/.gemini/agents/*.md` |
No dependencies beyond `bash` + `python3` (stdlib only). Skills are copied verbatim;
agents are rendered from the single-source `meta.yaml` + `agent.md`.
## Verify an integration
Each skill bundles a read-only checker — no SDK, no build, pure stdlib:
```bash
python3 skills/bidmachine-android/scripts/verify_integration.py /path/to/project
```
It scans for the dependency, init call + chosen mode, required config, and leftover
test-mode / placeholder keys, printing `PASS` / `WARN` / `FAIL` per check (exit 1 on any
fail). iOS and Unity ship the equivalent.
## Validate the skills
The skills pass the validators from the official Claude Code `skill-creator` plugin
(install it from the `claude-plugins-official` marketplace, then point `SC` at its path):
```bash
SC=~/.claude/plugins/marketplaces/claude-plugins-official/plugins/skill-creator/skills/skill-creator
python3 "$SC/scripts/quick_validate.py" skills/bidmachine-android # -> Skill is valid!
```
## License
[Apache License 2.0](LICENSE).