SkillFoxx
Telegram

PolyAI ADK Skills

Пять скиллов PolyAI учат агента работать с CLI poly: правка голосового агента на ветке, проверка, пуш, тесты и слияние.

  • 83 ★ репозитория
  • Последний коммит
СкиллОфициальный

Расширенный доступ

Почему такой уровень

  • Команды `poly push` и `poly merge` меняют проект на платформе PolyAI, а `poly push --force` перезаписывает чужие правки
  • Скилл про настройки времени выполнения работает с живым окружением
Все причины и проверки

polyai/adkАвтор:PolyAI

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/polyai-adk-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Команды `poly push` и `poly merge` меняют проект на платформе PolyAI, а `poly push --force` перезаписывает чужие правки
  • Скилл про настройки времени выполнения работает с живым окружением

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий содержит CLI `poly` для платформы PolyAI Agent Studio и пять скиллов, которые учат кодового агента пользоваться им. Ресурсы агента (потоки, функции, темы, сущности, настройки) лежат на диске файлами YAML, текста и Python, а команды `poly pull`, `poly push`, `poly branch` и `poly merge` дают рабочий процесс как в Git. Входной скилл `poly-adk-workflow` описывает установку, проект и цикл «правка, проверка, пуш, тест, слияние». Остальные подгружаются по задаче: `poly-adk-testing` отвечает за `poly validate` и диалоговые тесты, `poly-adk-branching` за ветки и трехстороннее слияние, `poly-adk-conversations` за разбор реальных звонков, метрик и расшифровок, `poly-adk-rtc` за настройки времени выполнения по окружениям. Схемы ресурсов в скиллы не копируют, их выдает `poly docs` из установленной версии.

Для кого. Разработчикам голосовых и чат-агентов на PolyAI Agent Studio, которые правят проект в Claude Code, Cursor или Codex.

Подходит, если

  • Голосовой агент в Agent Studio надо изменить на отдельной ветке и проверить перед слиянием
  • После правки нужны скриптовые диалоги через `poly chat` и сценарные тесты из папки `test_suite/`
  • Ветки разошлись, и конфликт надо разобрать без интерактивного режима
  • Нужно разобрать реальные звонки: расшифровки, метрики и оценку Poly Score
  • Параметры времени выполнения для живого окружения меняют аккуратно, с защитой от расхождения

Не подходит, если

  • Нет аккаунта PolyAI Agent Studio: без него команды `poly pull` и `poly push` не работают
  • Агент строится на другой платформе: скиллы описывают только процесс PolyAI ADK
  • Нужен справочник по схемам ресурсов: их выдает команда `poly docs` установленной версии, в скиллах схем нет

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

Создай ветку, измени тему приветствия в проекте PolyAI, прогони `poly validate` и покажи, что уйдет на платформу при `poly push --dry-run`.

Ограничения

Нужны аккаунт Agent Studio и ключ API, которые настраивает `poly setup`. Для звонков командой `poly call` ставится дополнительный набор `polyai-adk[call]` с аудио и WebRTC, в основной установке его нет. Скиллы привязаны к версии пакета `polyai-adk`: поле `metadata.version` каждого скилла равно текущему релизу. Операции `poly push` меняют проект на платформе, а `poly push --force` перезаписывает чужие правки, поэтому запускайте их осознанно и сначала смотрите `--dry-run`. Контрибьюторские скиллы в `.claude/skills/` предназначены для разработки самого репозитория.

Как отключить. Удалите папки скиллов `poly-adk-*` из каталога скиллов вашего агента. Сам CLI снимается командой `uv tool uninstall polyai-adk` или `pip uninstall polyai-adk`. Проект на платформе остается нетронутым.

Частые вопросы

Как поставить скиллы PolyAI?

Командой `npx -y skills add https://github.com/polyai/adk -y`. CLI ставится отдельно: `uv tool install polyai-adk` или `pip install polyai-adk`, а `poly setup` настраивает аккаунт, ключ, скиллы и проект.

Какие команды есть у poly?

Основные: `poly init`, `poly pull`, `poly push`, `poly status`, `poly diff`, `poly branch`, `poly format`, `poly validate`, `poly review`, `poly deployments`, `poly docs`, `poly chat`. Подробности каждой команды покажет ключ `--help`.

Как тестировать агента до пуша?

