antom-ai-tools
Antom payment integration and reconciliation skills for Gemini CLI.
Open source Open in the app JSON README (API)
About
Antom payment integration and reconciliation skills for Gemini CLI.
Details
- Kind
- Plugins
- Topic
- Finance & crypto
- Publisher
- ant-intl
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.1.0
- Stars
- 87
- Forks
- 24
- Last push
- 2026-09-02T12:23:08Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-09-02 19:00:43
- Updated
- 2026-09-02 19:00:43
- Origin id
ant-intl/antom-ai-tools
README
# Antom AI Tools A one-stop repository for building AI-powered products with Antom payment integration. This repository provides shared Agent Skills, provider-specific editor plugins, and an Agent Plugins 1.0-compatible portable package with an optional Antom MCP server connection. ## Available Skills | Skill | Description | |-------|-------------| | **antom-integration** | Integrate Antom payment products including One-time Payments, Tokenized Payment, and Subscription Payment. | | **antom-reconciliation-expert** | Reconciliation Report Analysis Expert — Parses local Settlement Detail report files (CSV/XLSX) for settlement amount validation, fee analysis, and reconciliation knowledge Q&A. | ## Available Plugins Provider-specific packages remain available for supported editors and agent platforms. The repository root is also an Agent Plugins 1.0-compatible portable package, allowing compatible clients to discover the shared Skills and Antom MCP configuration. | Platform | Type | Name | Source | |----------|------|------|--------| | Agent Plugins 1.0-compatible clients | Portable Plugin | `antom-ai-tools` | [`plugin.json`](plugin.json) · [`mcp.json`](mcp.json) · [`skills/`](skills/) | | Gemini CLI | Skills-only Extension | `antom-ai-tools` | [`gemini-extension.json`](gemini-extension.json) · [`skills/`](skills/) | | Cursor | Plugin | `antom-integration` | [`providers/cursor/plugin`](providers/cursor/plugin) | | Claude Code | Plugin | `antom-integration` | [`providers/claude/plugin`](providers/claude/plugin) | | Codex | Plugin | `antom-integration` | [`providers/codex/plugins/antom-integration`](providers/codex/plugins/antom-integration) | | OpenClaw | Skill | `antom-reconciliation-expert` | [`skills/antom-reconciliation-expert`](skills/antom-reconciliation-expert) | ## Gemini CLI Extension The repository root is a Skills-only Gemini CLI extension that bundles both `antom-integration` and `antom-reconciliation-expert` from the shared [`skills/`](skills/) source of truth. Install it directly from GitHub: ```bash gemini extensions install https://github.com/ant-intl/antom-ai-tools ``` For local development, validate and link the working copy: ```bash gemini extensions validate . gemini extensions link . ``` Restart Gemini CLI after linking, then verify that both Skills are discoverable: ```text /extensions list /skills list ``` ### P0 Scope - `antom-integration` provides product selection, integration guidance, code generation, and troubleshooting guidance. - `antom-reconciliation-expert` provides reconciliation knowledge and local Settlement Detail report analysis. - The `gemini-extension.json` manifest declares neither an MCP server nor an Antom CLI dependency. - Online bill retrieval is outside the P0 validation scope and requires its upstream prerequisites to be satisfied separately. ## Portable Agent Plugin The repository root follows the [Agent Plugins 1.0 specification](https://agent-plugins.org/): - [`plugin.json`](plugin.json) identifies the portable plugin. - [`skills/`](skills/) remains the source of truth for the bundled Agent Skills. - [`mcp.json`](mcp.json) declares the optional Antom MCP server connection. Installation, permissions, and authentication are managed by each compatible client. Follow the instructions provided by your client to load this repository root as an Agent Plugin. ### Antom MCP Server The portable plugin declares the hosted Antom MCP server: - Endpoint: `https://mcp.antom.com` - Transport: Streamable HTTP - Configuration: [`mcp.json`](mcp.json) - Documentation: [Antom MCP documentation](https://docs.antom.com/ac/ref_zh-cn/mcp) The MCP server complements the existing Skills and does not replace them. If the MCP connection is unavailable, compatible clients can continue loading the bundled Skills. > **Access:** The Antom MCP server is currently available through a controlled allowlist rollout. See the [Antom MCP documentation](https://docs.antom.com/ac/ref_zh-cn/mcp) for access application instructions. After approval, authentication is handled through the client-managed OAuth flow; do not add credentials to `mcp.json`. ## antom-integration ### What Problem Does It Solve Antom encapsulates core payment capabilities into standardized Skill components that are fully readable by AI. Developers can quickly integrate payments in Vibe Coding mode without dealing with complex underlying logic — simply describe your needs in natural language. This Skill helps AI quickly load the Antom knowledge base, answer Antom integration questions, and generate integration code, significantly reducing the learning curve and development effort for payment integration. ### Install #### Cursor Submit / install via the Cursor marketplace, or for local development: ```bash cp -R providers/cursor/plugin ~/.cursor/plugins/local/antom-integration # then restart Cursor (>= 2.6) ``` Marketplace entry: [`.cursor-plugin/marketplace.json`](.cursor-plugin/marketplace.json) #### Claude Code ```text /plugin marketplace add ant-intl/antom-ai-tools /plugin install antom-integration@antom ``` For local development, point the marketplace at the working copy: ```text /plugin marketplace add /absolute/path/to/antom-ai-tools ``` Validate locally: ```bash claude plugin validate . ``` Marketplace entry: [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) #### Codex Marketplace entry: [`.codex-plugin/marketplace.json`](.codex-plugin/marketplace.json) (legacy importer reads `.agents/plugins/marketplace.json`). Plugin manifest: [`providers/codex/plugins/antom-integration/.codex-plugin/plugin.json`](providers/codex/plugins/antom-integration/.codex-plugin/plugin.json) ### Test Assets When you ask AI for a test card or to test a payment, it pulls the latest sandbox test data straight from the official Antom docs (never hardcoded): | Source | Use | |--------|-----| | [`docs.antom.com/ac/ref/card.md`](https://docs.antom.com/ac/ref/card.md) | Sandbox test cards (fetched live): success / failure / 3DS / risk-control / invalid-input scenarios | | [`docs.antom.com/ac/ref/wallet.md`](https://docs.antom.com/ac/ref/wallet.md) · [`testwallet.md`](https://docs.antom.com/ac/ref/testwallet.md) | How to test wallet / BNPL / online-banking (APM) payments: test wallet app + QR / login flow | | [`docs.antom.com/ac/cashierpay/testcases.md`](https://docs.antom.com/ac/cashierpay/testcases.md) | Go-live validation checklist (production test cases) | In Claude Code, the plugin also exposes slash commands: ```text /test-cards /test-wallet ``` ### Example Prompts ```text Help me choose the right Antom payment integration. ``` ```text Generate Antom checkout integration code. ``` ```text Review my Antom payment flow for security issues. ``` ### Important Notes 1. When describing your requirements to AI, be specific about the payment scenario (e.g., One-time Payment, Redirect to CKP Payment) to avoid ambiguity and potential misinterpretation. 2. Always review the integration code generated by AI and verify the logic yourself before deployment. 3. The Skill is updated in sync with Antom product iterations. It is recommended to periodically re-run the installation command to get the latest version. ## antom-reconciliation-expert ### What Problem Does It Solve Antom delivers Settlement Detail reports to merchants, but verifying settlement amounts, understanding fee breakdowns, and attributing discrepancies manually is tedious and error-prone — especially when dealing with hundreds of rows across multiple fee types and currencies. This Skill turns AI into a reconciliation expert. Simply provide your local Settlement Detail report file or ask a question in natural language, and AI will parse the data, validate every settlement formula, break down all fee components, and explain reconciliation rules — significantly reducing the time and effort needed for settlement verification. ### Install #### OpenClaw Manually copy the skill into your OpenClaw skills directory: ```bash cp -R skills/antom-reconciliation-expert ~/.openclaw/skills/antom-reconciliation-expert ``` Verify installation: ```bash openclaw skills list ``` ### Example Prompts ```text Help me analyze SETTLEMENT_DETAIL_202604271985548486_20260428.xlsx ``` ```text What is interchangeFee and how is it calculated? ``` ```text Validate the settlement amounts in my report and show me any discrepancies. ``` ### Important Notes 1. When providing a report file, make sure it is a **Settlement Detail** report (filename must contain both `SETTLEMENT` and `DETAIL`). Transaction Detail and Settlement Summary reports are not supported. 2. Only `.csv` and `.xlsx` file formats are accepted. Other formats (`.xls`, `.pdf`, `.txt`, etc.) will be rejected. 3. Fee amounts (such as interchangeFee, schemeFee) are displayed as-is from the report. The Skill does not perform reverse rate calculation on these fees. 4. The Skill is updated in sync with Antom product iterations. It is recommended to periodically re-run the installation command to get the latest version. ## Repository Layout ```text gemini-extension.json # Gemini CLI Skills-only extension manifest plugin.json # Agent Plugins 1.0 manifest mcp.json # hosted Antom MCP connection .cursor-plugin/marketplace.json .claude-plugin/marketplace.json .codex-plugin/marketplace.json .agents/plugins/marketplace.json skills/antom-integration/SKILL.md # shared source of truth skills/antom-reconciliation-expert/ # reconciliation expert skill + scripts providers/ cursor/plugin/ # Cursor adapter claude/plugin/ # Claude Code adapter codex/plugins/ # Codex adapter LICENSE ``` Each provider package is self-contained and ships its own copy of the skill so editors can load it independently. The single source of truth is `skills/`; provider copies are mirrored from it via the sync script below. ## Sync Skills Across Providers When you edit `skills/<name>/...`, mirror the change into every provider package with: ```bash npm run sync-skills # or node scripts/sync-skills.mjs ``` The script copies every file under `skills/<name>/` into: - `providers/cursor/plugin/skills/<name>/` - `providers/claude/plugin/skills/<name>/` - `providers/codex/plugins/<name>/skills/<name>/` Run it before committing skill changes so all editors stay in lockstep. On GitHub, the [`sync-skills` workflow](.github/workflows/sync-skills.yml) watches `skills/**` and `scripts/sync-skills.mjs`. When `main` receives changes there, it runs `npm run sync-skills` and opens a `chore/sync-skills` PR with the mirrored provider copies — so you only need to edit the source-of-truth and merge the auto-generated PR. ## Community & Support - Follow the [installation and Sandbox tutorials](https://github.com/ant-intl/antom-ai-tools/discussions/categories/tutorials-best-practices). - Ask integration questions in [Q&A](https://github.com/ant-intl/antom-ai-tools/discussions/categories/q-a). - Suggest new Skills or use cases in [Ideas](https://github.com/ant-intl/antom-ai-tools/discussions/categories/ideas). - Share what you built in [Show and tell](https://github.com/ant-intl/antom-ai-tools/discussions/categories/show-and-tell). - Browse all [Antom AI Tools Discussions](https://github.com/ant-intl/antom-ai-tools/discussions). If Antom AI Tools helps you, consider starring the repository to follow future updates. ## Contact Antom Technical Service — `TechnicalService@antom.com` ## License MIT — see [`LICENSE`](LICENSE).