Api catalog

Skill whiteknightonhorse/aipush-agent-skills/skills/api-catalog

Free, open, security-verified agent skills for AEO (Answer Engine Optimization) — make any site ready for AI agents. Live: aipush.app

Install

npx -y skills add whiteknightonhorse/aipush-agent-skills --skill api-catalog

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.3 KB, as published. Nobody here has run it

Publish an API catalog (RFC 9727)

AIPUSH agent skill · Category: Agent Interfaces · Slug: api-catalog

An API catalog lets agents find your service description (OpenAPI), documentation, and status endpoints programmatically — the entry point for automated integration.

Why it matters

An API catalog lets agents find your service description (OpenAPI), documentation, and status endpoints programmatically — the entry point for automated integration.

How to detect

Request https://YOURDOMAIN/.well-known/api-catalog (HTTP 200, Content-Type: application/linkset+json).

How to implement

Serve /.well-known/api-catalog as application/linkset+json:

{
  "linkset": [
    {
      "anchor": "https://YOURDOMAIN/api",
      "service-desc": [{ "href": "https://YOURDOMAIN/openapi.json", "type": "application/json" }],
      "service-doc": [{ "href": "https://YOURDOMAIN/docs/api", "type": "text/html" }],
      "status": [{ "href": "https://YOURDOMAIN/api/health" }]
    }
  ]
}

How to verify

curl -s https://YOURDOMAIN/.well-known/api-catalog | jq .linkset returns your entries.

References

Part of the AIPUSH agent skills catalog. Scan your site free at https://aipush.app.