Запустите `poly validate` для проверки файлов и `poly chat` для диалога, в том числе скриптового. Для сценариев используйте папку `test_suite/` с симулированными разговорами, их описывает скилл `poly-adk-testing`.

Можно ли смотреть метрики звонков?

Да. Скилл `poly-adk-conversations` описывает `poly conversations` для реальных звонков, `poly metrics` для значений метрик и Poly Score и `poly transcripts` для поиска по расшифровкам.

Нужен ли аккаунт PolyAI?

Да, нужен аккаунт в Agent Studio. Ключ для API получают командой `poly apikey`, а `poly setup` проводит через регистрацию и настройку.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

CLI-установщик и менеджер скиллов для кодовых агентов: одна команда ставит скиллы в разные среды и помогает собирать свои

CLIРасширенный доступ1,2 тыс.

CLI для управления несколькими кодовыми агентами: общий конфиг, консоль сессий, локальная память и набор инженерных скиллов

CLIШирокий доступ1,7 тыс.

CLI-менеджер скиллов для ИИ-агентов: установка из репозиториев, перевод между форматами разных агентов и раскладка в их конфигурацию

CLIРасширенный доступ1,6 тыс.

Каталог из почти двухсот скиллов: доставка кода, ревью, отладка, управление ИИ, продуктовая работа и координация агентов.

СкиллМинимальный доступ174

Плагин Microsoft для Claude Code, Copilot CLI и VS Code: пишет, тестирует и чинит агентов Copilot Studio через YAML.

ПлагинРасширенный доступ492

Терминальный агент AdaL: переключает модели, показывает правки и планы на проверку и передает сессию в собственную IDE.

CLIШирокий доступ111

Коротко о README

Описание представляет CLI `poly`: установка через `uv` или `pip`, затем `poly setup`, список основных команд и подробный разбор каждой с примерами ключей. Отдельно описаны голосовые звонки, чат с агентом и расширение `call`. Папка `skills/` с собственным README объясняет пять скиллов и их версионирование.

Бейдж для README

Исходный SKILL.md

---
name: poly-adk-workflow
description: >
  This skill should be used when the user wants to "build an agent", "update an agent",
  "create a PolyAI project", "push changes to Agent Studio", or work with the PolyAI ADK
  (`poly`) in any way. Entrypoint for the PolyAI ADK skills suite — covers setup, project
  structure, resource choice, and the core edit/validate/push/test/merge workflow, and
  routes to the task-specific skills (testing, branching, conversations, rtc).
metadata:
  author: PolyAI
  license: Apache-2.0
  version: 0.80.0
  requires:
    bins:
      - poly
    install: "uv tool install polyai-adk"
---

# PolyAI ADK workflow

The PolyAI ADK (`poly`) is a CLI for building dialog agents on the Agent Studio platform. It gives you a Git-like local workflow: agent resources (flows, functions, topics, entities, settings) live on disk as YAML, text, and Python files, and you `pull`, `push`, `branch`, and `merge` them against the platform.

Use `poly <command> --help` as the source of truth for flags. Almost every command accepts `--json` (a single JSON object on stdout, exit code 0 on success) — prefer it when you need to parse output.

## Task-specific skills

This skill covers setup and the core loop. Load the matching skill when the task goes deeper:

| Task | Skill |
|---|---|
| Testing the agent — scripted chat, running the test suite, writing test cases | `poly-adk-testing` |
| Merge conflicts, branch management, sharing reviews | `poly-adk-branching` |
| Inspecting real conversations, reading Poly Score and metrics, searching transcripts, logging | `poly-adk-conversations` |
| Per-environment real-time configuration | `poly-adk-rtc` |

## 1. Installing and updating

Assume `poly` is installed. If a command fails because it isn't:

- **Install** → `uv tool install polyai-adk` (install `uv` first if needed: `curl -LsSf https://astral.sh/uv/install.sh | sh`)
- **Update to latest** → `uv tool upgrade polyai-adk`

## 2. Authentication

Assume the user is already logged in — do not check credentials up front. Only if a command fails with an authentication error, ask the user to run `poly login` — it opens a browser to sign in, so they must complete it themselves. Regions: `studio` for self-serve accounts, `us` / `eu` / `uk` for enterprise workspaces. On a fresh machine, `poly setup` runs sign-in plus shell completion, AI skills, and project setup in one command.

Сообщить о проблеме