designer-notes — плагин для Claude Code: что делает и как установить
Плагин designer-notes для Claude Code переносит разметку интерфейса в браузер: позволяет комментировать блоки и редактировать текст на странице, а затем передавать правки в Claude Code.
MIT ★ 7 обновлён 2026-04-27
/plugin marketplace add anthropics/claude-plugins-community
/plugin install designer-notes@claude-communityЧто делает designer-notes
Плагин запускает локальный dev-сервер и добавляет скрипт разметки в HTML-страницы проекта. В браузере появляется интерфейс с плавающими кнопками, где можно кликать по элементам и оставлять замечания как в Figma. Клавиша C включает режим комментирования, а клавиша T переводит в режим редактирования текста на месте.
Каждая заметка привязывается к CSS-селектору, координатам клика и текущему разрешению окна. Все отзывы плагин автоматически сохраняет в структурированный markdown-файл вида feedback-YYYY-MM-DD.md. В комментариях поддерживаются директивы моделей (#opus, #sonnet, #haiku) и уровни усилий (#high-effort, #medium-effort, #low-effort).
Для запуска dev-сервера обязательно потребуется Node.js версии 14 или выше. После вызова команды /submit-feedback агент считывает накопленный markdown-файл и правит исходный код, очищая разметку для следующей итерации.
Какие задачи решает
- оставить визуальные правки к элементам в браузере
- отредактировать текст на странице без ручной правки шаблонов
- собрать список доработок интерфейса в единый markdown-файл
- передать пачку правок интерфейса ассистенту через команду
/submit-feedback
Примеры запросов агенту
- Запусти разметку страницы через
/designer-notes - Примени все оставленные комментарии командой
/submit-feedback
Как установить designer-notes
Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install designer-notes@claude-communityПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о designer-notes
Как установить designer-notes в Claude Code?
Добавьте каталог сообщества командой /plugin marketplace add anthropics/claude-plugins-community, затем установите плагин через /plugin install designer-notes@claude-community.
Что делает плагин designer-notes?
Он внедряет скрипт в HTML-файлы и поднимает локальный сервер. Это позволяет крепить пины с комментариями к элементам и вносить правки прямо в браузере, после чего Claude Code применяет изменения в коде.
Какие системные требования нужны для работы плагина?
Нужен установленный Node.js версии 14 или новее для локального dev-сервера и любой современный веб-браузер.
Исходный текст
SKILL.md · MIT
# designer-notes Pin comments to HTML elements, just like Figma. Then hand off to Claude Code, Cursor, or Codex to apply the changes. Learn more at [arturnbull.github.io/designer-notes-landing-page](https://arturnbull.github.io/designer-notes-landing-page/) ## Install ### Claude Code ```bash npx designer-notes ``` This installs two Claude Code skills and the tool files to `~/.claude/skills/`. ### Cursor (experimental) ```bash npx designer-notes --cursor ``` This installs tool files to `~/.cursor/designer-notes/` and slash commands to your project's `.cursor/commands/` directory. Cursor support is experimental — the core commenting workflow works, but Claude Code-specific features (model directives, skill invocations, parallel processing) are not available. ### Codex CLI (experimental) ```bash npx designer-notes --codex ``` This installs skill files to `~/.agents/skills/` for use with OpenAI's Codex CLI. Codex support is experimental — setup runs inline from the skill prompt (no hooks), and model directives map to OpenAI models (`#o3`, `#gpt-4o`, `#o4-mini`). ### Update ```bash npx designer-notes@latest --force ``` ## Quick start 1. Open Claude Code in any project with HTML files 2. Run `/designer-notes` — it adds the script and starts the dev server 3. Press **C** to comment on elements, or **T** to edit text directly 4. Run `/submit-feedback` — Claude reads your feedback and edits the code ## What it does **designer-notes** is a browser-based commenting tool for reviewing AI-generated UI. It gives you a Figma-like workflow for leaving design feedback directly on rendered HTML pages. Every comment is saved with its CSS selector and click position into a structured markdown file. When you run `/submit-feedback`, Claude reads that file and applies each change to the source code. ### Features - **Pin notes to any element** — click a heading, button, or card to attach feedback - **Inline text editing** — click any text element to edit it directly in the browser, Figma-style. Before/after changes are exported as structured diffs and applied automatically - **Batch reviews** — leave all your notes first, submit once - **Slash commands** — use your environment's existing Claude skills - **Model directives** — use `#opus`, `#sonnet`, or `#haiku` per comment - **Effort directives** — use `#high-effort`, `#medium-effort`, or `#low-effort` - **Auto-save** — comments and text edits persist and export to markdown automatically - **Viewport tracking** — feedback includes window size so changes target the right breakpoint - **Changelog** — cumulative HTML changelog generated after each feedback round ### Keyboard shortcuts | Key | Action | |-----|--------| | `C` | Toggle comment mode | | `T` | Toggle text edit mode | | `⌘\` | Open / close sidepanel | | `⌘.` | Show / hide all UI | ## Manual install If you don't have npm, download the files directly: ```bash mkdir -p ~/.claude/skills/designer-notes ~/.claude/skills/submit-feedback # Tool files curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/designer-notes.js \ -o ~/.claude/skills/designer-notes/designer-notes.js curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/serve.js \ -o ~/.claude/skills/designer-notes/serve.js curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/changelog-template.html \ -o ~/.claude/skills/designer-notes/changelog-template.html # Skill files curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/skills/designer-notes/SKILL.md \ -o ~/.claude/skills/designer-notes/SKILL.md curl -fsSL https://raw.githubusercontent.com/arturnbull/designer-notes/main/skills/submit-feedback/SKILL.md \ -o ~/.claude/skills/submit-feedback/SKILL.md ``` Then restart Claude Code. ## How it works 1. `/designer-notes` adds a `<script>` tag to your HTML and starts a local dev server 2. The server auto-finds an open port (defaults to 3847, increments if in use) 3. Three floating buttons appear in the bottom-right: text edit (pencil), comment (speech bubble), and panel (ellipsis) 4. Press **C** to enter comment mode — click elements to place numbered pins and type feedback 5. Press **T** to enter text edit mode — click any text element to edit it inline. Accept with Enter, dismiss with Esc. Re-editing the same element updates the existing entry 6. Use `/skills` and `#directives` in comment popovers for advanced control 7. All feedback auto-saves to `feedback-YYYY-MM-DD.md` in your project directory 8. `/submit-feedback` parses the markdown, locates each element in source, and applies changes. Text edits are applied via haiku for speed 9. After changes are applied, the browser clears automatically for the next review round ## Requirements - [Claude Code](https://claude.ai/code), [Cursor](https://cursor.com), or [Codex CLI](https://github.com/openai/codex) - Node.js 14+ (for the dev server) - Any modern browser ## Uninstall Claude Code: ```bash rm -rf ~/.claude/skills/designer-notes ~/.claude/skills/submit-feedback ``` Cursor: ```bash rm -rf ~/.cursor/designer-notes rm .cursor/commands/designer-notes.md .cursor/commands/submit-feedback.md ``` Codex: ```bash rm -rf ~/.agents/skills/designer-notes ~/.agents/skills/submit-feedback ``` ## Links - [Landing page](https://arturnbull.github.io/designer-notes-landing-page/) - [GitHub](https://github.com/arturnbull/designer-notes) - [npm](https://www.npmjs.com/package/designer-notes) ## License MIT
© arturnbull · MIT · arturnbull/designer-notes