docs-page — скилл для Claude Code: документация и установка
Скилл docs-page для Claude Code создаёт одностраничную HTML-документацию с навигацией, статьёй и оглавлением. Оформляет API-справки, руководства и туториалы.
Apache-2.0 248 установок ★ 108 855 обновлён 2026-10-25
npx skills add nexu-io/open-design --skill docs-page -a claude-codeЧто делает docs-page
Скилл собирает трёхколоночную страницу: навигация слева, статья по центру и оглавление справа. Он оформляет разделы, блоки кода, примечания и ссылки, а также добавляет якоря к заголовкам. Страница рассчитана на просмотр справа налево: для этого в разметке и стилях используются логические направления.
Результат — один HTML-файл со встроенными стилями. В нём должны быть таблица, пример команды и фрагмент кода; кнопка копирования отображается как элемент интерфейса, без JavaScript. Скилл читает активный DESIGN.md и учитывает заданные в нём токены. Без такого файла он не сможет опереться на вашу дизайн-систему.
Какие задачи решает
- собрать страницу документации в одном HTML-файле
- разместить рядом навигацию, статью и оглавление
- оформить API-справку с примерами кода и таблицей
- адаптировать документацию для направления RTL
Примеры запросов агенту
- Создай страницу документации API с навигацией и оглавлением.
- Сверстай руководство в одном HTML-файле, используя активный
DESIGN.md. - Подготовь туториал с примером команды, блоком кода и таблицей.
Как установить docs-page
1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill docs-page -a claude-code2Вручную: положить файлы
~/.claude/skills/docs-page/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/docs-page/
1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill docs-page -a codex2Вручную: положить файлы
.agents/skills/docs-page/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill docs-page -a cursor2Вручную: положить файлы
.cursor/skills/docs-page/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install nexu-io/open-design design-templates/docs-page/SKILL.md2Вручную: положить файлы
.github/skills/docs-page/SKILL.md1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill docs-page -a gemini-cli2Командой платформы
gemini skills install https://github.com/nexu-io/open-design --path design-templates/docs-pageВручную: положить файлы
.devin/skills/docs-page/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill docs-page -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о docs-page
Как установить docs-page в Claude Code?
Выполните npx skills add nexu-io/open-design --skill docs-page -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/docs-page/SKILL.md.
Что делает docs-page?
Он создаёт одностраничную документацию в HTML: с навигацией, основной статьёй и оглавлением. В страницу входят примеры кода, таблица и блок с примечанием.
Нужен ли docs-page файл DESIGN.md?
Скилл читает активный DESIGN.md, чтобы использовать токены типографики и учитывать правила дизайн-системы. Это важно, если вы хотите, чтобы страница опиралась на существующий дизайн проекта.
Исходный текст
SKILL.md · Apache-2.0
---
name: docs-page
description: |
A documentation page — inline-start nav, scrollable article body,
inline-end table of contents. Use when the brief mentions "docs",
"documentation", "guide", "API reference", or "tutorial".
triggers:
- "docs"
- "documentation"
- "guide"
- "tutorial"
- "api reference"
- "文档"
od:
mode: prototype
platform: desktop
scenario: engineering
preview:
type: html
entry: index.html
design_system:
requires: true
sections: [color, typography, layout, components]
craft:
requires: [typography, typography-hierarchy, typography-hierarchy-editorial, rtl-and-bidi]
---
# Docs Page Skill
Produce a single, three-column documentation page in one HTML file.
## Workflow
1. **Read the active DESIGN.md** (injected above). Use the body type token for
prose; the mono token for code; respect line-height and max-width rules.
2. **Pick a topic** from the brief — the page should look like real docs, not
a generic wireframe. Concrete API names, command examples, plausible
parameters.
3. **Lay out** three regions, expressed on the inline axis so the
layout flips correctly under `dir="rtl"`:
- **Inline-start nav** (240–280px, sticky): grouped link list, current
page bolded with an `inline-start`-edge accent stripe. 3–5 groups
of 4–8 links.
- **Article body** (max-width ~720px, centered in the middle column):
H1, lede paragraph, H2 sections, code blocks, callout boxes (note /
warning), inline links, lists.
- **Inline-end TOC** (200–240px, sticky): "On this page" with the
H2/H3 anchors, current section highlighted as the user scrolls.
4. **Write** a single HTML document:
- `<!doctype html>` through `</html>`, all CSS inline.
- CSS Grid for the three columns; sticky positioning for the rails.
- Code blocks: monospace token, soft surface fill, copy-button affordance
(visual only — no JS needed).
- Anchor IDs on every H2/H3 so the TOC links work.
- `data-od-id` on the nav, article, and TOC.
5. **Prose**: write at least 350 words of believable docs. Include at least
one shell command, one code snippet (5–15 lines), one callout, one table.
6. **Self-check**:
- Body text wraps at the DS line-length sweet spot (60–75 chars).
- Code uses the DS mono token, not generic `monospace`.
- Accent is restrained — used for active nav item, links, one callout
border. Not on body text.
- Page is readable at 1280w and collapses gracefully below 900w (TOC drops
out, nav becomes a top drawer).
- Use logical CSS (`margin-inline-start`, `border-inline-start`,
`inset-inline-end`, `text-align: start`) on the rails and accent
stripe so the layout flips correctly under `dir="rtl"`.
## Output contract
Emit between `<artifact>` tags:
```
<artifact identifier="docs-slug" type="text/html" title="Docs — Page Title">
<!doctype html>
<html>...</html>
</artifact>
```
One sentence before the artifact, nothing after.
© nexu-io · Apache-2.0 · nexu-io/open-design