Files
skillkit/packages/tui
Rohit Ghumare 145bf80342 chore: bump to 1.23.0, rewrite README, drop dead LLM SDK deps, add branded tags
Version bump
------------
1.22.1 -> 1.23.0 across all workspace packages. Minor bump covers the
slim-install dependency layout, safer first-time agent picker, and the
corresponding doc + branding changes.

Prune dead optional deps in @skillkit/core
------------------------------------------
@anthropic-ai/sdk, @google/genai, ollama, and openai were listed as
optionalDependencies but never imported. They were pulled through
@skillkit/cli transitively on every default install, adding ~57
packages and one deprecation warning (node-domexception via the
SDKs' own formdata-node / node-fetch transitives). Grep of
packages/core/src confirms no SDK import; providers in
src/ai/providers use direct fetch() against the provider HTTP APIs.
Drop them. better-sqlite3, sqlite-vec, and node-llama-cpp stay
because they are actually dynamic-imported by the vector store and
embedding pipeline.

Measured on a fresh npm cache (overrides-pinned file: tarballs):
  before:   475 pkgs / 18s / 3 deprecation warnings
  1.23.0:   418 pkgs / 18s / 2 deprecation warnings
  slim:     118 pkgs /  9s / 0 deprecation warnings
The two remaining warnings are upstream:
  - prebuild-install@7.1.3 from better-sqlite3 (must stay)
  - glob@9.3.5 from @opentui/solid -> babel-plugin-module-resolver

README rewrite
--------------
Punchier top fold. Palette-consistent SVG tag badges under
assets/tags/ replace most shields.io badges (still keep npm/CI/etc
on shields since they need live data). Collapsible detail blocks
for every feature instead of the linear wall. Same nav anchors the
site uses. No em dashes. No AI filler words. Writing style pulls
from the ai-engineering-from-scratch and awesome-claude-design
READMEs the user already runs.

Branded SVG tags
----------------
scripts/gen-tags.mjs generates 20 SVG pills under assets/tags/ in
the SkillKit palette (#09090b base, #fafafa text, #3f3f46 border,
accent per tag). Two variants: single pill with left accent bar
(new, slim-install, v1.23.0, etc.) and split badge (agents | 45,
packages | 118, install | 9s). Matches the aesthetic used on
awesome-claude-design, tailored to SkillKit's monochrome brand.
The tags directory is fork-and-remix friendly; README points to it.
2026-04-21 00:11:44 +01:00
..

@skillkit/tui

npm version License

Interactive terminal UI for SkillKit - browse, install, translate, and manage skills visually in your terminal.

Requirements

  • Bun runtime (>=1.2.0) - Required for OpenTUI rendering
  • Terminal with 80x24 minimum (120x40 recommended)

Install Bun: https://bun.sh

Installation

npm install -g skillkit

Quick Start

# Launch TUI with Bun
bun skillkit ui

# Or via pnpm in monorepo
pnpm ui

Features

  • Monochromatic Design - Clean B&W theme with colored accents
  • Animated UI - Smooth entrance animations and transitions
  • Browse Skills - Explore skill repositories with search and filtering
  • Smart Recommendations - AI-powered skill suggestions with match scores
  • Cross-Agent Translation - Convert skills between 45 agent formats
  • Team Collaboration - Share and sync skills across teams
  • Responsive Design - Adapts to any terminal size

Keyboard Shortcuts

Navigation

Key Screen
h Home
b Browse skills
m Marketplace
r Recommendations
i Installed skills
s Sync settings

Actions

Key Screen
t Translate skills
w Workflows
x Execute
n Plan
y History

Team & Config

Key Screen
a Team
c Context
e Memory
p Plugins
o Methodology
, Settings

Global

Key Action
/ Help screen
esc Go back / Home
q Quit
j/k Navigate lists
enter Select item

Screens Overview

  • Home - Dashboard with stats, detected agents, and features
  • Browse - Search and explore skill repositories
  • Marketplace - Curated skill marketplace with popularity metrics
  • Recommend - AI-powered suggestions based on your project
  • Installed - Manage installed skills (enable/disable/remove)
  • Sync - Sync skills across multiple agents
  • Translate - Convert skills between agent formats
  • Workflow - Manage and execute automation workflows
  • Execute - Run skills with checkpoints
  • Plan - Structured plan creation and execution
  • Team - Share skills and bundles with team members
  • Context - View detected stack and project context
  • Memory - Session memory and learnings
  • Plugins - Plugin management
  • Methodology - Development methodology frameworks
  • Settings - Configure SkillKit preferences

Programmatic Usage

import { startTUI } from '@skillkit/tui';

await startTUI();

Architecture

Built with:

  • OpenTUI - High-performance terminal UI framework
  • React - Component architecture
  • @skillkit/core - Core functionality
src/
├── index.tsx         # Entry point and startTUI
├── App.tsx           # Main app component
├── screens/          # Screen components
│   ├── Home.tsx
│   ├── Browse.tsx
│   ├── Help.tsx
│   └── ...
├── components/       # Reusable UI components
│   ├── Sidebar.tsx
│   ├── Splash.tsx
│   └── ...
├── state/            # State types and navigation
├── theme/            # Colors and symbols
└── utils/            # Helper functions

Documentation

Full documentation: https://github.com/rohitg00/skillkit

License

Apache-2.0