Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add fabricioctelles/skills --skill agent-ready-acp -a claude-code
Open on GitHub

What 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.json and check its required fields.
  • Scan https://YOUR-SITE.com with POST https://isitagentready.com/api/scan.
  • Confirm that checks.commerce.acp.status returns "pass".

How to install agent-ready-acp

1Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-acp -a claude-code

2Manually: put the files in place

~/.claude/skills/acp/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/acp/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set46

The whole set →
agent-ready-ucp agent-ready-ucp sets up Universal Commerce Protocol to allow content payments on your website. Useful when preparing an API or web service for autonomous agents. CX Codex +1 ★ 141repo stars agent-ready-sitemap The agent-ready-sitemap skill guides an agent through adding and checking an XML sitemap for public site pages. Use it when search crawlers need a clear page index. CX Codex +1 ★ 141repo stars agent-ready-llms-txt The agent-ready-llms-txt skill publishes a /llms.txt file on your site so agents and AI models can quickly understand its structure and content. Use it to make your site agent-ready. CX Codex +1 ★ 141repo stars agent-ready-x402 agent-ready-x402 configures x402 payment protocol support for backend routes. Useful when your API needs to accept automated HTTP payments from AI agents. CX Codex +1 ★ 141repo stars agent-ready-robots-txt The agent-ready-robots-txt skill publishes a standards-compliant robots.txt at your site root per RFC 9309. Use it when agents need to control bot access and reference your sitemap. CX Codex +1 ★ 141repo stars agent-ready-api-catalog agent-ready-api-catalog implements an RFC 9727 API catalog so autonomous agents can discover your endpoints and OpenAPI specifications. CX Codex +1 ★ 141repo stars agent-ready-content-signals The agent-ready-content-signals skill adds Content Signals to robots.txt, letting you set preferences for AI training, search, and AI input. CX Codex +1 ★ 141repo stars agent-ready-mcp-server-card agent-ready-mcp-server-card — a skill that publishes an MCP Server Card, a JSON file for agent discovery. Use it when running your own MCP server and want tools like isitagentready.com to find and validate it. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open