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
npx skills add fabricioctelles/skills --skill agent-ready-oauth-protected-resource -a claude-codeWhat 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-resourcewithresourceandauthorization_servers. - Scan the resource with
POST https://isitagentready.com/api/scanand verify thatchecks.discovery.oauthProtectedResource.statusispass.
How to install agent-ready-oauth-protected-resource
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-oauth-protected-resource -a claude-code2Manually: put the files in place
~/.claude/skills/oauth-protected-resource/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/oauth-protected-resource/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-oauth-protected-resource -a codex2Manually: put the files in place
.agents/skills/oauth-protected-resource/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-oauth-protected-resource -a cursor2Manually: put the files in place
.cursor/skills/oauth-protected-resource/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/oauth-protected-resource2Manually: put the files in place
.github/skills/oauth-protected-resource/SKILL.md1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-oauth-protected-resource -a gemini-cli2Platform CLI
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/oauth-protected-resourceManually: put the files in place
.devin/skills/oauth-protected-resource/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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