Перейти к руководству
penpot-uiux-designавтор GitHub

Penpot UI/UX Design Skill.

Skill для Claude Code и Codex в области UI-дизайна: профессиональный UI/UX-дизайн, компоненты и дизайн-системы в Penpot через MCP-инструменты.

  • Web и UI
  • Дизайн-файл
github/awesome-copilot · skills/penpot-uiux-design/SKILL.mdSKILL.md
--- name: penpot-uiux-design description: Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material … --- ## Available MCP Tools ## MCP Server Setup ## Core Design Principles ## Design Workflow ## Design System Handling ## Key Penpot API Gotchas
Преамбула и заголовки разделов прочитаны из исходного файла 14 сентября 2026 года · 12 103 символа в полном виде

01 Что делает

Что делает skill penpot-uiux-design в Claude Code и Codex

Сводка, рабочий процесс и результаты — всё прочитано из SKILL.md этого skill.

Из SKILL.mdПрочитано 14.09.2026 · не запись выполнения

Словами самого skill

Руководство по проектированию реальных интерфейсов в Penpot через сервер penpot/penpot-mcp, написанное для дизайнеров и разработчиков, чей агент управляет API плагина Penpot. Вместо общих советов оно задаёт рабочую последовательность: проверить, не запущен ли уже сервер MCP, определить существующие в файле цвета, текстовые стили и компоненты, изучить иерархию с помощью penpotUtils.shapeStructure, затем создать борды, прямоугольники и текст и применить контейнеры addFlexLayout.

Оно предоставляет запасные шкалы отступов 8px и типографики, мобильный макет 375x812 и дашборд-макет 1440x900, чек-листы для кнопок, форм и навигации, ограничения по контрасту WCAG и размеру области нажатия, отступы для размещения на бордах, подводные камни API Penpot, такие как read-only width и height, и валидацию через analyzeDescendants, фильтрацию fontSize и export_shape.

Что он выдаёт

  • Новые или изменённые дизайны Penpot, созданные с помощью JavaScript, выполняемого в контексте плагина.
  • Рендеры выбранных фигур в PNG или SVG, используемые для того, чтобы посмотреть на дизайн, а не угадывать его.
  • CSS, извлечённый из выделения, включая дочерние элементы, для передачи в разработку.
Смотрите пример запроса ↗

Как это работает

  1. 01
    Подтвердите, что сервер запущен

    Первый шаг — пробный вызов penpot_api_info, чтобы никого не заставляли проходить установку, если соединение уже работает.

  2. 02
    Найдите существующую дизайн-систему

    Перед тем как рисовать, он спрашивает о брендбуке и читает текущий файл на предмет уже используемых компонентов, цветов и паттернов.

  3. 03
    Изучите структуру страницы

    shapeStructure возвращает существующую иерархию, чтобы новые элементы можно было размещать относительно того, что уже есть на холсте.

  4. 04
    Создайте элементы

    Борды, прямоугольники и текст создаются с помощью вызовов плагина в контексте плагина Penpot, а не описываются словами.

  5. 05
    Проверьте результат экспортом

    Каждое изменение завершается экспортом, чтобы результат оценивался как изображение, а не принимался на веру из кода.

02 Определите своё применение

Когда использовать навык penpot-uiux-design

Используйте навык penpot-uiux-design в Claude Code или Codex, когда задача — UI-дизайн такого рода. Соответствие и ограничения ниже взяты из собственного файла навыка.

Хорошо подходит

  • Тому, кто начинает новый веб-, мобильный или десктопный интерфейс и хочет получить его как настоящий файл Penpot.
  • Настройке библиотеки компонентов и дизайн-токенов, которые будет использовать весь продукт.
  • Созданию типовых экранов продукта, таких как дашборды, формы, навигация и лендинги.
  • Аудиту или улучшению уже существующего файла Penpot, а не началу с чистого листа.
  • Работе, которая должна следовать соглашениям iOS, Android или Material Design.

Знайте границы

  • Он не может работать самостоятельно: локальный сервер MCP должен быть запущен, а UI плагина Penpot должен показывать статус подключён, иначе вызовы завершаются ошибкой или таймаутом.
  • Он применяется к дизайнам Penpot, созданным через сервер penpot-mcp, а не к другим инструментам дизайна.
  • Прохождение чек-листов не то же самое, что доказательство работоспособности дизайна; файл всё равно просит вас проверять предположения на реальных пользователях.

Что предоставить

  • Существующая дизайн-система или брендбук, если они у вас естьЛибо сообщите агенту свои токены и спецификации, либо позвольте ему обнаружить их в текущем файле до начала работы.
  • Иконки, фото или логотипыВизуальные ассеты добавляются в дизайн через инструмент импорта изображений.

