Files
Rohit Ghumare 28c2c0a936 feat(quality): extend quality evaluation system with badges, deeper analysis, and fix command
- Phase 2: Add quality badges to CLI commands (list, recommend, install)
  - formatQualityBadge() helper for color-coded grade badges
  - --quality flag for list command
  - Low-quality skill warnings during install

- Phase 3: Add TUI quality badges
  - Extended SkillItem with quality, grade, warnings fields
  - Quality evaluation in loadSkills()
  - Grade badges in Installed and Recommend screens

- Phase 4: Deeper quality analysis
  - Deprecated pattern detection (CommonJS, class components, var)
  - Security pattern detection (hardcoded credentials, eval, innerHTML)
  - Conflicting instruction detection
  - Completeness assessment (TODOs, empty sections, example coverage)
  - New weight distribution: Structure 35%, Clarity 25%, Specificity 25%, Advanced 15%

- Phase 1: Pre-compute marketplace quality scores
  - Updated schema.json with quality field (0-100)
  - Created scripts/compute-quality.ts for batch computation

- Phase 5: Benchmark against category leaders
  - New benchmark.ts module with category detection
  - Percentile calculation and comparison notes
  - --benchmark flag for validate command

- Phase 6: Fix command for automated quality fixes
  - skillkit fix command with --dry-run and --interactive modes
  - Auto-generates frontmatter, "When to Use", "Boundaries" sections
  - --fix flag alias on validate command
2026-01-28 13:02:51 +00: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 17+ 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