agent-ready-acp — Claude Code skill: ACP setup
The agent-ready-acp skill guides the publication of an ACP discovery document so AI agents can find an Agentic Commerce Protocol implementation.
Apache-2.0 ★ 141 updated 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-acp -a claude-codeWhat agent-ready-acp does
The skill covers an ACP discovery document served from /.well-known/acp.json with HTTP 200. The JSON needs the protocol name set to "acp", a protocol version, an absolute HTTP(S) API base URL, supported transports, and offered services.
You can validate the site with POST https://isitagentready.com/api/scan and the JSON body {"url": "https://YOUR-SITE.com"}. The scan should report checks.commerce.acp.status as "pass". If api_base_url is not an absolute HTTP(S) URL, the document fails this requirement.
The skill is available for Claude Code and Codex. Claude Code places it at ~/.claude/skills/acp/SKILL.md; Codex uses .agents/skills/acp/SKILL.md.
What it helps with
- publish an ACP document at
/.well-known/acp.json - set the protocol name and version in JSON
- provide the ACP API base URL
- declare supported transports and offered services
- validate the document with the ACP scanner
Example prompts for the agent
- Publish an ACP discovery document at
/.well-known/acp.jsonand check its required fields. - Scan
https://YOUR-SITE.comwithPOST https://isitagentready.com/api/scan. - Confirm that
checks.commerce.acp.statusreturns"pass".
How to install agent-ready-acp
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-acp -a claude-code2Manually: put the files in place
~/.claude/skills/acp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/acp/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-acp -a codex2Manually: put the files in place
.agents/skills/acp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-acp -a cursor2Manually: put the files in place
.cursor/skills/acp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/acp2Manually: put the files in place
.github/skills/acp/SKILL.md1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-acp -a gemini-cli2Platform CLI
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/acpManually: put the files in place
.devin/skills/acp/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agent-ready-acp
How do I install agent-ready-acp in Claude Code?
Run npx skills add fabricioctelles/skills --skill acp -a claude-code, then check ~/.claude/skills/acp/SKILL.md.
What does agent-ready-acp do?
It guides the publication of an ACP discovery document at /.well-known/acp.json, allowing AI agents to locate an Agentic Commerce Protocol implementation.
What must the ACP discovery document contain?
It needs HTTP 200 at /.well-known/acp.json, protocol.name set to "acp", a protocol version, an absolute HTTP(S) value for api_base_url, plus non-empty transports and capabilities.services arrays.
Source text
SKILL.md · Apache-2.0
---
name: agent-ready-acp
description: >
Sub-skill de agent-ready-cloudflare: Implement ACP Discovery Document
---
# Implement ACP Discovery Document
Publish an ACP discovery document so AI agents can discover your
[Agentic Commerce Protocol](https://agenticcommerce.dev) implementation.
## Requirements
- Serve JSON at `/.well-known/acp.json` with HTTP 200
- Include `protocol.name` set to `"acp"` and `protocol.version`
- Include `api_base_url` as an absolute HTTP(S) URL
- Include `transports` as a non-empty array of supported transport types
- Include `capabilities.services` as a non-empty array of offered services
## Validate
```
POST https://isitagentready.com/api/scan
Content-Type: application/json
{"url": "https://YOUR-SITE.com"}
```
Check that `checks.commerce.acp.status` is `"pass"`.
© fabricioctelles · Apache-2.0 · fabricioctelles/skills