SkillFoxx
Telegram

OpenTUI Skill

Справочник по OpenTUI для агента: деревья решений, API Core, React и Solid, раскладка, клавиши, анимации и тесты

  • 229 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Минимальный доступ

Почему такой уровень

  • Скилл состоит из справочных файлов и ничего не запускает; скрипт `install.sh` только копирует их в каталоги агента
Все причины и проверки

msmps/opentui-skillАвтор:msmps

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/opentui-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скилл состоит из справочных файлов и ничего не запускает; скрипт `install.sh` только копирует их в каталоги агента

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл подгружает агенту справочник по OpenTUI, платформе для терминальных интерфейсов, когда задача касается TUI. В `SKILL.md` лежат деревья решений: выбрать фреймворк (Core, React или Solid), вывести содержимое, принять ввод, разметить экран, оживить интерфейс, написать тесты, разобрать типичные сбои. Подробности вынесены в папки `references/` по темам: императивный API Core, реконсилеры React и Solid, компоненты, раскладка Yoga и Flexbox, клавиатура и декларативные раскладки клавиш, анимации, тестовый рендерер со снимками. Для OpenCode установщик добавляет еще команду `/opentui`: запрос `/opentui create a React TUI with keyboard navigation` загружает скилл и ведет задачу. Среди критических правил скилла: создавать проекты через `create-tui`, ставить опции раньше аргументов, вместо `process.exit()` вызывать `renderer.destroy()`, а стили текста в React и Solid задавать вложенными тегами.

Для кого. Разработчикам терминальных интерфейсов на OpenTUI, которые просят агента писать компоненты, раскладку и обработку клавиш.

Подходит, если

  • Нужен новый TUI на React или Solid, и агент должен выбрать подходящий фреймворк и взять правильный шаблон создания проекта
  • Горячие клавиши разных экранов мешают друг другу, и пригодится слоистая схема из справочника по `keymap`
  • Стили текста в React или Solid не применяются, и причину объясняет разбор частой ошибки в скилле
  • Интерфейс надо покрыть тестами со снимками через тестовый рендерер
  • Приложение зависает при выходе, и причину стоит искать в правилах про `renderer.destroy()`

Не подходит, если

  • Приложение не терминальное: весь скилл посвящен OpenTUI
  • Нет ни Bun, ни Node.js 26.4.0 с флагом `--experimental-ffi`: нативный рендерер не запустится
  • Нужен справочник по другой TUI-библиотеке: в скилле только платформа OpenTUI

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

Сделай на OpenTUI с React терминальный список задач с навигацией стрелками и покрой его снимочными тестами

Ограничения

Скилл — снимок документации OpenTUI на 27 августа 2026 года (коммит `fbd584b2` апстрима), поэтому новые возможности платформы попадают в него с задержкой. Рантайм — Bun или Node.js 26.4.0 и новее с флагом `--experimental-ffi` для нативного рендерера. Команда `/opentui` и скрипт `install.sh` рассчитаны на OpenCode, для остальных агентов ставится только скилл. Справочник написан по-английски и опирается на примеры для Core, React и Solid.

Как отключить. Удалите папку `skill/opentui` из каталога скиллов агента (например, `.claude/skills/opentui`) и, если ставили для OpenCode, файл команды `opentui.md` из каталога команд.

Частые вопросы

Как поставить скилл в OpenCode вместе с командой `/opentui`?

Для текущего проекта выполните `curl -fsSL https://raw.githubusercontent.com/msmps/opentui-skill/main/install.sh | bash`. Для всех проектов добавьте `-s -- --global` после `bash`. После установки скилл появится в списке доступных, а команда запустит его вручную.

С какими агентами работает `npx skills add`?

README называет Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Goose, OpenCode и Windsurf. Команда ставит только скилл, без `/opentui`.

Какие темы покрывает справочник?

Три способа работы: императивный Core, React и Solid. Плюс компоненты (текст, контейнеры, ввод, код и diff, markdown, QR-коды), раскладка, клавиатура и `keymap`, анимации по таймлайну и тестирование со снимками.

Как обновить скилл?

В OpenCode команда `/opentui --update-skill` подтягивает свежую версию. Для остальных агентов повторите установку `npx skills add msmps/opentui-skill` или выполните `npx skills update`.

Где взять шаблон нового проекта?

Скилл требует создавать проекты командой `create-tui`: например, `bunx create-tui -t react my-app`. Опции вроде `-t` ставят перед именем проекта, в обратном порядке команда не сработает.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы
Официальный

Скилл с документацией OpenTUI: агент собирает терминальные интерфейсы на Core, React или Solid и находит нужную страницу по теме

СкиллМинимальный доступ13,8 тыс.

Плагин и скилл для OpenCode: пишут навык, строят проверочные запросы, измеряют срабатывание описания и улучшают его.

ПлагинРасширенный доступ195

Больше 200 скиллов по стекам и практикам: React, Next.js, Rails, Rust, Python, отладка, TDD и ревью интерфейсов

СкиллМинимальный доступ225

CLI превращает спецификацию OpenAPI в Agent Skill из markdown-файлов, которые агент читает по частям и экономит контекст.

CLIМинимальный доступ342

Справочник по настольным приложениям на нескольких ОС с нативным ощущением: восемь принципов, четыре слоя, разбор WebView и аудит из 75 пунктов

СкиллМинимальный доступ2 тыс.

Набор из 16 инженерных скиллов для агентов: разработка под Apple, упаковка macOS, производительность React, ревью и рефакторинг кода

СкиллРасширенный доступ4 тыс.

Коротко о README

README в коротких разделах описывает установку, использование команды `/opentui`, структуру установленных файлов, список деревьев решений и охват тем. В конце указаны вдохновившие проект скиллы по Cloudflare, лицензия MIT и привязка к коммиту апстрима.

Бейдж для README

Исходный SKILL.md

---
name: opentui
description: OpenTUI skill for building terminal user interfaces with the Core, React, or Solid APIs. Use for any TUI task including components, layout, keyboard and keymap handling, animations, and testing.
metadata:
   references: core, react, solid, components, layout, keyboard, keymap, animation, testing
---

# OpenTUI Platform Skill

Consolidated skill for building terminal user interfaces with OpenTUI. Use decision trees below to find the right framework and components, then load detailed references.

## Critical Rules

**Follow these rules in all OpenTUI code:**

1. **Use `create-tui` for new projects.** See framework `REFERENCE.md` quick starts.
2. **`create-tui` options must come before arguments.** `bunx create-tui -t react my-app` works, `bunx create-tui my-app -t react` does NOT.
3. **Never call `process.exit()` directly.** Use `renderer.destroy()` (see `core/gotchas.md`).
4. **Text styling requires nested tags in React/Solid.** Use modifier elements, not props (see `components/text-display.md`).

## How to Use This Skill

### Reference File Structure

Framework references follow a 5-file pattern. Cross-cutting concepts are single-file guides.

Each framework in `./references/<framework>/` contains:

| File | Purpose | When to Read |
|------|---------|--------------|
| `REFERENCE.md` | Overview, when to use, quick start | **Always read first** |
| `api.md` | Runtime API, components, hooks | Writing code |
| `configuration.md` | Setup, tsconfig, bundling | Configuring a project |
| `patterns.md` | Common patterns, best practices | Implementation guidance |
| `gotchas.md` | Pitfalls, limitations, debugging | Troubleshooting |

Cross-cutting concepts in `./references/<concept>/` have `REFERENCE.md` as the entry point.

### Reading Order

Сообщить о проблеме