Skip to main content
skill CX Codex

agent-ready-oauth-protected-resource — Claude Code skill

agent-ready-oauth-protected-resource publishes OAuth Protected Resource Metadata so agents can discover how to authenticate. It fits Cloudflare setups that expose a protected resource.

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-oauth-protected-resource -a claude-code
Open on GitHub

What agent-ready-oauth-protected-resource does

This skill guides the publication of OAuth Protected Resource Metadata under RFC 9728. It uses /.well-known/oauth-protected-resource, which should return HTTP 200 and JSON containing resource plus an authorization_servers array. You can also expose scopes_supported when the resource needs it.

For Cloudflare, Workers serves the metadata endpoint and Cloudflare Access acts as the authorization server. A 401 response may include WWW-Authenticate with a resource_metadata value. To validate the setup, send POST https://isitagentready.com/api/scan with a JSON url field, then check for pass at checks.discovery.oauthProtectedResource.status. Workers is required for the endpoint arrangement described here.

What it helps with

  • publish OAuth Protected Resource Metadata
  • serve JSON from /.well-known/oauth-protected-resource
  • declare the resource and its authorization servers
  • validate OAuth metadata discovery through the scan API

Example prompts for the agent

  • Implement OAuth Protected Resource Metadata for this resource under RFC 9728.
  • Add /.well-known/oauth-protected-resource with resource and authorization_servers.
  • Scan the resource with POST https://isitagentready.com/api/scan and verify that checks.discovery.oauthProtectedResource.status is pass.

How to install agent-ready-oauth-protected-resource

1Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-oauth-protected-resource -a claude-code

2Manually: put the files in place

~/.claude/skills/oauth-protected-resource/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/oauth-protected-resource/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-ready-oauth-protected-resource

How do I install agent-ready-oauth-protected-resource in Claude Code?

Run npx skills add fabricioctelles/skills --skill oauth-protected-resource -a claude-code, then use ~/.claude/skills/oauth-protected-resource/SKILL.md.

What does agent-ready-oauth-protected-resource do?

It helps configure OAuth Protected Resource Metadata so agents can discover the resource’s authentication method under RFC 9728.

What Cloudflare components does the skill use?

Workers serves /.well-known/oauth-protected-resource, while Cloudflare Access is used as the authorization server.

Source text

SKILL.md · Apache-2.0
---
name: agent-ready-oauth-protected-resource
description: >
  Sub-skill de agent-ready-cloudflare: Implement OAuth Protected Resource Metadata
---
# Implement OAuth Protected Resource Metadata

Publish OAuth Protected Resource Metadata so agents can discover how to
authenticate per [RFC 9728](https://www.rfc-editor.org/rfc/rfc9728).

## Requirements

- Serve JSON at `/.well-known/oauth-protected-resource` with HTTP 200
- Include `resource` (your resource identifier URL)
- Include `authorization_servers` (array of OAuth/OIDC issuer URLs)
- Optionally include `scopes_supported`
- Optionally return `WWW-Authenticate` with `resource_metadata` on 401 responses

## Cloudflare

Use [Workers](https://developers.cloudflare.com/workers/) to serve the
metadata endpoint and [Access](https://developers.cloudflare.com/cloudflare-one/)
as the authorization server.

## Validate

```
POST https://isitagentready.com/api/scan
Content-Type: application/json

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

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

© fabricioctelles · Apache-2.0 · fabricioctelles/skills

Similar skills

All skills for Security →

From the same set46

The whole set →
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 agent-ready-a2a-agent-card agent-ready-a2a-agent-card generates an A2A Agent Card file for agent-to-agent discovery. Useful when setting up agent endpoints on Cloudflare Workers. CX Codex +1 ★ 141repo stars agent-ready-web-bot-auth The agent-ready-web-bot-auth skill guides Web Bot Auth setup so receiving sites can verify bot or agent requests. Use it when your site needs to identify its signed outbound traffic. CX Codex +1 ★ 141repo stars agent-ready-agent-skills agent-ready-agent-skills publishes an agent skills discovery index matching the RFC v0.2.0 specification. Useful when exposing local agent tools to external crawlers. CX Codex +1 ★ 141repo stars agent-ready-link-headers agent-ready-link-headers is a Claude Code skill that adds Link response headers to a site's homepage so AI agents can discover its API and documentation automatically. CX Codex +1 ★ 141repo stars agent-ready-markdown-negotiation agent-ready-markdown-negotiation implements Accept: text/markdown content negotiation so AI agents receive clean Markdown representations instead of raw HTML. CX Codex +1 ★ 141repo stars agent-ready-webmcp agent-ready-webmcp wires a site's actions into the WebMCP API so browser-based AI agents can find and call them. CX Codex +1 ★ 141repo stars agent-ready-ai-rules agent-ready-ai-rules is a skill that adds RFC 9309 rules for AI search and training crawlers to robots.txt, controlling page visibility in AI answers and use for model training. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open