Perplexity опубликовала открытый гайд по проектированию и поддержке модульных Agent Skills

Perplexity Research официально опубликовала руководство «Designing, Refining, and Maintaining Agent Skills», призванное систематизировать подходы к созданию и поддержке библиотек модульных навыков (Skills), на которых базируются продукты семейства Perplexity Computer. Гайд доступен публично и описывает, как команда Agents проектирует, тестирует и поддерживает навыки, чтобы обеспечить устойчивое и предсказуемое поведение агентных систем и улучшить качество пользовательского опыта.

Основная практическая рекомендация руководства — рассматривать Skill не как одиночный файл, а как директорию (hub-and-spoke), содержащую несколько согласованных компонентов. В типичную структуру входят обязательный SKILL.md с frontmatter и инструкциями, каталог scripts/ для кода, который исполняет агент, references/ для тяжёлых документов, assets/ для шаблонов и схем и конфигурационный файл вроде config.json для первичной настройки. Формат SKILL.md строго задаёт метаданные: имя и описание должны точно соответствовать имени каталога навыка и следовать формальным правилам (нижний регистр, дефисы вместо пробелов), что помогает средам исполнения корректно обнаруживать и подключать навыки.

Руководство подчёркивает, что привычные аксиомы разработки ПО (например, положения PEP20 «The Zen of Python») не всегда применимы при проектировании навыков. Perplexity приводит сравнения типа «Simple is better than complex» против «A Skill is a folder, not a file. Complexity is the feature», или «Explicit is better than implicit» против «Activation is implicit pattern matching. Progressive disclosure». Авторы указывают, что многие приёмы, полезные в коде, становятся антипаттернами при создании Skills: контекст дорог, особые случаи часто представляют наивысшую ценность, а очевидные реализации стоит удалить, потому что модель уже их знает.

В гайде описаны и практические последствия архитектурных решений. Для сложных предметных областей Perplexity применяет многоуровневую иерархию тем: например, при реализации возможностей, связанных с U.S. income tax, команда использовала три уровня вложенности, поскольку загрузка одной папки со всеми 1,945 разделами Налогового кодекса приводила к худшей работе модели, чем отсутствие такого Skill. Авторы отмечают, что увеличение уровней иерархии повышает требования к кураторству и созданию вспомогательных инструментов — быстрых справочников, кастомных поисковых утилит и других средств, которые минимизируют косвенность доступа к нужной информации.

Релиз руководства имеет оперативное и организационное значение для инженеров, продуктовых команд и продвинутых пользователей: единый набор правил и примеров должен сократить число фрагментарных или дублирующих реализаций, упростить обмен и интеграцию Skills между проектами и снизить затраты на сопровождение. В то же время исходные материалы не содержат подробностей о лицензировании, механизмах внешнего вклада и каналах распространения Skills, поэтому практические вопросы интеграции и совместного развития остаются частично неосвещёнными и потребуют уточнения от Perplexity в будущих публикациях или репозиториях.