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

agent-ready-personal-agent-protocol — скилл для Claude Code и Codex

Скилл agent-ready-personal-agent-protocol публикует метаданные Personal Agent Protocol (Poppy) черновика 0.1 по адресу /.well-known/poppy.json и проверяет привязку OAuth issuer.

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

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

Что делает agent-ready-personal-agent-protocol

Скилл размещает файл обнаружения для Personal Agent Protocol в каталоге .well-known домена и валидирует его соответствие черновику 0.1. Минимальная конфигурация включает версию протокола, имя и домен организации, объект web. Домен должен совпадать с хостом URL, игнорируя префикс www..

Для интерфейсов с сессиями скилл объявляет agent.protocols с типом и HTTPS-эндпоинтом, apis с типом, URL и описанием, либо web.browser_session_endpoint. Все они требуют auth.issuer, который публикует метаданные RFC 8414: issuer совпадает с auth.issuer, poppy_domains содержит organization.domain, есть token_endpoint и revocation_endpoint. Для issuer https://auth.example.com/tenant метаданные размещаются по адресу https://auth.example.com/.well-known/oauth-authorization-server/tenant.

Проверка подтверждает публичное обнаружение и привязку issuer, но не работоспособность сессий и API. Черновик может измениться до версии 1.0. Результат сканирования попадает в checks.discovery.personalAgentProtocol, поле details.issuerValidation содержит статус verified, notRequired, unverified, invalid или notChecked.

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

  • опубликовать метаданные Personal Agent Protocol на домене
  • проверить привязку OAuth issuer к домену организации
  • объявить доступные интерфейсы агента и API с эндпоинтами

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

  • Размести файл обнаружения Poppy по адресу /.well-known/poppy.json с данными организации.
  • Проверь валидность метаданных issuer для auth.issuer из конфигурации.
  • Добавь объявления agent.protocols и apis для работающих интерфейсов.

Как установить agent-ready-personal-agent-protocol

1Через Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-personal-agent-protocol -a claude-code

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

~/.claude/skills/personal-agent-protocol/SKILL.md

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

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

Вопросы об agent-ready-personal-agent-protocol

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

Выполни npx skills add fabricioctelles/skills --skill personal-agent-protocol -a claude-code, файл скилла окажется в ~/.claude/skills/personal-agent-protocol/SKILL.md.

Что делает agent-ready-personal-agent-protocol?

Публикует метаданные Personal Agent Protocol черновика 0.1 в /.well-known/poppy.json и валидирует привязку OAuth issuer к домену организации. Проверка информационная, не влияет на уровни готовности.

Что должен содержать файл poppy.json для минимальной конфигурации?

Версию протокола 0.1, объект organization с именем и доменом, объект web. Домен должен совпадать с хостом запрашиваемого URL, без учёта www.. Формат JSON, не HTML fallback вашего SPA.

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

SKILL.md · Apache-2.0
---
name: agent-ready-personal-agent-protocol
description: >
  Sub-skill: Implement Personal Agent Protocol (Poppy) discovery. Publish
  /.well-known/poppy.json (draft 0.1) and validate its OAuth issuer binding.
  Informational check; does not affect level or score.
---
# Implement Personal Agent Protocol (Poppy) discovery

