К основному содержанию
скилл CX Codex

ns-proto-visual-guide — скилл для Claude Code: визуальные гайды

Скилл ns-proto-visual-guide для Claude Code помогает описывать внешний вид карточек, форм, оболочек и оверлеев. Включается для нормативного визуального гайда или чек-листа визуальной проверки.

Apache-2.0 106 установок обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add nextstage-brasil/skills --skill ns-proto-visual-guide -a claude-code
Открыть на GitHub

Что делает ns-proto-visual-guide

Скилл помогает составить нормативный гайд о том, как должна выглядеть конкретная поверхность интерфейса: карточка, форма, оболочка или оверлей. Он отделяет визуальное описание от бизнес-правил и расчётов раскладки, задаёт порядок разделов и предлагает таблицы для элементов и их состояний.

Перед подготовкой гайда нужно изучить исходные компоненты и соседние документы того же типа, затем выбрать подходящий пример из examples/. Гайд связывается с индексом документации и родственными страницами; чек-лист должен содержать пункты, проверяемые по отрисованному интерфейсу или DOM. Скилл зависит от ns-harness и ns-living-spec.

Если гайд описывает поведенческий UX, скилл подключает режим appearance у ns-living-spec; для одной лишь визуальной полировки этот шаг пропускается. При наличии prototype/ он служит источником правды вместо старых деревьев приложения, если пользователь не указал другое.

Какие задачи решает

  • описать порядок блоков и состояния карточки
  • разделить визуальные требования к форме и оболочке
  • составить проверяемый чек-лист визуального QA
  • связать гайд с примерами и соседней документацией

Примеры запросов агенту

  • Составь нормативный визуальный гайд для формы настроек.
  • Опиши, как должна выглядеть карточка, и добавь проверяемый чек-лист.
  • Раздели требования к оболочке панели и содержимому формы.

Как установить ns-proto-visual-guide

1Через Skills CLI (Vercel)

npx skills add nextstage-brasil/skills --skill ns-proto-visual-guide -a claude-code

2Вручную: положить файлы

~/.claude/skills/ns-proto-visual-guide/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ns-proto-visual-guide/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о ns-proto-visual-guide

Как установить ns-proto-visual-guide в Claude Code?

Выполни npx skills add nextstage-brasil/skills --skill ns-proto-visual-guide -a claude-code. Файл скилла находится по пути ~/.claude/skills/ns-proto-visual-guide/SKILL.md.

Что делает ns-proto-visual-guide?

Он помогает создавать нормативные описания внешнего вида отдельных поверхностей интерфейса: карточек, форм, оболочек и оверлеев. Гайд включает структуру, состояния и проверяемый визуальный чек-лист.

Что нужно для работы ns-proto-visual-guide?

Скилл зависит от ns-harness и ns-living-spec. Для описания поведенческого UX он использует режим appearance у ns-living-spec.

Исходный текст

SKILL.md · Apache-2.0
---
name: ns-proto-visual-guide
description: "(NS) Normative visual appearance guides (card/form/shell/overlay). MUST use for descrição normativa, guia visual, aparência, visual QA checklist, \"how this looks\", *-visual.md / *-painel-visual.md / *-appearance.md, or shell vs content / card vs form / carcaça vs formulário. Do NOT use for business rules, ERDs, layout math, API/auth, e2e, or ns-proto-creator."
license: Apache-2.0
metadata:
  author: nextstage-brasil
  version: "1.1"
depends:
  - ns-harness
  - ns-living-spec
---

# Normative visual description

Normative guides: **how UI surface must look** — not how implemented. Audience: design, product, visual QA. Need block order, hierarchy, states, sibling consistency.

Project-agnostic. Canonical specimens: [examples/](examples/README.md).

Guide language = project docs language (often English; follow repo). Section intent identical even when localizing headings.

When `prototype/` exists, prefer its components as **source of truth** over legacy app trees unless user points elsewhere. Cite `prototype/` paths in source-of-truth table.

## Instructions

