git:20260418.3c3158f to git:20260716.c5d769e

5 added, 0 removed. Audit C to A.

+ ---

+ name: agent-ready-api-catalog

+ description: >

+ Sub-skill de agent-ready-cloudflare: Implement API Catalog

+ ---

# Implement API Catalog

Publish an API catalog for automated discovery per

[RFC 9727](https://www.rfc-editor.org/rfc/rfc9727).

## Requirements

- Serve `/.well-known/api-catalog` with `Content-Type: application/linkset+json` and HTTP 200

- Include a `linkset` array with entries for each API

- Each entry needs an `anchor` URL and link relations: `service-desc` (OpenAPI spec), `service-doc` (docs), and optionally `status` (health endpoint)

- See [RFC 9727 Appendix A](https://www.rfc-editor.org/rfc/rfc9727#appendix-A) for examples

## Validate

```

POST https://isitagentready.com/api/scan

Content-Type: application/json

{"url": "https://YOUR-SITE.com"}

```

Check that `checks.discovery.apiCatalog.status` is `"pass"`.