Skip to content
Back to search

opentui-skill

OpenTUI skill for use with OpenCode

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/msmps--opentui-skill/badge.svg)](/listings/msmps--opentui-skill)

HTML

<a href="/listings/msmps--opentui-skill"><img src="/api/listings/msmps--opentui-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

AI Coding Assistants

Add the skill to your AI coding assistant for richer context:

npx skills add msmps/opentui-skill

This 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 | bash

Global installation (available in all projects):

curl -fsSL https://raw.githubusercontent.com/msmps/opentui-skill/main/install.sh | bash -s -- --global

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 109 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # OpenTUI Skill
  2. OpenTUI platform reference docs. Covers the Core imperative API, React reconciler, Solid reconciler, layout system, components, keyboard handling, animations, and testing.
  3. ## Install
  4. ### AI Coding Assistants
  5. Add the skill to your AI coding assistant for richer context:
  6. ```bash
  7. npx skills add msmps/opentui-skill
  8. ```
  9. This works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Goose, OpenCode, and Windsurf.
  10. ### OpenCode (inc /command)
  11. Local installation (current project only):
  12. ```bash
  13. curl -fsSL https://raw.githubusercontent.com/msmps/opentui-skill/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 22 on GitHub
  14. ```
  15. Global installation (available in all projects):
  16. ```bash
  17. curl -fsSL https://raw.githubusercontent.com/msmps/opentui-skill/main/install.sh | bash -s -- --global
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 28 on GitHub
  18. ```
  19. ## Usage
  20. Once installed, the skill appears in OpenCode's `<available_skills>` list. The agent loads it automatically when working on OpenTUI tasks.
  21. Use the `/opentui` command to load the skill and get contextual guidance:
  22. ```
  23. /opentui create a React TUI with keyboard navigation
  24. ```
  25. ### Updating
  26. To update to the latest version:
  27. ```
  28. /opentui --update-skill
  29. ```
  30. ## Structure
  31. The installer adds both a skill and a command:
  32. ```
  33. # Skill (reference docs)
  34. skill/opentui/
  35. ├── SKILL.md # Main manifest + decision trees
  36. └── references/ # Framework and concept subdirectories
  37. ├── core/ # Imperative API (5-file pattern)
  38. ├── react/ # React reconciler (5-file pattern)
  39. ├── solid/ # Solid reconciler (5-file pattern)
  40. ├── components/ # Component categories
  41. ├── layout/ # Yoga/Flexbox layout
  42. ├── keyboard/ # Low-level input handling
  43. ├── keymap/ # Declarative layered keybindings
  44. ├── animation/ # Timeline animations
  45. └── testing/ # Test renderer + snapshots
  46. # Command (slash command)
  47. command/opentui.md # /opentui entrypoint
  48. ```
  49. ### Decision Trees
  50. The main `SKILL.md` contains decision trees for:
  51. - Choosing a framework (Core, React, Solid)
  52. - Displaying content (text, containers, code, diffs)
  53. - Handling user input (inputs, keyboard, focus)
  54. - Layout and positioning (flexbox, absolute, responsive)
  55. - Animations (timeline, easing, transitions)
  56. - Testing (snapshots, interaction, debugging)
  57. - Troubleshooting (gotchas, common issues)
  58. ## Topics Covered
  59. **Frameworks**: Core (imperative), React (declarative), Solid (fine-grained reactivity)
  60. **Components**: text, box, scrollbox, scrollbar, input, textarea, select, tab-select, slider, ascii-font, image, embedded-terminal, time-to-first-draw, code, line-number, diff, markdown, qr-code
  61. **Cross-cutting**: Layout (Yoga/Flexbox), Keyboard handling, Keymap, Animations, Testing
  62. **Additional capabilities**: `@opentui/keymap`, `@opentui/qrcode`, `@opentui/ssh`, loaded/streaming/captured audio, host and terminal clipboards, native images, OSC notifications
  63. **Runtime**: Bun (reference) or Node.js 26.4.0+ (`--experimental-ffi` for the native renderer)
  64. ## Credits & Inspiration
  65. This skill's structure and patterns are heavily inspired by:
  66. - **[cloudflare-skill](https://github.com/dmmulroy/cloudflare-skill)** by [Dillon Mulroy](https://github.com/dmmulroy) — an excellent example of a platform skill, demonstrating decision trees, progressive disclosure, and the multi-file reference pattern.
  67. - **[Anatomy of an Excellent OpenCode Skill](https://jpcaparas.medium.com/anatomy-of-an-excellent-opencode-skill-lessons-from-cloudflare-skill-0f853babc471)** by [JP Caparas](https://medium.com/@jpcaparas) — an insightful breakdown of what makes cloudflare-skill effective, covering context management, troubleshooting indexes, and intent-based routing.
  68. ## License
  69. MIT - see [LICENSE](LICENSE)
  70. ---
  71. **Upstream**: `anomalyco/opentui` | **Last synced commit**: `fbd584b2` | **Date**: 2026-08-27

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.