lynx-openui — скилл для Claude Code: OpenUI Lang для Lynx
Генерирует программы на OpenUI Lang v0.5 для рендерера Lynx OpenUI: статичные мобильные экраны, $state, Query/Mutation, потоковый вывод.
Apache-2.0 160 установок ★ 28 обновлён 2026-10-24
npx skills add lynx-community/skills --skill lynx-openui -a claude-codeЧто делает lynx-openui
Скилл превращает словесное описание экрана в программу на OpenUI Lang v0.5, тот DSL, который принимает <OpenUiRenderer response={...}>. На выходе только декларативные statements, по одному на строку, без Markdown, код-фенсов и JSX. Первая непустая строка присваивает root: либо переопределённый хостом корневой компонент, либо дефолтный Stack из библиотеки.
Внутри три справочника: references/components.md с сигнатурами компонентов, references/runtime.md про состояние, инструменты и действия, references/examples.md с раскладками. Аргументы передаются позиционно, поэтому пропуск необязательного значения в середине сдвигает все следующие: Stack([header, content], "column", false, "l", "stretch", "start") — рабочая запись. Мутируемые значения живут в $state. Чтение идёт через Query, запись через Mutation, которую запускает явный Action.
Без схем инструментов от хоста скилл не станет выдумывать имена: он соберёт статичную разметку или короткое пояснение на поддерживаемых компонентах. Урезанный каталог компонентов считается полным словарём, так что выпавшие из него встроенные элементы недоступны.
Какие задачи решает
- собрать экран мобильного приложения по описанию словами
- получить DSL, который рендерер показывает по мере поступления строк
- подключить реальный инструмент чтения и отрисовать список через
@Each - привязать запись к кнопке через
MutationиAction - поправить отдельные statements в режиме
mergeStatements
Примеры запросов агенту
- Опиши экран онбординга на OpenUI Lang: заголовок, три пункта и кнопку «Далее».
- Собери программу со списком задач из
QuerylistTasksи кнопкой, которая запускаетMutationcompleteTaskчерезAction. - Верни только изменённые statements для
mergeStatements: поменяй текст в шапке.
Как установить lynx-openui
1Через Skills CLI (Vercel)
npx skills add lynx-community/skills --skill lynx-openui -a claude-code2Вручную: положить файлы
~/.claude/skills/lynx-openui/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/lynx-openui/
1Через Skills CLI (Vercel)
npx skills add lynx-community/skills --skill lynx-openui -a codex2Вручную: положить файлы
.agents/skills/lynx-openui/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add lynx-community/skills --skill lynx-openui -a cursor2Вручную: положить файлы
.cursor/skills/lynx-openui/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install lynx-community/skills skills/lynx-openui2Вручную: положить файлы
.github/skills/lynx-openui/SKILL.md1Через Skills CLI (Vercel)
npx skills add lynx-community/skills --skill lynx-openui -a gemini-cli2Командой платформы
gemini skills install https://github.com/lynx-community/skills --path skills/lynx-openuiВручную: положить файлы
.devin/skills/lynx-openui/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add lynx-community/skills --skill lynx-openui -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о lynx-openui
Как установить lynx-openui в Claude Code?
Выполните npx skills add lynx-community/skills --skill lynx-openui -a claude-code. Скилл окажется в ~/.claude/skills/lynx-openui/SKILL.md.
Что делает lynx-openui?
Переводит запрос на естественном языке в декларативную программу на OpenUI Lang v0.5 для <OpenUiRenderer>. Это DSL, а не код приложения.
Почему вместо Query приходит статичная разметка?
Query и Mutation скилл ставит только под реальные схемы инструментов, которые передаёт хост. Если схем нет, остаётся статика или пояснение на поддерживаемых компонентах.
Исходный текст
SKILL.md · Apache-2.0
---
name: lynx-openui
description: Generate valid OpenUI Lang v0.5 functional-notation programs for the Lynx OpenUI renderer. Use when Codex must turn a natural-language UI request into raw OpenUI DSL for OpenUiRenderer, including static mobile UI, $state, Query/Mutation tool flows, Action plans, streaming-friendly output, or catalog-constrained revisions. Do not use for JSX, HTML, CSS, A2UI JSON, or implementing new ReactLynx components.
---
# Generate Lynx OpenUI Programs
Generate valid OpenUI Lang v0.5 consumed by
`<OpenUiRenderer response={...}>`. Produce declarative DSL, not application
code.
## Read The References
- Always read [components.md](references/components.md) before generating a
program. Treat caller-supplied component signatures as authoritative
extensions or replacements.
- Read [runtime.md](references/runtime.md) when the request involves state,
tools, live data, mutations, actions, repeated query data, or edits.
- Read [examples.md](references/examples.md) for a non-trivial layout or tool
workflow. Adapt patterns; do not copy irrelevant content.
## Workflow
1. Identify the requested UI, exact active component catalog, configured root
component, available tool schemas, host-supplied prefetched Query keys,
media URLs, and whether the host supports full programs or
`mergeStatements` patches.
2. Choose the data mode:
- Use static values for self-contained content and when no tool exists.
- Use `Query` only for an actual read tool supplied by the caller or host.
- Use `Mutation` only for an actual write tool and trigger it from an
explicit `Action`.
3. Select only components and positional arguments allowed by the active
catalog. Treat an explicitly reduced catalog as the complete vocabulary:
built-ins omitted from it are unavailable. Use the host's explicit root
override when present; otherwise use the Library's default `Stack` root.
4. Write a streaming-friendly graph. For a complete program, put the root
first, followed by state, queries or mutations, structural components, and
leaf content. For an edit-mode patch, return only changed statements.
5. Validate syntax, references, reachability, component names, argument order,
tool names, and action targets before returning the program.
## Output Contract
- Return only OpenUI Lang. Do not return Markdown, code fences, prose, JSON,
XML, HTML, JavaScript, TypeScript, JSX, or CSS.
- Put one assignment statement on each line.
- For a complete program, make the first non-empty line assign `root` to a call
of the host's explicit root override, for example `root = Shell(...)`.
Otherwise use the Library's default `root = Stack(...)`.
- Return a complete program by default. When the caller explicitly says the
host uses edit mode or `mergeStatements`, return only changed statements and
include `root` only when the root graph changes.
- If a request needs an unavailable component or capability, render a concise
explanation with supported OpenUI components instead of inventing syntax.
## Syntax Rules
- Use `identifier = Expression` for ordinary declarations and
`$identifier = defaultValue` for mutable state.
- Pass component arguments positionally. Never use named arguments such as
`gap: "m"`.
- Omit optional arguments only from the end. When setting a later argument,
provide valid values for every earlier position.
- Use double-quoted strings and escape embedded quotes and backslashes.
- Use references or inline components. Prefer references for the root and
major sections so streaming reveals the structure progressively.
- Ensure every referenced identifier is defined. Ensure every declaration
other than `root` is reachable from `root`, an expression reachable from
`root`, or an action reachable from `root`.
- Use only documented operators, built-ins, components, and action steps.
Correct positional layout using the default `Stack` root:
```text
root = Stack([header, content], "column", false, "l", "stretch", "start")
```
Incorrect positional layout:
```text
root = Stack([header, content], "column", "l", "stretch")
```
The incorrect form passes a string into `wrap` and shifts every later prop.
## Data And Interaction Rules
- Do not invent tool names. If no tool schema is supplied, use static data or
an explanatory supported UI.
- Give every `Query` a representative default result matching the real tool
shape so the UI renders in the first synchronous render after the response
stabilizes and before the request resolves.
- When the host supplies prefetched Query results, preserve the corresponding
Query assignment names. They are statement IDs and prefetch keys, not tool
names. See [runtime.md](references/runtime.md#query).
- Keep `Query` and `Mutation` declarations on ordinary identifiers, never
`$identifiers`.
- Use `@Each` for query-backed repeated UI. Keep its loop-dependent component
inline inside `@Each`.
- Trigger write operations only from an explicit submit or confirmation action
on an active-catalog component. With the default catalog, use `Button`. Do not
attach a mutation to an input's change action.
- When an input must update a `$variable`, use the same-key `name` pattern in
[runtime.md](references/runtime.md). Do not invent an event-value variable.
- Execute multi-step actions in deliberate order. Remember that a failed
mutation stops the remaining steps.
- Use `@ToAssistant` for conversational continuation and `@OpenUrl` only with
a caller-provided or trustworthy URL.
- Use caller-provided media URLs. Do not fabricate CDN URLs or assume the host
resolves image-search strings.
## Lynx UI Rules
- Prefer compact, mobile-first layouts with a shallow component tree.
- Apply component-specific preferences only when those components exist in the
active catalog; otherwise follow the supplied custom signatures.
- With the default catalog, use `Stack` or `Column` for ordinary vertical
structure, `Row` for small horizontal groups, and `List` for grouped or
repeated content.
- When `Image` exists, prefer explicit variants so the Lynx renderer has
concrete sizing.
- With the default catalog, keep readable text in `Text` or `TextContent`; do
not emit raw Lynx elements.
- When available, use `Tabs` for alternate views and `Modal` for tap-to-open
details. Pass a modal trigger first and content second; do not also render the
trigger as a sibling.
## Final Verification
Before returning, verify all of the following:
- A complete program assigns `root` to the host's explicit root override when
present, or to the Library's default `Stack` root otherwise. An edit-mode
patch omits `root` unless the root graph changes. The response contains only
OpenUI Lang.
- Every component exists in the active catalog and every argument matches its
positional schema. A reduced catalog contains no implicit built-ins, and the
root call uses its configured root component.
- No `Form`, `Input`, `Select`, `SelectItem`, `FormControl`, table, or chart is
used unless the caller supplied that custom component.
- Every reference resolves and no declaration is orphaned.
- Every `Query` or `Mutation` uses a real supplied tool and is referenced by
visible UI or a visible action.
- Every intended prefetched Query uses its exact host-supplied key as the
assignment name, and every Query still has a shape-correct default.
- Every `$variable` participates in visible UI, a query argument, or an action.
- Every `@Each` loop variable stays inside its inline template expression.
- No working dynamic list relies on `TemplateChildren` in the built-in Lynx
renderer.
- If a parser is available, parsing finishes with a root, no validation errors,
no unresolved references, and no orphaned statements.
© lynx-community · Apache-2.0 · lynx-community/skills