Move skills to .agent directory
This commit is contained in:
27
.agents/skills/agent-ready-cloudflare/api-catalog/SKILL.md
Normal file
27
.agents/skills/agent-ready-cloudflare/api-catalog/SKILL.md
Normal file
@@ -0,0 +1,27 @@
|
||||
---
|
||||
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"`.
|
||||
Reference in New Issue
Block a user