acp-setup
/acp-setup
Scaffold an ACP merchant server project — install dependencies, import OpenAPI specs and JSON schemas, configure environment, and create initial endpoint stubs. Use when starting a new ACP implementation from scratch.
- Author
- OrcaQubits ↗
- Repository
- agentic-commerce-skills-plugins ↗
- Licence
- MIT
- Last repository change
- 14.09.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 14.09.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Scaffold an ACP merchant server project — install dependencies, import OpenAPI specs and JSON schemas, configure environment, and create initial endpoint stubs. Use when starting a new ACP implementation from scratch.
Original author description
Scaffold an ACP merchant server project — install dependencies, import OpenAPI specs and JSON schemas, configure environment, and create initial endpoint stubs. Use when starting a new ACP implementation from scratch.
How it works
- Before writing code
- What This Skill Does
- Configuration Essentials
- Project Structure Pattern
SKILL.md preview
--- name: acp-setup description: Scaffold an ACP merchant server project — install dependencies, import OpenAPI specs and JSON schemas, configure environment, and create initial endpoint stubs. Use when starting a new ACP implementation from scratch. allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch --- # ACP Project Setup ## Before writing code 1. **Fetch the latest spec version**: Web-search `site:github.com agentic-commerce-protocol CHANGELOG` for the current spec version 2. **Fetch the OpenAPI specs**: Fetch from `https://github.com/agentic-commerce-protocol/agentic-commerce-protocol/tree/main/spec` — download the latest versioned checkout and delegate-payment OpenAPI YAML files 3. **Fetch the get-started guide**: Fetch `https://developers.openai.com/commerce/guides/get-started/` for onboarding steps 4. **Check for SDK packages**: Search PyPI for `agentic-commerce-protocol` and npm for ACP-related packages. Note: there is no official standalone SDK — most implementations use the OpenAPI spec directly or reference implementations like Medusa.js ## What This Skill Does Scaffolds a new ACP merchant server project: 1. **Detect language/framework** — Python (FastAPI/Flask/Django), TypeScript (Express/Fastify/Medusa), Go, etc. 2. **Install dependencies** — HTTP framework, JSON schema validation, HMAC library, UUID generation 3. **Import OpenAPI spec** — Download the latest versioned spec from the GitHub repo 4. **Create configuration** — Environment variables for API keys, webhook secrets, API version, PSP credentials 5. **Stub endpoints** — Create route stubs for the 5 checkout operations + webhook receiver 6. **Set up middleware** — Bearer token auth, idempotency key extraction, API version header validation, request logging ## Configuration Essentials These must be externalized (env vars or config file): - `ACP_API_KEY` — Bearer token for authentication - `ACP_API_VERSION` — Spec version (YYYY-MM-DD format) - `ACP_WEBHOOK_SECRET` — HMAC signing key for webhooks - `STRIPE_API_KEY` — If using Stripe as PSP for delegated payment - `ACP_MERCHANT_ID` — Merchant identifier for SPT scoping ## Project Structure Pattern ``` merchant-server/ ├── config/ # Environment and settings ├── routes/ │ ├── checkout.py/ts # 5 checkout endpoints │ ├── webhooks.py/ts # Webhook receiver │ └── health.py/ts # Health check ├── middleware/ │ ├── auth.py/ts # Bearer token validation │ ├── idempotency.py/ts # Idempotency key handling │ └── versioning.py/ts # API-Version header validation ├── models/ # Data models from JSON schema ├── services/ │ ├── checkout.py/ts # Business logic │ ├── payment.py/ts # PSP integration │ └── inventory.py/ts # Stock management ├── schemas/ # OpenAPI + JSON schemas └── tests/ ``` Fetch the OpenAPI spec for exact endpoint paths, request/response shapes, and status codes before generating stubs.
Versions
The database has no other skills named acp-setup.
Database snapshot: 13.11.2026 · package version b0fca9c9c546 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100acp-checkout-rest
Implement the ACP REST checkout API — create, update, retrieve, complete, and cancel checkout sessions. Use when building merchant-side checkout endpoints, handling the checkout session state machine, or integrating with AI agent checkout flows. - 100acpremote
Use for `acpremote` tasks: exposing ACP agents or stdio ACP commands over WebSocket, mirroring remote ACP endpoints locally, host ownership semantics, metadata/auth routes, and remote transport examples. - 100acp-repo-template
Create a new ACP super-repo or apply the canonical GitHub repository settings. USE WHEN: creating a repository, applying repository settings, or adding the default branch ruleset. - 100acp-service
使用 @1agents/acp-service 管理 ACP 会话与 DSH 插件,通过 A2A 调用固定角色、派发临时任务、查询父子任务和执行轮次、记录业务验收及处理通知,并回投 Codex/DSH 原会话。也用于项目/角色候选探查、目标登记、网络技能缓存和更新接口接入;不用于无关的系统巡检或模型配置。 - 90acp-conformance
Validate an ACP implementation against the protocol specification — schema validation, flow testing, error handling, idempotency, security checks, and production readiness. Use when preparing for launch or certifying compliance. - 100reset-cursor-acp
Reset a stuck Cursor ACP thread in your chat app and reload its configuration. Use only when the user explicitly invokes /reset-cursor-acp.