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

design-it — скилл для Claude Code: HTML-дизайн-доки

Скилл design-it для Claude Code превращает требования и спецификации в единый HTML-документ по фиксированному шаблону. Оформляет повторяемые технические дизайн-документы.

MIT 170 установок ★ 302 обновлён 2026-09-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add smallnest/goal-workflow --skill design-it -a claude-code
Открыть на GitHub

Что делает design-it

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

В документ также входят блоки кода, SQL и YAML, выноски для замечаний, статусы в виде CSS-классов и журнал изменений. Файл сохраняется в docs/<имя требования>.html, а ссылки оглавления сверяются с id секций. Перед заполнением нужно прочитать требование и кодовую базу: file:line, имена таблиц и protoIds нельзя придумывать, неизвестные значения помечаются как 待确认.

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

  • оформить спецификацию как единый HTML-файл
  • собрать оглавление и секции дизайн-документа
  • добавить архитектурную и последовательностную SVG-диаграммы
  • вынести SQL, YAML и код в форматированные блоки
  • сверить ссылки оглавления с id секций

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

  • Преврати эту спецификацию в дизайн-документ по шаблону template.html и сохрани его в docs/<имя требования>.html.
  • Прочитай кодовую базу, добавь архитектурную и последовательностную SVG-диаграммы, тест-кейсы и индекс кода.
  • Проверь, что каждый href в оглавлении соответствует секции, а неизвестные file:line помечены как 待确认.

Как установить design-it

1Через Skills CLI (Vercel)

npx skills add smallnest/goal-workflow --skill design-it -a claude-code

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

~/.claude/skills/design-it/SKILL.md

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

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

Вопросы о design-it

Как установить design-it в Claude Code?

Выполните npx skills add smallnest/goal-workflow --skill design-it -a claude-code, затем проверьте файл ~/.claude/skills/design-it/SKILL.md.

Что делает design-it?

Скилл создаёт самодостаточный HTML-документ технического дизайна по фиксированной структуре и стилю. В него можно включить диаграммы, блоки кода, тесты и индекс кода.

Что делать, если идентификатор или позиция в коде неизвестны?

Сначала нужно прочитать требование и кодовую базу. Неизвестные значения помечаются 待确认, а не заменяются предположениями.

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

SKILL.md · MIT
---
name: design-it
description: Use when turning a requirement, spec, or feature brief into a single self-contained HTML design document in a fixed house style — one styled HTML page with a table-of-contents, architecture/sequence SVG diagrams, code/SQL/YAML blocks, callout boxes, an aligned-decisions (已对齐结论) panel, test cases, and a code index. Reuse for any new 需求/设计文档 that should look identical every time.
---

# design-it

## Overview

Generate a technical design document as **one self-contained HTML file** in a fixed house style, so every new 需求 produces a visually identical page. The look is not improvised each time — it comes from a fixed `<style>` block and a fixed section skeleton. Your job is to fill content into that skeleton, never to redesign it.

**Core principle:** Copy `template.html` verbatim, then replace only the content. Keep the `<style>` block byte-for-byte. Consistency comes from *not* touching the design system.

## When to Use

- The user gives a new requirement / spec / feature and wants a design doc.
- Converting a `.md` technical spec into the shareable HTML form.
- Any request like "生成同样的 html / 用这套模板 / 出一份设计文档".

**When NOT to use:** quick throwaway notes, a real Markdown deliverable the user wants to stay Markdown, or slide decks.

## Workflow

1. **Copy the template.** Start from `template.html` in this skill's directory. Do not hand-roll the `<head>`/`<style>` — copy it whole.
2. **Gather real content first.** Section titles, field names, SQL, `file:line` code positions, protoIds — all must come from the actual requirement doc and codebase. Read the code; do not invent identifiers. If a fact is unknown, mark it `<span class="pill todo">待确认</span>`, never guess.
3. **Fill the skeleton.** Rename/reorder `<section>`s to fit the feature. Keep the section *kinds*: 已对齐结论 → 业务规则 → 架构图 → 时序 → 数据模型 → 契约 → 清单 → 幂等降级 → 测试用例 → 代码索引 → 变更记录. Drop what doesn't apply; add feature-specific ones in the same style.
4. **Keep TOC and sections in sync.** Every `<a href="#x">` needs a matching `<section id="x">`, and vice versa. This is the #1 breakage — verify at the end (see Quick Reference).
5. **Save** as `docs/<需求名>.html`. Don't commit unless asked.

## House-Style Rules (non-negotiable)

