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
npx skills add fabricioctelles/skills --skill agent-ready-personal-agent-protocol -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/personal-agent-protocol/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/personal-agent-protocol/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-personal-agent-protocol -a codex2Вручную: положить файлы
.agents/skills/personal-agent-protocol/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-personal-agent-protocol -a cursor2Вручную: положить файлы
.cursor/skills/personal-agent-protocol/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/personal-agent-protocol2Вручную: положить файлы
.github/skills/personal-agent-protocol/SKILL.md1Через Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-personal-agent-protocol -a gemini-cli2Командой платформы
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/personal-agent-protocolВручную: положить файлы
.devin/skills/personal-agent-protocol/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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