{
  "markdown": "# Antom AI Tools\n\nA 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.\n\n## Available Skills\n\n| Skill | Description |\n|-------|-------------|\n| **antom-integration** | Integrate Antom payment products including One-time Payments, Tokenized Payment, and Subscription Payment. |\n| **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. |\n\n## Available Plugins\n\nProvider-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.\n\n| Platform | Type | Name | Source |\n|----------|------|------|--------|\n| Agent Plugins 1.0-compatible clients | Portable Plugin | `antom-ai-tools` | [`plugin.json`](plugin.json) · [`mcp.json`](mcp.json) · [`skills/`](skills/) |\n| Gemini CLI | Skills-only Extension | `antom-ai-tools` | [`gemini-extension.json`](gemini-extension.json) · [`skills/`](skills/) |\n| Cursor | Plugin | `antom-integration` | [`providers/cursor/plugin`](providers/cursor/plugin) |\n| Claude Code | Plugin | `antom-integration` | [`providers/claude/plugin`](providers/claude/plugin) |\n| Codex | Plugin | `antom-integration` | [`providers/codex/plugins/antom-integration`](providers/codex/plugins/antom-integration) |\n| OpenClaw | Skill | `antom-reconciliation-expert` | [`skills/antom-reconciliation-expert`](skills/antom-reconciliation-expert) |\n\n## Gemini CLI Extension\n\nThe 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.\n\nInstall it directly from GitHub:\n\n```bash\ngemini extensions install https://github.com/ant-intl/antom-ai-tools\n```\n\nFor local development, validate and link the working copy:\n\n```bash\ngemini extensions validate .\ngemini extensions link .\n```\n\nRestart Gemini CLI after linking, then verify that both Skills are discoverable:\n\n```text\n/extensions list\n/skills list\n```\n\n### P0 Scope\n\n- `antom-integration` provides product selection, integration guidance, code generation, and troubleshooting guidance.\n- `antom-reconciliation-expert` provides reconciliation knowledge and local Settlement Detail report analysis.\n- The `gemini-extension.json` manifest declares neither an MCP server nor an Antom CLI dependency.\n- Online bill retrieval is outside the P0 validation scope and requires its upstream prerequisites to be satisfied separately.\n\n## Portable Agent Plugin\n\nThe repository root follows the [Agent Plugins 1.0 specification](https://agent-plugins.org/):\n\n- [`plugin.json`](plugin.json) identifies the portable plugin.\n- [`skills/`](skills/) remains the source of truth for the bundled Agent Skills.\n- [`mcp.json`](mcp.json) declares the optional Antom MCP server connection.\n\nInstallation, 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.\n\n### Antom MCP Server\n\nThe portable plugin declares the hosted Antom MCP server:\n\n- Endpoint: `https://mcp.antom.com`\n- Transport: Streamable HTTP\n- Configuration: [`mcp.json`](mcp.json)\n- Documentation: [Antom MCP documentation](https://docs.antom.com/ac/ref_zh-cn/mcp)\n\nThe 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.\n\n> **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`.\n\n## antom-integration\n\n### What Problem Does It Solve\n\nAntom 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.\n\nThis 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.\n\n### Install\n\n#### Cursor\n\nSubmit / install via the Cursor marketplace, or for local development:\n\n```bash\ncp -R providers/cursor/plugin ~/.cursor/plugins/local/antom-integration\n# then restart Cursor (>= 2.6)\n```\n\nMarketplace entry: [`.cursor-plugin/marketplace.json`](.cursor-plugin/marketplace.json)\n\n#### Claude Code\n\n```text\n/plugin marketplace add ant-intl/antom-ai-tools\n/plugin install antom-integration@antom\n```\n\nFor local development, point the marketplace at the working copy:\n\n```text\n/plugin marketplace add /absolute/path/to/antom-ai-tools\n```\n\nValidate locally:\n\n```bash\nclaude plugin validate .\n```\n\nMarketplace entry: [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json)\n\n#### Codex\n\nMarketplace entry: [`.codex-plugin/marketplace.json`](.codex-plugin/marketplace.json) (legacy importer reads `.agents/plugins/marketplace.json`).\n\nPlugin manifest: [`providers/codex/plugins/antom-integration/.codex-plugin/plugin.json`](providers/codex/plugins/antom-integration/.codex-plugin/plugin.json)\n\n### Test Assets\n\nWhen 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):\n\n| Source | Use |\n|--------|-----|\n| [`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 |\n| [`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 |\n| [`docs.antom.com/ac/cashierpay/testcases.md`](https://docs.antom.com/ac/cashierpay/testcases.md) | Go-live validation checklist (production test cases) |\n\nIn Claude Code, the plugin also exposes slash commands:\n\n```text\n/test-cards\n/test-wallet\n```\n\n### Example Prompts\n\n```text\nHelp me choose the right Antom payment integration.\n```\n\n```text\nGenerate Antom checkout integration code.\n```\n\n```text\nReview my Antom payment flow for security issues.\n```\n\n### Important Notes\n\n1. 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.\n2. Always review the integration code generated by AI and verify the logic yourself before deployment.\n3. 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.\n\n## antom-reconciliation-expert\n\n### What Problem Does It Solve\n\nAntom 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.\n\nThis 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.\n\n### Install\n\n#### OpenClaw\n\nManually copy the skill into your OpenClaw skills directory:\n\n```bash\ncp -R skills/antom-reconciliation-expert ~/.openclaw/skills/antom-reconciliation-expert\n```\n\nVerify installation:\n\n```bash\nopenclaw skills list\n```\n\n### Example Prompts\n\n```text\nHelp me analyze SETTLEMENT_DETAIL_202604271985548486_20260428.xlsx\n```\n\n```text\nWhat is interchangeFee and how is it calculated?\n```\n\n```text\nValidate the settlement amounts in my report and show me any discrepancies.\n```\n\n### Important Notes\n\n1. 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.\n2. Only `.csv` and `.xlsx` file formats are accepted. Other formats (`.xls`, `.pdf`, `.txt`, etc.) will be rejected.\n3. Fee amounts (such as interchangeFee, schemeFee) are displayed as-is from the report. The Skill does not perform reverse rate calculation on these fees.\n4. 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.\n\n## Repository Layout\n\n```text\ngemini-extension.json                     # Gemini CLI Skills-only extension manifest\nplugin.json                              # Agent Plugins 1.0 manifest\nmcp.json                                 # hosted Antom MCP connection\n.cursor-plugin/marketplace.json\n.claude-plugin/marketplace.json\n.codex-plugin/marketplace.json\n.agents/plugins/marketplace.json\nskills/antom-integration/SKILL.md          # shared source of truth\nskills/antom-reconciliation-expert/        # reconciliation expert skill + scripts\nproviders/\n  cursor/plugin/        # Cursor adapter\n  claude/plugin/        # Claude Code adapter\n  codex/plugins/        # Codex adapter\nLICENSE\n```\n\nEach 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.\n\n## Sync Skills Across Providers\n\nWhen you edit `skills/<name>/...`, mirror the change into every provider package with:\n\n```bash\nnpm run sync-skills\n# or\nnode scripts/sync-skills.mjs\n```\n\nThe script copies every file under `skills/<name>/` into:\n\n- `providers/cursor/plugin/skills/<name>/`\n- `providers/claude/plugin/skills/<name>/`\n- `providers/codex/plugins/<name>/skills/<name>/`\n\nRun it before committing skill changes so all editors stay in lockstep.\n\nOn 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.\n\n## Community & Support\n\n- Follow the [installation and Sandbox tutorials](https://github.com/ant-intl/antom-ai-tools/discussions/categories/tutorials-best-practices).\n- Ask integration questions in [Q&A](https://github.com/ant-intl/antom-ai-tools/discussions/categories/q-a).\n- Suggest new Skills or use cases in [Ideas](https://github.com/ant-intl/antom-ai-tools/discussions/categories/ideas).\n- Share what you built in [Show and tell](https://github.com/ant-intl/antom-ai-tools/discussions/categories/show-and-tell).\n- Browse all [Antom AI Tools Discussions](https://github.com/ant-intl/antom-ai-tools/discussions).\n\nIf Antom AI Tools helps you, consider starring the repository to follow future updates.\n \n\n## Contact\n\nAntom Technical Service — `TechnicalService@antom.com`\n\n## License\n\nMIT — see [`LICENSE`](LICENSE).\n",
  "bytes": 11635,
  "sha": "2b2339d8c9dc83f5aa97b7813d9c3b03fae379a1af78cc5eaa713e7c02bb17c0",
  "repo_slug": "ant-intl/antom-ai-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_ant_intl_antom_ai_tools_067ae744/readme"
}