, HTML SVG

Мастерство запрашивает у Grok 4.5 суждение о дизайне через CLI в комплекте, а затем позволяет основному агенту решить, как применять советы в текущем рабочем пространстве.

##Установка

Самый простой способ - предоставить это хранилище GitHub агенту, такому как Codex, Claude Code или Cursor, и попросить его установить навык:

Вы также можете установить его прямо с терминала:

После установки агенты должны использовать навык grok-designer, когда задача нуждается во внешнем проектном решении.

Авторизация

CLI читает локальную конфигурацию из:

По умолчанию ключ API читается из:

Не фиксируйте API-ключи или локальные файлы конфигурации. Репозиторий игнорирует общие локальные секретные файлы, включая .env, config.toml и api_key.

Что нужно знать агентам

• Грок не имеет гражданства. Он видит только текущую подсказку, файлы, переданные -f, и изображения, переданные -i. Для визуального / пользовательского просмотра используйте grok-designer ui. Для UX, выбора компонентов, потока задач, взаимодействия, трения или обзора обратной связи с состоянием используйте grok-designer ux. Для комбинированного обзора UI + UX используйте grok-designer ui,ux или запустите ui и ux отдельно.

Grok Designer

委托外部设计顾问评审界面与交互，输出改进建议、视觉方向及 HTML、SVG 草稿。

The skill asks Grok 4.5 for design judgment through the bundled grok-designer CLI, then lets the main agent decide how to apply the advice in the current workspace.

Install

The easiest way is to give this GitHub repository to an agent such as Codex, Claude Code, or Cursor and ask it to install the skill:

https://github.com/oil-oil/grok-designer

You can also install it directly from a terminal:

npx skills add oil-oil/grok-designer

After installation, agents should use the grok-designer skill when a task needs external design judgment.

Authorization

The CLI reads local configuration from:

~/.config/grok-designer/config.toml

By default, the API key is read from:

~/.config/grok-designer/api_key

Do not commit API keys or local config files. The repository ignores common local secret files, including .env, config.toml, and api_key.

What Agents Should Know

• Grok is stateless. It only sees the current prompt, files passed with -f, and images passed with -i.
• For visual/UI review, use grok-designer ui.
• For UX, component-choice, task-flow, interaction, friction, or state-feedback review, use grok-designer ux.
• For combined UI + UX review, use grok-designer ui,ux or run ui and ux separately.
• For broad art direction or design imagery markdown, use grok-designer direction.
• For new standalone HTML mockups, use grok-designer html.
• For SVG icons, simple illustrations, and single handwritten wordmarks, use grok-designer svg.
• Pass complete relevant files when Grok needs to judge an existing design.
• Pass screenshots or visual references with -i when the visible result or state sequence matters.
• Do not ask Grok to patch project files directly. Use its advice, then apply the changes in the workspace.

CLI

可以直接使用 bundled 脚本；只有用户要求全局安装时才安装命令：

grok-designer

Typical examples:

grok-designer ui "给这个页面提视觉/UI设计建议" -f ./design.html -o design-page-ui.md
grok-designer ux "评审这个页面的任务流、交互摩擦和状态反馈" -f ./design.html -o design-page-ux.md
grok-designer ui,ux "同时从 UI 和 UX 角度评审这个标签编辑组件" -f ./TagEditor.tsx -o tag-editor-review.md
grok-designer direction "给这个产品生成设计意象 markdown" -o product-design-imagery.md
grok-designer html "生成一个完整的产品页面设计稿" -f ./brief.md -o ./designs/product-page.html
grok-designer svg "为 Museon 生成一个手写 SVG 字标" -o museon-wordmark.svg

Bare output filenames are saved under .grok-designer/ in the current workspace.

For multi-command markdown review, a single -o value is suffixed per command. For example, -o tag-editor-review.md writes tag-editor-review-ui.md and tag-editor-review-ux.md.

Repository Layout

SKILL.md
scripts/grok-designer
scripts/install_cli

SKILL.md tells agents when and how to use Grok. scripts/install_cli installs the CLI into the user’s local bin directory. scripts/grok-designer is the command agents call.