1. **Name surface** — card / form / shell / overlay; match project doc language.
2. **Read before write** — open source components (prefer `prototype/`) + sibling docs same surface type. Invent absent UI → QA trust break.
3. **Load specimen** — one matching file under [examples/](examples/README.md); mirror tone, section density, table style.
4. **Boundary first** — write **Does not cover** (links to siblings) before body. Unscoped guides swallow business rules + layout math.
5. **Draft from template** — keep section order; prefer `Element | How it should appear` tables over long prose.
6. **Wire graph** — update docs index + cross-links (card ↔ form ↔ shell ↔ layout). Orphans never reviewed.
7. **Stay honest** — document what code shows today; desired look differs → say explicit.
8. **Living specs (when needed)** — guide documents product-visible behavioral UX (not pure chrome polish) → invoke `ns-living-spec` **appearance** mode with guide path + short behavioral delta. Skip polish-only.

### Why these constraints

| Constraint | Reason |
|------------|--------|
| Normative voice ("must" / "should") | Validation checklists need pass/fail, not narrative |
| Visual form only | Deep domain in product/spec docs; mix kills scanability |
| One file = one surface | Card and form answer different questions |
| Code as source of truth | Specs drift from components → decoration |
| Full states | Empty, overflow, disabled, warning, conditional visibility — where QA fails |
| Behavior as `Action \| What changes on screen` | Ties interaction to visible change; no hooks/state story |

## Output template

ALWAYS structure new guides like this (adapt titles; keep opening contract):

```markdown
# [Surface] — appearance [on the canvas / in the side panel / on screen]

Normative guide for **how [surface] must appear** in [context]: [short scope].

For design, product, and visual validation. **Does not describe** [explicit limits].

**Does not cover:**
- [Item] — see [sibling doc link]

**Source of truth in code:**
| File | Responsibility |

**Related documents:**
- [links]

---

## What it is
[1–3 short paragraphs: role, read-only vs editable, relation to siblings]

## What it [does not show / does not cover in the body]  ← optional; useful for forms
| Absent section | Reason |

## Overview — block order
[ASCII of vertical/horizontal structure]

### [Modes / branches]  ← when mutually exclusive modes exist
| State | Body shown |
[mermaid if it clarifies branching]

## [Block / section name]
| Element | How it should appear |

## Palette and style
| Element | Appearance |

## Expected visual behavior
| User action | What changes on screen |

## Quick visual checklist
- [ ] ...
```

**Checklist rule:** each item **verifiable** by inspecting rendered surface or DOM — no aesthetic judgement. Good: `Dismiss control present in header, aligned to trailing edge`. Bad: `Header looks balanced`.

### Optional sections (when surface needs)

- **What it does not show** — contrast sibling surface (e.g. child item vs top-level)
- **Modes** — normal/variant; edit vs follow-along
- **Selection and hover** — container states
- **Handles / anchors** — graph cards

## Surface types

| Type | Doc focus | Keep out |
|------|-----------|----------|
| Canvas card | Zones, RO content, badges, handles, create buttons | Panel form fields; layout formulas |
| Panel form | Field order, toggles, empty states, modes | Shell chrome; canvas card chrome |
| Shell | Fixed chrome (width, header, scroll) | Per-selection form bodies |
| Technical layout | Grid, gaps, resize | Visual appearance (sibling normative doc) |

One file = one surface.

## Anti-patterns

- Mix shell with content, or card with form — reviewers cannot tell which surface failed
- Paste long domain rules into visual guide — link; no dump
- Describe implementation (`useState`, class names as story) instead of appearance
- Skip empty states, warnings, conditional visibility
- Publish without index entry or cross-links
- Replace normative guide with summary matrix (matrix points *to* guide)
- Cite `vN/prototype/` as layout — product has one `prototype/` tree; versioning = git

## Examples

Before draft, open specimen for surface:

