msmps / opentui-skill
★ 220A skill package that teaches your agent 1 capability — every one documented and browsable below, no GitHub required · by msmps.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
OpenTUI Skill
OpenTUI platform reference docs. Covers the Core imperative API, React reconciler, Solid reconciler, layout system, components, keyboard handling, animations, and testing.
Install
AI Coding Assistants
Add the skill to your AI coding assistant for richer context:
npx skills add msmps/opentui-skillThis works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Goose, OpenCode, and Windsurf.
OpenCode (inc /command)
Local installation (current project only):
curl -fsSL https://raw.githubusercontent.com/msmps/opentui-skill/main/install.sh | bashGlobal installation (available in all projects):
curl -fsSL https://raw.githubusercontent.com/msmps/opentui-skill/main/install.sh | bash -s -- --globalUsage
Once installed, the skill appears in OpenCode's <available_skills> list. The agent loads it automatically when working on OpenTUI tasks.
Use the /opentui command to load the skill and get contextual guidance:
/opentui create a React TUI with keyboard navigationUpdating
To update to the latest version:
/opentui --update-skillStructure
The installer adds both a skill and a command:
# Skill (reference docs)
skill/opentui/
├── SKILL.md # Main manifest + decision trees
└── references/ # Framework and concept subdirectories
├── core/ # Imperative API (5-file pattern)
├── react/ # React reconciler (5-file pattern)
├── solid/ # Solid reconciler (5-file pattern)
├── components/ # Component categories
├── layout/ # Yoga/Flexbox layout
├── keyboard/ # Low-level input handling
├── keymap/ # Declarative layered keybindings
├── animation/ # Timeline animations
└── testing/ # Test renderer + snapshots
# Command (slash command)
command/opentui.md # /opentui entrypointDecision Trees
The main SKILL.md contains decision trees for:
- Choosing a framework (Core, React, Solid)
- Displaying content (text, containers, code, diffs)
- Handling user input (inputs, keyboard, focus)
- Layout and positioning (flexbox, absolute, responsive)
- Animations (timeline, easing, transitions)
- Testing (snapshots, interaction, debugging)
- Troubleshooting (gotchas, common issues)
Topics Covered
Frameworks: Core (imperative), React (declarative), Solid (fine-grained reactivity)
Components: text, box, scrollbox, scrollbar, input, textarea, select, tab-select, slider, ascii-font, code, line-number, diff, markdown, qr-code
Cross-cutting: Layout (Yoga/Flexbox), Keyboard handling, Keymap, Animations, Testing
Additional packages: @opentui/keymap, @opentui/qrcode, @opentui/ssh, native Audio, OSC notifications
Runtime: Bun (reference) or Node.js 26.3.0 (--experimental-ffi for the native renderer)
Credits & Inspiration
This skill's structure and patterns are heavily inspired by:
-
cloudflare-skill by Dillon Mulroy — an excellent example of a platform skill, demonstrating decision trees, progressive disclosure, and the multi-file reference pattern.
-
Anatomy of an Excellent OpenCode Skill by JP Caparas — an insightful breakdown of what makes cloudflare-skill effective, covering context management, troubleshooting indexes, and intent-based routing.
License
MIT - see LICENSE
Upstream: anomalyco/opentui | Last synced commit: cea1dae | Date: 2026-06-26
Install the whole package (1 skills):
npx skills add https://github.com/msmps/opentui-skillOr install a single skill:
npx skills add https://github.com/msmps/opentui-skill --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.