03 Внутри скилла

Правила, которые Skill penpot-uiux-design задаёт Claude Code и Codex

8 конкретных инструкций, значений по умолчанию и ограничений, которые SKILL.md задаёт для агента — та часть файла, которая влияет на результат.

  1. Проверьте сервер перед установкой чего-либо

    Сначала попробуйте вызов инструмента и проходите настройку только после того, как пользователь подтвердит, что сервер не установлен.

  2. Никогда не размещайте борд поверх другого

    Перечислите существующие борды перед созданием нового и разместите новый борд за их правым краем плюс отступ, используя 100px между экранами в одном флоу и 200px+ между разными секциями.

  3. Изменяйте размер через методы, а не свойства

    width и height доступны только для чтения, поэтому изменения геометрии выполняются через shape.resize(w, h), а не прямым присваиванием.

  4. Упорядочивайте слои с помощью insertChild

    Порядок по оси Z задаётся через insertChild(index, shape); appendChild явно не подходит для упорядочивания слоёв.

  5. Токены по умолчанию — лишь запасной вариант

    Если у пользователя есть дизайн-система, приоритет за его цветами, отступами и типографикой; встроенные шкалы применяются только при их отсутствии.

  6. Соблюдайте минимальный порог доступности

    Контраст текста остаётся на уровне 4.5:1 для основного текста и 3:1 для крупного, а области касания никогда не опускаются ниже 44x44px.

  7. Ограничивайте палитру и гарнитуры

    Используйте 1 основной плюс 1 дополнительный цвет плюс нейтральные, и не более 1-2 гарнитур во всём дизайне.

  8. Сбрасывайте тип роста текста после изменения размера

    Penpot сбрасывает поведение изменения размера текста при ресайзе, поэтому growType нужно вернуть в auto-width или auto-height.

04 Применение

Установите penpot-uiux-design в Claude Code или Codex

Одна команда npx skills add, затем первая задача в вашем агенте и чек-лист для результата.

Добавьте penpot-uiux-design в Claude Code, Codex или ваш агент

Запустите в своём проекте; установщик спросит, какому агенту его добавить.

Terminal
npx skills add https://github.com/github/awesome-copilot --skill penpot-uiux-design

Общая форма CLI skills для skills/penpot-uiux-design/SKILL.md; репозиторий может документировать свой собственный путь.

Дайте skill первую задачу по дизайну интерфейса

Написано в терминах самого skill; замените части в квадратных скобках своим материалом.

Starter prompt
Design a settings screen for [app name] in Penpot on a 375x812 board. Follow the Material Design guidelines and use our existing tokens if the file already has them, otherwise use the 8px spacing scale. It needs a header, a form with labels above the inputs plus error states, and a bottom CTA. Export the screen when you are done so I can check the contrast.

Источник: составлено по SKILL.md в терминах самого skill.

Проверьте первый результат

Что сам SKILL.md считает правильным результатом:

  • Каждый элемент находится внутри своего контейнера, что проверяется через analyzeDescendants в сочетании с isContainedIn.
  • Ни один текст не опускается ниже 12px, что определяется фильтрацией фигур по fontSize.
  • Цветовой контраст соответствует WCAG AA ещё до того, как дизайн считается финальным.
  • Вложенность и иерархия проверяются с помощью shapeStructure.
  • Типографика основного текста остаётся не менее 16px.
  • Учитываются состояния загрузки, пустоты и ошибки, а не только основной сценарий.

В OpenDesign импортируйте penpot-uiux-design по ссылке из его SKILL.md: Plugins → Add → Skill → Import from link, затем выберите его в верхней панели.

05 Открытый исходный код, проверяемость

Источник, лицензия и проверка

Откуда взяты факты на этой странице и когда они были последний раз проверены.

Author
GitHub
Repository
github.com/github/awesome-copilot Ветка main
Файл skill
skills/penpot-uiux-design/SKILL.md Контрольная сумма содержимого зафиксирована при проверке; коммит 1899b18
License
MIT Из LICENSE.
Звёзды репозитория
38 981 Снимок GitHub сделан 14.09.2026 для всего репозитория github/awesome-copilot, который содержит 6 скиллов в этом каталоге. Не является рейтингом или счётчиком использования penpot-uiux-design.
Проверено OpenDesign
2026-09-14 Исходный файл, путь, текст лицензии и количество звезд были проверены. Не входит в основной комплект OpenDesign (проверено 2026-08-28); живой запуск не был записан на этой странице.