| Intent | Read first |
|--------|------------|
| Canvas card | [examples/card-canvas.md](examples/card-canvas.md) |
| Panel form | [examples/form-panel.md](examples/form-panel.md) |
| Panel chrome only | [examples/shell-panel.md](examples/shell-panel.md) |

Naming + publish checklist: [examples/README.md](examples/README.md).

## Related skills

- `ns-proto-creator` — capture live UI; create/evolve single `prototype/` tree
- `ns-living-spec` — **appearance** mode after behavioral UX documented

© nextstage-brasil · Apache-2.0 · nextstage-brasil/skills

Похожие скиллы

Все скиллы по теме «Дизайн» →
proto-persona deanpeters Скилл proto-persona собирает рабочий профиль целевого пользователя из исследований, рыночных сигналов и знаний команды. Пригодится на раннем этапе, когда нужно согласовать гипотезу до углублённой проверки. CX Codex +1 2 400установок visual-verdict Yeachan-Heo Скилл visual-verdict сравнивает полученный скриншот интерфейса с референсными изображениями и возвращает JSON-вердикт для следующей итерации правок. CX Codex +1 978установок visual-qa-evaluator ShuaiMXu Скилл visual-qa-evaluator для Claude Code готовит артефакты для оценки изменений интерфейса и поиска визуальных регрессий. Работает при сравнении скриншотов до и после правок. CX Codex +1 ★ 529звёзд репо visual-hierarchy-reviewer ShuaiMXu Скилл visual-hierarchy-reviewer для Claude Code проверяет иерархию задач и визуальный язык интерфейса по скриншотам. Он включается при разборе дизайна или просьбе убрать ощущение «сгенерированного ИИ», сохранив стиль продукта. CX Codex +1 ★ 529звёзд репо ui-visual-validator Seth Hobson Субагент ui-visual-validator для Claude Code проверяет визуальные изменения интерфейса, дизайн-систему и доступность. Подключается для анализа скриншотов и проверки UI после правок. CX Codex ★ 42 780звёзд репо qc-visual genspark-ai Промпт qc-visual находит и исправляет дефекты вёрстки на слайде по скриншоту и геометрии элементов. Промпт выравнивает блоки без изменения текста и шрифтов. GP ChatGPT ★ 12 746звёзд репо

Из того же набора20

Весь набор →
ns-autonomous Скилл ns-autonomous для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который берёт локальный план или произвольный текст и выполняет его автономно в изолированном worktree. CX Codex +1 152установок ns-e2e-tests Скилл ns-e2e-tests задаёт структуру Cypress E2E-тестов, команд и сценариев для разных устройств. Нужен при создании и рефакторинге тестов. CX Codex +1 151установок ns-backend-tests Скилл ns-backend-tests для написания и запуска unit- и интеграционных тестов PHPUnit прямо в IDE. Работает только в Docker-контейнере, помогает быстро покрыть тестами новый Laravel-проект или переписать существующие тесты. CX Codex +1 151установок ns-docs-writer Скилл ns-docs-writer для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который пишет человекочитаемую документацию проекта: README, руководства в docs/, ранбуки и инструкции для контрибьюторов. CX Codex +1 151установок ns-coder Скилл ns-coder реализует небольшие изменения в коде: исправления, рефакторинг, скрипты и миграции. Он пригодится для разовой задачи вне многоэтапной разработки по SDD. CX Codex +1 151установок ns-reviewer Скилл ns-reviewer проверяет качество кода перед PR: оценивает SOLID, чистоту кода, производительность, безопасность и тестируемость. Одобрит только при оценке 10, оценка 9 означает отклонение. CX Codex +1 140установок ns-living-spec Скилл ns-living-spec синхронизирует спецификации проекта в каталоге docs/specs/ с кодом. Обновляет доменные требования после закрытия версий или подтверждённых ревью. CX Codex +1 140установок ns-proto-creator Скилл ns-proto-creator для Claude Code, который снимает интерфейс через Playwright и создаёт или развивает прототип. Запускается для прототипирования по URL, разбора экранов и правок существующего prototype/. CX Codex +1 106установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой