# agent-ready-auth-md

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 141 у репозитория
- Автор: fabricioctelles
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/fabricioctelles/skills/tree/HEAD/skills/agent-ready-cloudflare/auth-md/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-auth-md -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/auth-md/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/auth-md/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-auth-md -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/auth-md/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-auth-md -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/auth-md/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/auth-md
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/auth-md/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fabricioctelles/skills --skill agent-ready-auth-md -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/auth-md
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/auth-md/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/fabricioctelles/skills/tree/HEAD/skills/agent-ready-cloudflare/auth-md/SKILL.md

## Когда брать
- опубликовать 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

## Похожие
- [better-auth-security-best-practices](https://affpapa.org/nevibecode/skills/better-auth-security-best-practices.md) — скилл · 52200 установок
- [neon-auth](https://affpapa.org/nevibecode/skills/neon-auth.md) — скилл · 38600 установок
- [create-auth](https://affpapa.org/nevibecode/skills/create-auth.md) — скилл · 15300 установок
- [aws-auth](https://affpapa.org/nevibecode/skills/aws-auth.md) — скилл · 5700 установок
- [da-auth](https://affpapa.org/nevibecode/skills/da-auth.md) — скилл · 1100 установок
- [nodeops-auth](https://affpapa.org/nevibecode/skills/nodeops-auth.md) — скилл · 564 установки

Из того же набора: [fabricioctelles/skills](https://affpapa.org/nevibecode/by/fabricioctelles/skills.md) — 46 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
