Возможности Тарифы Документация
Личный кабинет

Скилл dynapi-site-dev

Скилл — это пакет знаний для кодинг-агента: как устроен DynapiCMS, какие у него правила и рецепты. Со скиллом агент строит сайт по канону платформы (сайт = флоу, контент живёт в CMS, черновик → превью → публикация), а не выдумывает структуру сам.

Где взять

Скилл открыт и лежит по одному адресу:

https://dynapi.ru/cms/agent-skill/
  • SKILL.md — входная точка: правила и «золотые» аксиомы платформы.
  • references/ — справочники: API (api-reference.md), флоу (flows-guide.md), диалект Liquid (liquid-guide.md), вход по членским аккаунтам (member-auth.md), коды ошибок и квоты (conventions.md), формы (forms-flow.md), пошаговые рецепты (workflows.md).
  • cli/ — бинарники flowctl для Linux и Windows.

Ссылку и ключ агенту выдаёт человек — скилл сознательно не содержит никаких секретов. Адрес эндпоинта один: https://dynapi.ru/cms/graphql — агенту нужен только ключ.

Как подключить

Проще всего — дать агенту ссылку и переменные окружения. Настройка на вашей стороне.

Linux и macOS:

export DYNAPI_URL="https://dynapi.ru/cms/graphql"
export DYNAPI_APIKEY="dca_…"

Windows (PowerShell):

$env:DYNAPI_URL = "https://dynapi.ru/cms/graphql"
$env:DYNAPI_APIKEY = "dca_…"

Задание агенту — своими словами:

Переменные DYNAPI_URL и DYNAPI_APIKEY уже выставлены в окружении — используй их и работай через flowctl. Скилл: https://dynapi.ru/cms/agent-skill/. Задача: собери лендинг студии, вот бриф.

Агент скачает SKILL.md и нужные справочники из references/ по ходу работы — целиком читать 4000 строк не требуется. Ключ в переменной окружения не попадает в историю чата — это безопаснее, чем вставлять его в текст задания.

Можно и по-старинке: сохранить файлы скилла в проект агента (например, .agents/skills/dynapi-site-dev/) — формат совместим с Claude Code, Cursor и другими агентами, читающими SKILL.md.

Что скилл закладывает

Ключевые правила, которые агент получает со скиллом:

  • Сайт состоит из флоу. Каждая страница, форма или обработчик — это флоу, привязанный к маршруту. Маршрут с GET-привязкой — страница.
  • Контент живёт в CMS, а не в шаблонах. Шаблоны хранят только разметку и стили; каждое видимое предложение — запись в типе контента, которую правят из админки без пересборки сайта.
  • Черновик → превью → публикация. Всё сначала пишется черновиком, проверяется на превью-хосте и только потом выкатывается посетителям.
  • Ошибки — машинные коды. Вместо английских простыней API возвращает коды вида SITE_QUERY_IN_USE — агент читает код и чинит конкретную вещь.
  • Проверяй до публикации. flowctl validate и dryrun прогоняют флоу локально и на сервере до того, как посетитель увидит результат.

Пресеты

Готовые флоу — вход, регистрация, сброс пароля, типовая страница — входят в админку как «Заготовки» (см. Заготовки, экспорт и импорт). Агент применяет их мутациями импорта вместо ручной сборки — сценарии входа слишком чувствительны, чтобы собирать их с нуля.

Далее: flowctl — командная строка агента →