| Element | Rule |
|---|---|
| `<style>` block | Copy verbatim. Never restyle. Colors come from `:root` CSS variables only. |
| Code / SQL / YAML | Always the template's `<pre style="background:#f8fafc;...">`. **Inside `<pre>`, escape `<`→`&lt;`, `>`→`&gt;`, `&`→`&amp;`.** Unescaped `<` silently eats content. |
| Callout boxes | `.note` (橙, 提醒/易错), `.tip` (蓝, 正向补充), `.warn` (红, 风险). Use the right color for the meaning. |
| Diagrams | Hand-authored inline `<svg>` inside `<figure>`; text uses `.svg-t`/`.svg-s`/`.svg-title`; node fills use `:root` vars (`var(--new-bg)` etc.), matching the `.legend`. |
| Intro | Each section opens with one `<p class="lead">` stating what it answers. |
| Pills | `.pill.new/.old/.infra/.mq/.prod/.tech/.done/.todo` for status tags — reuse, don't invent classes. |
| Tables | Plain `<table>` — the CSS handles zebra striping and header shading. |
| Lang | `<html lang="zh">`; body copy in the doc's language (usually 中文). |

## Common Mistakes

- **Redesigning the CSS.** The whole point is identical output — don't "improve" colors, spacing, or fonts. Copy `<style>` untouched.
- **Unescaped angle brackets in `<pre>`.** `List<String>` renders as a broken tag. Escape to `List&lt;String&gt;`.
- **Dead TOC links.** Adding a section without its TOC entry (or renaming an `id` and forgetting the `href`). Always cross-check.
- **Inventing code positions.** `file:line`, table names, protoIds must be read from the repo. Unknown → `待确认` pill, not a plausible-looking guess.
- **Making it a proposal.** Keep it a *design doc* (what/how, locked decisions), not a persuasive pitch.

## Quick Reference — final self-check

```bash
f="docs/<需求名>.html"
# TOC hrefs vs section ids must match exactly (no output = perfect):
diff <(grep -oE 'href="#[a-z0-9-]+"' "$f" | sed 's/.*#//;s/"//' | sort -u) \
     <(grep -oE '<section id="[a-z0-9-]+"' "$f" | sed 's/.*"//' | sort -u)
# open in browser to eyeball diagrams + code blocks render cleanly
```

© smallnest · MIT · smallnest/goal-workflow

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

Все скиллы по теме «Тексты и документация» →
diagram-design cathrynlavery Скилл diagram-design для Claude Code генерирует архитектурные схемы и графику в виде автономных HTML-файлов с инлайновым SVG. Создаёт 51 тип визуализаций с единым стайлгайдом проекта. CX Codex +1 30 900установок diagram-design-editorial reason-machines Скилл diagram-design-editorial собирает диаграммы в HTML и SVG для статей и документации: 13 типов, без Mermaid и сборки, стиль подгоняется под ваш сайт. CX Codex +1 440установок frontend-design Orkas-AI Скилл frontend-design задаёт арт-дирекшн для HTML- и SVG-анимаций в OrkasVideoStudio перед сборкой index.html. Помогает избежать шаблонных неоновых карточек и мелких шрифтов. CX Codex +1 ★ 350звёзд репо html-diagram plannotator Скилл html-diagram для Claude Code и других платформ. Генерирует автономные интерактивные HTML-диаграммы без сторонних сервисов и сборки — топологию, состояния, таймлайн, архитектуру. CX Codex +1 4 600установок blueprinter yofine Скилл blueprinter для Claude Code создаёт строгие технические схемы и диаграммы на чистом HTML и CSS. Выводит спецификации без теней и градиентов. CX Codex +1 979установок pixel2motion nolangz Скилл pixel2motion для Claude Code превращает растровый логотип в гладкий SVG и анимированную HTML-страницу. Запускается для reveal, splash screen, загрузки или hover-анимации знака. CX Codex +1 608установок

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

Весь набор →
modern-go Скилл modern-go переводит Go-файлы на идиомы и API той версии, что объявлена в go.mod. Полезно, когда проект обновили, а код остался на старых приёмах. CX Codex +1 537установок review-it Скилл review-it для автоматического код-ревью перед коммитом или релизом. Проверяет незакоммиченные правки или ветку против main в нескольких ИИ-агентах. CX Codex +1 536установок prd-to-spec Скилл prd-to-spec преобразует PRD в технический SPEC с архитектурой, API, моделью данных и контрактами реализации. Нужен перед началом разработки. CX Codex +1 522установок code-to-spec Скилл code-to-spec для Claude Code и Codex: разбирает репозиторий и собирает из кода, конфигов и тестов документ SPEC. Восстанавливает спецификацию там, где её нет. CX Codex +1 491установок note-it Скилл note-it фиксирует архитектурные решения, компромиссы и отклонения от ТЗ после написания кода и сохраняет их в HTML-отчёт в папке docs. CX Codex +1 483установок to-issues Скилл to-issues разбивает PRD и технические спецификации на сквозные вертикальные задачи с явными зависимостями для GitHub или локального трекера. CX Codex +1 469установок article-icons Скилл article-icons встраивает аккуратные SVG-иконки из набора itshover в заголовки и блоки Markdown или HTML. CX Codex +1 279установок graph Скилл graph превращает задачу, PRD или набор issues в граф зависимостей (DAG), делит на волны и запускает независимые узлы параллельно — каждый в своём git-worktree, через субагентов. CX Codex +1 267установок

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

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