К основному содержанию
скилл CX Codex

agent-ready-auth-md — скилл для Claude Code

Скилл agent-ready-auth-md публикует для сервиса документ auth.md и метаданные OAuth, чтобы агенты находили способ регистрации. Включается, когда сканер отмечает проверку authMd как неуспешную.

Apache-2.0 ★ 141 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add fabricioctelles/skills --skill agent-ready-auth-md -a claude-code
Открыть на GitHub

Что делает agent-ready-auth-md

Скилл раскладывает /auth.md в корне сервиса: Markdown-файл с заголовком H1, где встречается «auth.md». Рядом публикуются метаданные OAuth Protected Resource — поля resource, authorization_servers, scopes_supported и bearer_methods_supported со значением header, а для каждого сервера авторизации из этого списка отдельно описываются его собственные метаданные с полем issuer, совпадающим с тем, что указан в Protected Resource.

Если в PRM есть метаданные сервера авторизации, скилл добавляет блок agent_auth с полями skill, register_uri и хотя бы одним полным методом регистрации. Для сценариев ID-JAG, verified email и anonymous описаны свои наборы полей: типы утверждений, типы credential и claim_uri или revocation_uri в зависимости от случая.

Скилл прямо запрещает дёргать POST /agent/auth во время пассивного сканирования: такой запрос может создать аккаунт, отправить письмо или выдать credential, поэтому источником истины остаются публичные документы discovery.

Какие задачи решает

  • опубликовать auth.md с метаданными OAuth для агентов
  • пройти проверку authMd в сканере agent-ready
  • описать endpoint регистрации агента без живого сервера авторизации
  • настроить метаданные Protected Resource и Authorization Server
  • добавить блок agent_auth с методом регистрации под ID-JAG или verified email

Примеры запросов агенту

  • Добавь auth.md для прохождения проверки authMd
  • Опиши в auth.md метаданные OAuth Protected Resource для нашего API
  • Настрой блок agent_auth с методом регистрации verified email

Как установить agent-ready-auth-md

1Через Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-auth-md -a claude-code

2Вручную: положить файлы

~/.claude/skills/auth-md/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/auth-md/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об agent-ready-auth-md

Как установить agent-ready-auth-md в Claude Code?

Выполните npx skills add fabricioctelles/skills --skill auth-md -a claude-code, скилл появится в ~/.claude/skills/auth-md/SKILL.md.

Что делает agent-ready-auth-md?

Помогает сервису опубликовать документ auth.md с метаданными OAuth, чтобы агенты могли найти способ регистрации. Используется, когда проверка authMd в сканере не проходит.

Какие данные нужны для метаданных сервера авторизации?

В документе Authorization Server должен быть корректный issuer, совпадающий с тем, что указан в метаданных Protected Resource, иначе проверка не пройдёт.

Исходный текст

SKILL.md · Apache-2.0
---
name: agent-ready-auth-md
description: >
  Sub-skill: Implement Auth.md for agent registration discovery. Serve /auth.md with OAuth
  metadata at /.well-known/oauth-protected-resource and authorization server endpoints.
---
# Skill: Implement Auth.md Agent Registration Discovery

## What This Skill Does

Helps a service publish Auth.md support for agent registration. Use this when a scanner reports the `authMd` check is failing or when adding the Auth.md standard to an API or application.

## Requirements

- Serve `/auth.md` from the service root as Markdown with an H1 heading that contains `auth.md` (for example, `# auth.md` or `# Example auth.md`).
- Prefer publishing OAuth Protected Resource Metadata at `/.well-known/oauth-protected-resource` for the resource server.
- Include `resource`, `authorization_servers`, `scopes_supported`, and `bearer_methods_supported` with `header` in the PRM document.
- Publish OAuth Authorization Server metadata at each advertised authorization server's `/.well-known/oauth-authorization-server` URL.
- Include a valid `issuer` in Authorization Server metadata and ensure it matches the issuer advertised in PRM.
- Add an `agent_auth` block with `skill`, `register_uri`, and at least one complete registration method when Authorization Server metadata is available.
- If OAuth metadata is not available, keep `/auth.md` self-contained: identify the agent audience, document registration or provisioning endpoint(s), list supported method(s), and explain credential use.

## Flow Metadata

- **ID-JAG**: include `identity_types_supported: ["identity_assertion"]`, `identity_assertion.assertion_types_supported` with `urn:ietf:params:oauth:token-type:id-jag`, and credential types. Include `revocation_uri` and the revocation event in `events_supported` when supported; scanners may warn when they are omitted, but they are not required for detection.
- **Verified email**: include `identity_assertion.assertion_types_supported` with `verified_email`, credential types, and `claim_uri`.
- **Anonymous**: include `identity_types_supported: ["anonymous"]`, `anonymous.credential_types_supported`, and `claim_uri`.

## Notes

Do not probe `POST /agent/auth` during passive scans. Registration can create accounts, send email, or issue credentials. Public discovery documents are the safe source of truth.

## Validate

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

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

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

## References

- [Auth.md Specification](https://auth-md.com)
- [RFC 9728 — OAuth Protected Resource Metadata](https://www.rfc-editor.org/rfc/rfc9728)
- [RFC 8414 — OAuth Authorization Server Metadata](https://www.rfc-editor.org/rfc/rfc8414)

© fabricioctelles · Apache-2.0 · fabricioctelles/skills

Похожие скиллы

Все скиллы по теме «Безопасность» →
better-auth-security-best-practices better-auth Скилл better-auth-security-best-practices настраивает защиту Better Auth: ограничивает частоту запросов, проверяет происхождение, шифрует токены и защищает пользовательские сессии. CX Codex +1 52 200установок neon-auth neondatabase Скилл neon-auth для Claude Code настраивает аутентификацию через Neon Auth в новом приложении. Он подключается к задачам входа, регистрации, сброса пароля и OAuth. CX Codex +1 38 600установок create-auth better-auth Скилл create-auth проводит агента через планирование и настройку аутентификации в TypeScript/JavaScript-проекте на Better Auth: от сканирования кода до страниц входа. CX Codex +1 15 300установок aws-auth aws Скилл aws-auth для Claude Code добавляет аутентификацию пользователей через Amazon Cognito в веб- и мобильные приложения. Настраивает вход, MFA, OAuth и защиту API. CX Codex +1 5 700установок da-auth adobe Скилл da-auth для Claude Code получает токен доступа Adobe IMS для API admin.da.live. Включается перед отправкой страниц, просмотром списка документов или запуском превью в DA. CX Codex +1 1 100установок nodeops-auth NodeOps-app Скилл nodeops-auth для Claude Code подключает вход NodeOps по PKCE к приложению Next.js. Настраивает NodeOps login или SSO. CX Codex +1 564установок

Из того же набора46

Весь набор →
agent-ready-ai-rules Скилл agent-ready-ai-rules для Claude Code и Codex добавляет в robots.txt правила RFC 9309 для AI-поисковиков и обучающих ботов. Контролирует показ страниц в ответах AI-ассистентов и их использование для обучения. CX Codex +1 ★ 141звёзд репо agent-ready-mpp Скилл agent-ready-mpp помогает внедрить Machine Payment Protocol (MPP) в OpenAPI, добавляя разметку x-payment-info для платных эндпоинтов вашего API. CX Codex +1 ★ 141звёзд репо agent-ready-dns-aid Скилл agent-ready-dns-aid для Claude Code публикует DNS-AID-записи, чтобы агенты находили endpoint через DNS. Настраивает SVCB или HTTPS-записи в пространстве _agents. CX Codex +1 ★ 141звёзд репо agent-ready-personal-agent-protocol Скилл agent-ready-personal-agent-protocol публикует метаданные Personal Agent Protocol (Poppy) черновика 0.1 по адресу /.well-known/poppy.json и проверяет привязку OAuth issuer. CX Codex +1 ★ 141звёзд репо agent-ready-ard Скилл agent-ready-ard для Claude Code помогает опубликовать /.well-known/ai-catalog.json, чтобы агенты находили MCP-серверы, A2A-агентов, скиллы и API-инструменты. Задача — настроить обнаружение ресурсов проекта. CX Codex +1 ★ 141звёзд репо agent-ready-scan-site Скилл agent-ready-scan-site сканирует сайт и проверяет, готов ли он для работы с AI-агентами. Анализирует 23 стандарта по пяти категориям: видимость, доступность контента, управление ботами, API и коммерция. CX Codex +1 ★ 141звёзд репо ultimate-design-system-master Скилл ultimate-design-system-master для Claude Code пошагово создаёт дизайн-системы, токены, компоненты и документацию через 10 генераторов. Проводит от брифа до кода экранов. CX Codex +1 ★ 141звёзд репо substack-expert Скилл substack-expert помогает готовить Substack-публикации: выстраивает структуру, SEO-метаданные, вовлечение и путь от бесплатной подписки к платной. CX Codex +1 ★ 141звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой