@electra-ui/ai-skills
v1.2.0
Published
AI skills (Markdown instructions + component catalog) for coding with Electra UI library. Includes the electra-ui-assistant skill with workspace (live sources) and package (bundled catalog) modes.
Readme
@electra-ui/ai-skills
Набор AI-скиллов (markdown-инструкции + каталог компонентов) для разработки с библиотекой
Electra UI. Включает скилл electra-ui-assistant — помощник при написании Angular-кода
(подбор компонента, точный API, примеры, иконки, конвенции).
EN: AI skill bundle for coding with the Electra UI library. Ships the
electra-ui-assistantskill (component selection, exact API, examples, icons, conventions) plus a data catalog.
Установка / Install
npm i @electra-ui/ai-skillsПакет публикуется в SourceCraft npm registry. Если scope @electra-ui ещё не настроен, задайте registry
и выполните аутентификацию по правилам вашей организации перед установкой:
@electra-ui:registry=https://pkg.sourcecraft.tech/npm/electra/cn1blv1rg6p7hgcjh01uСкилл ставится в клиент командой:
npx @electra-ui/ai-skills install opencode # → .opencode/skills/electra-ui-assistant
npx @electra-ui/ai-skills install claude # → .claude/skills/electra-ui-assistant
npx @electra-ui/ai-skills install codeassistant # → .codeassistant/skills/electra-ui-assistant
npx @electra-ui/ai-skills install agents # → .agents/skills/electra-ui-assistant
npx @electra-ui/ai-skills install --all # → во все четыре каталогаФлаг --force перезаписывает существующую папку скилла.
В package-режиме каталог catalog/*.json устанавливается рядом с SKILL.md.
Режимы данных / Data modes
Скилл работает в одном из двух режимов (переменная окружения ELECTRA_SKILL_MODE):
| Режим | Когда | Что читает |
|---|---|---|
| workspace (по умолчанию, если найден nx.json) | внутри монорепозитория Electra / рядом с исходниками | живые исходники libs/components, apps/doc, apps/test-stand |
| package | у конечного пользователя, где только установленные npm-пакеты | каталог catalog/*.json, распространяемый в этом пакете |
Авто-детект: если в текущем каталоге (или выше по дереву) найден nx.json — workspace, иначе — package.
Явное корректное значение (workspace или package) имеет приоритет; любое другое значение завершится ошибкой.
Каталог / Catalog
Каталог генерируется при сборке пакета (nx run ai-skills:build) из исходников монорепозитория:
catalog/components.json— реальные Angular selectors/kinds, public exports, NgModule exports и effective inputs/outputs;catalog/examples.json— doc route → setup + примеры с relative paths и текстом файлов;catalog/icons.json— точные записи из MeIcons, Electra SVG catalog и двух legacy font registries;catalog/families.json— broad component categories, не task-to-component recommendations.
В workspace-режиме каталог не используется: агент читает живые файлы репозитория.
TODO: публичный хостинг документации
Сейчас публичного хостинга doc-сайта нет, поэтому в references скилла ссылки на
https://e.monitel.com отсутствуют и примеры в package-режиме берутся из catalog/examples.json.
Когда появится публичный хостинг — добавить URL-ссылки на страницы компонентов
во всех reference (component-api.md, docs-and-examples.md, icons.md).
Разработка / Development
nx run ai-skills:lint
nx run ai-skills:test
nx run ai-skills:build # compile + generate-catalog
nx run ai-skills:package-smoke # pack + install в изолированный проект + проверка CLI/catalogЛокальная актуализация скилла в клиентских каталогах (не коммитится):
node libs/ai-skills/scripts/sync-clients.mjsLicense
Apache-2.0
Поддержка и развитие
Дружинин Михаил
