该仓库收集了可重复使用的代理技能和工具，展示了代理如何将acp-cli用于现实世界的商业工作流程。

仓库围绕展示项目包和共享技能文件夹组织。展示贡献应归入showcase/ /，包含其showcase.json、证明链接和项目专属技能。跨项目重复使用的共享运行时技能仍归属skills/ /。

第一个技能演示了ACP代理订阅付费Substack的方法：

• ACP代理邮箱，用于注册、收据、一次性地址和账户验证
• ACP代理卡，用于有界一次性结账支付
• acp-cli 用于身份、电子邮件、卡片发行、付款状态、3DS 和收据检查
• 商家结账页面的浏览器自动化

技能

共享技能来源：

• skills/acp-builder-setup - Codex、Claude Code 和 Claude Desktop 的设置和模型路由指导。
• skills/acp-paid-subscription-checkout - 付费结账执行，桌面安全交接，以及经过删减的证据审查。

贡献布局指导：skills/README.md

展示出版

项目提交使用本仓库中的默认PR模板。添加演示

ACP CLI Demos

This repo collects reusable agent skills and utilities that show how agents can use acp-cli for real-world commerce workflows.

The repo is organized around Showcase project packages and shared skill folders. A Showcase contribution should live under showcase// with its showcase.json, proof links, and project-specific skills. Shared runtime skills that are reused across projects still live under skills//.

The first skill demonstrates an ACP agent subscribing to a paid Substack using:

• ACP Agent Email for signup, receipts, OTPs, and account verification
• ACP Agent Card for bounded, single-use checkout payments
• acp-cli for identity, email, card issuance, payment status, 3DS, and receipt checks
• Browser automation for the merchant checkout page

Skills

Shared skill sources:

• skills/acp-builder-setup - setup and model-routing guidance for Codex, Claude Code, and Claude Desktop.
• skills/acp-paid-subscription-checkout - paid checkout execution, desktop-safe handoff, and redacted evidence review.

Contribution layout guidance: skills/README.md

Showcase Publishing

Project submissions use the default PR template in this repo. Add the demo package, proof, reusable skill, and card-ready manifest under showcase/.

After a Showcase PR is approved and merged to main, changes under showcase/** dispatch the EconomyOS docs sync. The docs workflow regenerates the Showcase page data from the accepted manifest.

Automation requirement: configure SHOWCASE_SYNC_TOKEN in this repo with permission to dispatch workflows in the EconomyOS docs repo.

Validate manifests before requesting review:

node scripts/validate-showcase.mjs

Paid Substack Subscription Example

Path: skills/acp-paid-subscription-checkout/examples/substack

This example validates that an ACP agent can complete a paid newsletter checkout end-to-end, then verify the captured charge, receipt, and paid content access.

Utilities

Agent setup guide: docs/agent-setup.md

Model selection and configuration: docs/model-config.md

GitHub skill references: docs/skill-packages.md

Packaged skills: packages/

Utility layout guidance: utilities/README.md

Virtuals Routing Lifecycle (optional)

Routing your agent through Virtuals lets it use free Virtuals credits instead of your own account, and is fully reversible. The simple path is the make lifecycle — run make help for the full list:

Claude Code:  make claude-on  →  ccr code  →  make claude-off
Codex:        make codex-on   →  codex     →  make codex-off