Publish public discovery metadata for the [Personal Agent Protocol draft
0.1](https://personalagentprotocol.org/docs/spec#3-discovery). This check is
informational and does not affect readiness levels or percentage scores.

## Website-only discovery

Serve JSON at `https://YOUR-DOMAIN/.well-known/poppy.json`:

```json
{
  "protocol_version": "0.1",
  "organization": { "name": "Example Company", "domain": "example.com" },
  "web": {}
}
```

Replace the example organization with your actual name and domain. The domain
must match the hostname of the requested well-known URL, ignoring leading
`www.`. HTTPS redirects to a hosting provider are allowed, but that provider's
hostname must not replace your organization domain. Return JSON, not your SPA's
HTML fallback. Unknown fields and optional extensions are allowed.

## Session-enabled interfaces

Declare the interfaces you actually implement: `agent.protocols` entries with
`type` and HTTPS `endpoint`, `apis` entries with `type`, HTTPS `url`, and
`description`, or `web.browser_session_endpoint`. Agent/API declarations and
browser-session endpoints require `auth.issuer`.

The issuer must publish RFC 8414 metadata with:

- `issuer` exactly matching `auth.issuer`;
- `poppy_domains` containing `organization.domain`;
- HTTPS `token_endpoint` and `revocation_endpoint`;
- `authorization_endpoint` when `auth.direct` is declared;
- `device_authorization_endpoint` when `auth.device` is declared.

For issuer `https://auth.example.com/tenant`, publish metadata at
`https://auth.example.com/.well-known/oauth-authorization-server/tenant`.
Direct, device, and mediated sign-in declarations contain scope arrays. Mediated
sign-in also describes its endpoint and credential fields; never put actual
credentials or secrets in discovery metadata.

Publish only capabilities backed by working implementations. Passing this check
confirms public discovery and issuer binding, not functioning sessions, sign-in,
API authorization, or conversations. The draft may change before version 1.0.

## Verify

Scan your site and inspect `checks.discovery.personalAgentProtocol`. Its
`details.issuerValidation` reports `verified`, `notRequired`, `unverified`,
`invalid`, or `notChecked`. Use the audit evidence to diagnose invalid fields,
redirects, and issuer/domain mismatches. Network failures and unsupported major
versions return `unableToCheck` while retaining available discovery evidence.

© fabricioctelles · Apache-2.0 · fabricioctelles/skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
crypto-protocol-diagram trailofbits Скилл crypto-protocol-diagram разбирает код или спеку криптопротокола и собирает Mermaid sequenceDiagram с пометками операций: keygen, DH, KDF, подпись. CX Codex +1 4 500установок competition-custom-protocol-replay zhaoxuya520 Скилл competition-custom-protocol-replay для Claude Code восстанавливает бинарные и текстовые протоколы и воспроизводит состояние сессии в CTF. Запускается при разборе кастомных кадров, контрольных сумм и порядка пакетов. CX Codex +1 109установок bailian-protocol modelstudioai Скилл bailian-protocol задаёт протокол выполнения, проверки прав и согласий для инструментов Alibaba Cloud Bailian. Он нужен как база перед запуском любых команд семейства bl. CX Codex +1 9 400установок review-verification-protocol existential-birds Скилл review-verification-protocol обязывает проверить каждую находку перед тем, как внести её в отчёт — читать исходный код, искать контекст, отличать баги от стиля. Снижает ложные срабатывания в ревью. CX Codex +1 252установок mcp-protocol-specialist davila7 Субагент mcp-protocol-specialist для работы со спецификацией Model Context Protocol: транспорт, JSON-RPC 2.0, версионирование и совместимость реализаций. CX Codex 781установок mcp-protocol-stinger Legion Code Inc. Скилл mcp-protocol-stinger для проектирования и аудита MCP-серверов на Claude Code и Codex. Включает справочники по инструментам, схемам, транспорту, JSON-RPC ошибкам, аутентификации, тестированию и регистрации серверов в разных IDE. CX Codex +1 ★ 96звёзд репо

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

Весь набор →
agent-ready-webmcp Скилл agent-ready-webmcp добавляет в сайт поддержку WebMCP API, чтобы браузерные ИИ-агенты видели и вызывали его функции. CX Codex +1 ★ 141звёзд репо 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-auth-md Скилл agent-ready-auth-md публикует для сервиса документ auth.md и метаданные OAuth, чтобы агенты находили способ регистрации. Включается, когда сканер отмечает проверку authMd как неуспешную. 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звёзд репо

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

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