Скилл для агента Figma — astra-ds-doc-build (figma-agent/README.md)
Источник:
ds-skills/src/skills/astra-figma-doc-build/figma-agent/README.md— часть скилла astra-figma-doc-build. Скрипт проверкиcheck.mjsв вики не выложен, лежит в папкеfigma-agent/.
Агент, встроенный в Figma, собирает документацию выделенного компонента Astra DS: секцию
из трёх страниц на атомах библиотеки «Astra DS: Docs». Вызов в чате агента —
/astra-ds-doc-build.
Файл скилла — astra-ds-doc-build.md. Инструкции в нём на английском,
чтобы модель читала их однозначно. Описание (description) на русском, и агент говорит
с пользователем и пишет в Figma только по-русски.
Как устроен
Как прошлый рабочий скилл для агента Figma (F:\tools\ds-doc-build\project\figma-agent\):
пошаговая инструкция, короткий код на каждый шаг, проверка снимком после страницы.
| Helpers | общие функции и ключи атомов; агент вставляет блок в начало каждого шага |
| 0 | проверяет выделение и доступ к восьми атомам, снимает свойства, узнаёт старую документацию |
| 1 | создаёт секцию и оформляет её переменными библиотеки |
| 2 | «История изменений»: первая запись 1.0.0 или перенос старых записей и новая запись |
| 3 | «Спецификация»: лид, «Структура», аннотации |
| 4 | «Спецификация»: блоки свойств; у крупного компонента — в несколько вызовов |
| 5 | «❖ Компонент»: переносит набор, ставит имя, версию и подписи осей |
| 6 | подгоняет секцию под содержимое |
Первая версия скилла отдавала агенту один скрипт почти на 28 тысяч знаков. В Figma она не заработала. Эта версия переписана 22.10.2026 по образцу прошлого рабочего скилла.
Как добавить в команду Rossel
- Открыть файл Figma Design, который лежит в команде Rossel: опубликовать скилл в команду можно только из её файла.
- Чат агента → Skills → Add skill → загрузить
astra-ds-doc-build.md→ Add. - Manage skills → скилл → Publish → Private → команда Rossel.
- Новая версия файла — загрузить заново и нажать Publish changes.
Правила Figma — Custom skills for the Figma agent and Figma Make:
скилл — один .md по стандарту Agent Skills, папки references/ и scripts/ не поддерживаются.
Как проверить после правки
node check.mjs
Скрипт проверяет имя и описание во фронтматтере, длину файла (не больше 500 строк) и синтаксис каждого шага вместе с блоком Helpers.
Затем — прогон шагов через Figma MCP (use_figma) в песочнице aJofduPmuvIoKNoH1ikroj
на наборе «Tag Test»: Helpers + код шага, плейсхолдеры заменены на id из прошлых шагов.
22.10.2026 так пройдены все шаги 0–6 первой сборки, шаг 4 — в два вызова.