Скиллы

Источник: папки скиллов в ds-docs/src/skills/, ds-docs/component-contracts/skills/, ds-skills/, ds-internal/presentations/component-video-skill/

Скилл — инструкция для нейросети на одну задачу: что прочитать, в каком порядке действовать, что проверить. Здесь шесть скиллов Astra DS. Страница скилла — его файл SKILL.md, вложенные страницы — справочники. Тексты выложены как есть, без правок.

Что есть


astra-figma-to-md	разбирает секцию документации компонента в Figma и пишет markdown-документ: дерево слоёв, свойства, токены	Figma MCP; скрипты `fetch-details.js`, `section-summary.py`
astra-component-contract	читает компонент из Figma и пишет его контракт — YAML-файл `components/<slug>.yaml`	Figma MCP; скрипты `contract.mjs`, `figma-read.js`
astra-contract-to-figma	собирает компонент по контракту на тестовой странице Figma и сравнивает с оригиналом	Figma MCP с правом записи; скрипты `render.js`, `compare.js`
astra-figma-doc-build	собирает документацию компонента в Figma по шаблону `ds-component`: три страницы	Figma MCP с правом записи, библиотека «Astra DS: Docs». Пошаговый код — в рецептах; короткий путь через `plugin/core.js` — только из репозитория. Без нейросети — плагин
build-core-ui-components	пишет React-компонент библиотеки core-ui по контракту или макету: код, стили, Storybook, тесты	репозиторий core-ui
astra-component-video	собирает ролик 4:3 о доработке компонента, видео-презентацию или ролик с голосом	пакет `astra-component-video.zip` с шаблоном и инструментами; Node, Python, ffmpeg

Скиллы работают цепочкой: компонент в Figma → контракт (astra-component-contract) → проверка контракта обратной сборкой (astra-contract-to-figma) → код core-ui (build-core-ui-components). Документацию в Figma собирает astra-figma-doc-build, в markdown её переносит astra-figma-to-md.

Как взять скилл в свою нейросеть


Claude Code, Codex CLI и другие агенты со скиллами	взять папку скилла из репозитория `astra-doc` целиком — путь в первой строке страницы скилла. Положить в `~/.claude/skills/<имя>/` или `~/.codex/skills/<имя>/`	скилл работает полностью, со скриптами
Агент, подключённый к вики	написать: «Прочитай страницу /wiki/astra-ds/<номер> и все вложенные, работай по ним»	работают шаги без скриптов
Чат без инструментов: ChatGPT, Qwen в браузере	скопировать в чат текст страницы скилла и нужных справочников	совет и проверка по правилам; в Figma и в коде чат ничего не сделает

У ролика вместо папки берётся архив ds-internal/presentations/component-video-skill/dist/astra-component-video.zip: в папке скилла нет шаблона.

Что учесть

Скиллы написаны под Claude Code. В них встречаются его инструменты: use_figma, get_metadata, download_assets, скилл figma-use. У другой нейросети они называются иначе. Смысл шага тот же: нужен инструмент, который делает то же действие. Нет такого — нейросеть должна остановиться и сказать, чего не хватает.
Скрипты в вики не выложены. На странице каждого скилла перечислено, каких файлов нет и где они лежат.
Источник правды — репозиторий astra-doc. Страницы — копия на 26.10.2026: правка в репозитории в вики сама не попадёт.