Внутри SKILL.md

  1. Доступные MCP-инструментыЧетыре инструмента с назначением: выполнить код, экспортировать фигуры, импортировать изображения, получить документацию Penpot API.
  2. Настройка MCP-сервераСначала проверьте, запущен ли он, затем клонируйте, соберите, загрузите URL плагина, настройте VS Code, устраните проблемы.
  3. Основные принципы дизайнаЗолотые правила ясности и согласованности, а также порядок приоритетов пятиэтапной визуальной иерархии.
  4. Рабочий процесс дизайнаУпорядоченные шаги от проверки дизайн-системы через инспекцию, создание, флекс-раскладку до визуальной проверки.
  5. Работа с дизайн-системойУточните или обнаружьте токены, цвета, текстовые стили и компоненты, затем действуйте по ответу.
  6. Ключевые особенности Penpot APIГеометрия только для чтения, insertChild для z-порядка, обратный порядок flex, сброс growType после изменения размера текста.
  7. Позиционирование новых бордовНайдите существующие борды, вычислите следующее x от крайнего правого края, держите потоки визуально сгруппированными.
  8. Дефолтные токены дизайнаРезервная шкала отступов 8px, шкала типографики и семантические цветовые роли для дизайнов без системы.
  9. Чек-лист компонентовТребования-чекбоксы для кнопок, форм и навигации, включая состояния, размеры и подписи.
  10. Быстрые проверки доступностиШесть проверок: контраст, зоны касания, фокус, alt-текст, иерархия заголовков, независимость от цвета.
  11. Чек-лист ревью дизайнаПредфинальные проверки иерархии, отступов, типографики, WCAG AA, состояний и согласованности с системой.
  12. Валидация дизайновТаблица методов валидации плюс экспорт CSS из выделения с помощью generateStyle.
Собственное описание skill
«Исчерпывающее руководство по созданию профессионального UI/UX-дизайна в Penpot с помощью инструментов MCP. Используйте этот навык, когда: (1) Создаёте новый UI/UX-дизайн для веб-, мобильных или десктопных приложений, (2) Строите дизайн-системы с компонентами и token, (3) Проектируете дашборды, формы, навигацию или лендинги, (4) Применяете стандарты доступности и лучшие практики, (5) Следуете руководствам платформ (iOS, Android, Material Design), (6) Проверяете или улучшаете существующий дизайн Penpot на удобство использования. Триггеры: „дизайн UI", „создать интерфейс", „построить макет", „дизайн дашборда", „создать форму", „дизайн лендинга", „сделать доступным", „дизайн-система", „библиотека компонентов".»

Описание из front-matter файла SKILL.md. Весь файл составляет около 12 103 символов. Читайте полный файл на GitHub.

06 Перед установкой

Вопросы о skill penpot-uiux-design

Ответы взяты из SKILL.md в редакции от 2026-09-14, а не из записанного запуска.

Нужно ли устанавливать MCP-сервер Penpot перед использованием?

Нет, и skill намеренно проверяет это первым делом, вызывая penpot_api_info. Инструкции по установке появляются только после того, как подтверждено, что сервер не установлен, после чего настройка клонирует penpot-mcp, запускает npm install и npm run bootstrap, затем загружает плагин с http://localhost:4400/manifest.json в Penpot.

Какой клиент он настраивает?

В разделе настройки показан фрагмент settings.json для VS Code, регистрирующий сервер penpot по адресу http://localhost:4401/sse. Также указано, что инструменты могут не появиться, пока вы не полностью перезапустите VS Code или Claude после изменения конфигурации.

Penpot UI/UX Design

Запустите penpot-uiux-design на реальной задаче по дизайну интерфейса.

Загрузите OpenDesign, импортируйте penpot-uiux-design по ссылке на его SKILL.md, вставьте запрос выше и прочитайте план перед результатом.

Терминал
npx skills add https://github.com/github/awesome-copilot --skill penpot-uiux-design

OpenDesign для компьютера

Одна дизайн-система. Единый образ бренда во всех материалах

В полном Vibe Design Workspace одни и те же правила бренда работают для сайтов, слайдов, интерактивных прототипов, дашбордов, изображений и HTML-видео. Подключите локальные Codex, Claude Code, Cursor и другие кодинг-агенты и создавайте бесплатно.

  • Сайты, слайды, прототипы, дашборды, изображения и видео
  • Более 140 дизайн-систем и полная библиотека шаблонов и навыков
  • Локальный Codex и более 21 кодинг-агента · Бесплатно
Скачать бесплатно

Для macOS и Windows