Rohit Ghumare 12ed10d170 refactor(tui): migrate to OpenTUI/Solid.js framework (#32)
* refactor(tui): migrate to OpenTUI/Solid.js framework

Complete TUI rewrite from Ink/React to OpenTUI/Solid.js:

- Replace React with Solid.js for reactive state management
- Migrate all 20 screens to OpenTUI component primitives
- Add monochromatic design with 14 color themes
- Implement cinematic splash screen with ASCII animation
- Add vi-key navigation (j/k/h/l) throughout
- Create 32 reusable components with consistent styling
- Add service layer for @skillkit/core API integration
- Remove deprecated react-opentui.d.ts type definitions
- Update build config for Solid.js JSX transform

Features covered:
- Browse, Marketplace, Recommend (discovery)
- Installed, Sync, Translate (management)
- Workflow, Execute, Plan, History (execution)
- Team, Context, Memory, Mesh, Message (collaboration)
- Plugins, Methodology, Settings (configuration)
- Help screen with 25+ keyboard shortcuts

* fix(tui): address CodeRabbit review feedback

Critical fixes:
- Remove non-existent module exports from index.tsx (context, themes, ui, hooks, services)
- Simplify App.tsx to remove missing context provider imports

Major fixes:
- ProgressBar: Add defensive guards for width/progress (NaN, Infinity, negative)
- Browse: Fix filtered index loading wrong repository
- Context: Add section navigation (h/l keys) and async error handling
- Methodology: Add error handling with try/catch/finally for all async ops
- Plan: Fix division by zero when plan has no tasks, add error handling
- Team: Add error handling for loadTeamConfig and handleInitialize
- Translate: Guard against missing skill.path before read operations

* fix(tui): address remaining CodeRabbit feedback

- Memory: Add error handling for loadData, handleDelete, handleClearAll, handleInitialize
- Team: Fix key conflict by blocking global keys when detail pane is open
- animations: Fix springCurve to return 0 at progress=0 and 1 at progress=1

* fix(tui): add Solid.js OpenTUI type definitions

Required for TypeScript to recognize OpenTUI JSX elements (box, text, span)
with their custom props (fg, bg, flexDirection, etc.)

* fix(tui): add stub services and fix type errors for CI

- Add minimal stub service implementations for all TUI screens:
  - context.service.ts - project context loading
  - executor.service.ts - skill execution
  - memory.service.ts - memory management
  - methodology.service.ts - methodology packs
  - plan.service.ts - plan management
  - plugin.service.ts - plugin management
  - recommend.service.ts - skill recommendations
  - team.service.ts - team collaboration
  - translator.service.ts - skill translation
  - workflow.service.ts - workflow orchestration

- Fix type errors in screens:
  - Plan.tsx: Add non-null assertions for optional issues array
  - Plugins.tsx: Cast getPluginInfo result to Plugin type

These stubs provide the expected interfaces for screens while
the full integration with @skillkit/core is completed later.

* fix(tui): add missing component files for CI

Add the component files that screens depend on:
- StatusIndicator - loading/success/error status display
- DetailPane - side panel for detailed view
- EmptyState/ErrorState - empty and error state components
- SelectList - selection list component
- SplitPane - split view layout
- AnimatedText - text animations
- Breadcrumb - navigation breadcrumb
- Button/Clickable - interactive elements
- CodeBlock - code display
- FormField - form input wrapper
- HoverHighlight - hover effect wrapper
- RightSidebar/BottomStatusBar - layout components
- TabBar - tab navigation
- ErrorBoundary - error handling wrapper

These components are required by the screen files and were
missing from the previous commit.

* fix(tui): resolve context import and duplicate export issues

- RightSidebar: inline sidebar state instead of importing from context
- services/index.ts: fix duplicate AgentType export by using explicit
  exports for executor and translator services

* fix(tui): use export type for type-only re-exports

* refactor(tui): simplify components and remove redundant exports

* refactor(tui): remove unused imports and variables

Code simplification pass:
- Remove unused onCleanup import from Workflow, Recommend, Sync screens
- Remove unused contentWidth from Browse, Recommend, Marketplace, Sync
- Remove unused cols from Browse, Recommend
- Remove unused JSX import from EmptyState component
- Remove unused translate import from Sync screen
- Remove unused SelectList import and listItems function from Memory screen

* fix(tui): wire up interactive handlers and fix type definitions

- AnimatedText: fix reactive dependency tracking in createEffect
- BottomStatusBar: remove unused width prop
- Breadcrumb: wire onNavigate handlers, fix off-by-one in getPathAtIndex
- Button: wire onClick with disabled check, apply paddingX, fix ButtonGroup spacing
- Clickable: wire click/double-click/right-click handlers, fix InteractiveArea
- DetailPane: make close button interactive
- ErrorBoundary: use terminal keyboard handler, prevent duplicate onError calls
- FormField: fix placeholder show condition for empty string
- SelectList: add onSelect/onHover interactive behavior
- SplitPane: preserve string sizes like "50%" in width/height helpers
- TabBar: wire onSelect callbacks for both horizontal and vertical variants
- solid-opentui.d.ts: add missing event handler types to BoxProps/TextProps

* fix(tui): address Devin review issues

- App: restore process.exit(0) fallback when onExit is undefined
- Execute: pass skill path instead of content to executeSkillWithAgent
- Memory: add useKeyboard handler for j/k/Enter/d/c/i/Esc shortcuts

* fix(tui): address Devin and CodeRabbit review issues

Security & Robustness:
- App: use execFile instead of exec to prevent command injection in openUrl
- App: clamp cols/rows to minimum 1 to prevent negative dimensions
- index: await render() and handle failures with exitTUI(1)

Execute screen:
- Add error state for load failures
- Prevent re-entrant execution with executing() guard
- Use try/finally to always clear executing state

Memory screen:
- Add missing 'r' shortcut for retry/refresh

Workflow screen:
- Use try/finally to always clear executing state even on rejection

Sync screen:
- Capture selectedIndex and agent values before await to prevent drift

* fix(tui): implement list windowing to keep selection visible

Execute, Marketplace, Recommend screens now use windowed list rendering
that follows the selection, preventing the selected item from being
off-screen when navigating through long lists.

- Add createMemo for computing visible window based on selectedIndex
- Show ▲/▼ indicators when items are above/below the visible window
- Navigate through full list instead of clamping to visible window size

* fix(tui): add error handling and index clamping

Marketplace.tsx:
- Set error signal when all repos fail or no skills loaded
- Add reactive effect to clamp selectedIndex when filteredSkills changes

Recommend.tsx:
- Wrap loadData in try/catch to surface errors in UI
- Clamp selectedIndex after recommendations update

* fix(tui): add error handling to Plugins and Workflow screens

Plugins.tsx:
- Wrap loadData in try/catch to prevent stuck loading state
- Wrap handleToggle in try/catch/finally to always reset toggling flag
- Wrap handleShowDetail in try/catch to surface errors gracefully

Workflow.tsx:
- Wrap loadData in try/catch to prevent stuck loading state
- Add catch block to handleExecute to show execution errors in UI
2026-02-01 17:29:25 +00:00
2026-01-28 18:37:07 +00:00
2026-01-21 10:59:25 +00:00

██ SKILLKIT

Universal Skills for AI Coding Agents

npm version npm downloads GitHub Package CI Website Docs License

Supercharge Every AI Coding Agent

Give your AI agents new abilities with portable, reusable skills. Install from a curated marketplace, create your own, and use them across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 27 more agents (32 total).

What are AI Agent Skills? Skills are instruction files that teach AI coding agents how to handle specific tasks - like processing PDFs, following React best practices, or enforcing security patterns. Think of them as plugins for your AI assistant.

# Quick start (no install required)
npx skillkit@latest

# Or install globally
npm install -g skillkit

Why SkillKit?

The problem: You've built amazing skills for Claude Code. Now you want to try Cursor. Or your team uses different agents. Each agent has different formats and directories. Without SkillKit, you either rewrite everything, lock yourself into one agent, or give up on skills entirely.

The solution: SkillKit translates skills between all 32 agents automatically. Write once, use everywhere.

See It In Action

Note: If the video doesn't play above, watch it here

# Install a skill for ALL your agents at once
skillkit install anthropics/skills --agent claude-code,cursor,windsurf

# Or translate existing skills between any agents
skillkit translate my-skill --from claude --to cursor,codex,copilot

# Get smart recommendations based on your project
skillkit recommend
# > 92% match: vercel-react-best-practices
# > 87% match: tailwind-v4-patterns
# > 85% match: nextjs-app-router

Beautiful CLI Experience

SkillKit features a polished, interactive CLI with visual feedback:

SkillKit Interactive CLI

  • Adaptive Logo - Full ASCII art on wide terminals, compact on narrow
  • Agent Icons - Visual indicators: ⟁ Claude · ◫ Cursor · ◎ Codex · ✦ Gemini · ⬡ OpenCode
  • Interactive Selection - Multi-select skills and agents with visual feedback
  • Progress Indicators - Step trails, spinners, and progress bars
  • Smart Defaults - Remembers your last selected agents

What Makes SkillKit Different

Feature Without SkillKit With SkillKit
Multi-Agent Support Manual rewrite for each agent One command, all agents
Team Collaboration Email skills back and forth Git-based bundles, remote sync
Skill Discovery Search GitHub manually Smart recommendations for your stack
Format Translation Learn each agent's format Automatic conversion (32 formats)
Context Sync Configure each agent separately One config, synced everywhere
Session Memory Knowledge dies with each session Persistent learning across agents
Skill Testing Hope it works Test framework with assertions

5-Minute Quick Start

# Launch interactive TUI (no install required)
npx skillkit@latest

# Or with specific commands:
npx skillkit recommend              # Get smart recommendations
npx skillkit install anthropics/skills  # Install official skills
npx skillkit sync                   # Sync to your AI agent

# For frequent use, install globally:
npm install -g skillkit
skillkit                            # Launch TUI

Core Features

Cross-Agent Translation

Use any skill with any agent. SkillKit automatically converts between formats:

# Translate a Claude skill to Cursor format
skillkit translate react-patterns --to cursor

# Translate all your skills to a new agent
skillkit translate --all --to windsurf

# Preview translation without writing
skillkit translate my-skill --to codex --dry-run

# Batch translate from a custom source directory
skillkit agent translate --source ./my-skills --to cursor

# Recursively translate nested agent directories
skillkit agent translate --source ./kubernetes-skills --to cursor --recursive

Supported Agents (32): Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, Amp, Clawdbot, Droid, GitHub Copilot, Goose, Kilo, Kiro, Roo, Trae, Windsurf, Universal, Cline, CodeBuddy, CommandCode, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder

Smart Recommendations

SkillKit analyzes your project and suggests the perfect skills:

skillkit recommend

# Project: my-app (Next.js + TypeScript + Tailwind)
#
# Recommended Skills:
#   92% vercel-react-best-practices
#   87% tailwind-v4-patterns
#   85% nextjs-app-router
#   78% typescript-strict-mode

Filter by task, category, or minimum score:

skillkit recommend --search "auth"        # Task-based search
skillkit recommend --category security    # Category filter
skillkit recommend --min-score 80         # Quality threshold

Session Memory System

Your AI agents learn, but that knowledge dies with the session. SkillKit captures learnings and makes them persistent:

# Compress session observations into reusable learnings
skillkit memory compress

# Search past learnings
skillkit memory search "authentication patterns"

# Export a learning as a shareable skill
skillkit memory export auth-insight --output auth-patterns.md

# Share memory across projects
skillkit memory --global

Skill Marketplace

Browse and install from curated skill repositories:

# Browse all available skills
skillkit marketplace

# Search for specific skills
skillkit marketplace search "react hooks"

# Filter by tags
skillkit marketplace --tags typescript,testing

# Refresh the skill index
skillkit marketplace refresh

Interactive TUI

Beautiful terminal interface for visual skill management:

skillkit ui
# or just
skillkit

Navigation: h Home | b Browse | r Recommend | t Translate | c Context | l List | s Sync | q Quit

Skill Testing Framework

Test your skills with built-in assertions:

# Run all skill tests
skillkit test

# Test specific skills
skillkit test ./my-skill

# Run tests with specific tags
skillkit test --tags unit,integration

# JSON output for CI
skillkit test --json

Workflow Orchestration

Compose skills into multi-step workflows:

# List available workflows
skillkit workflow list

# Run a workflow
skillkit workflow run feature-development

# Create new workflow
skillkit workflow create my-workflow

CI/CD Integration

Generate CI/CD templates for automated skill management:

# GitHub Actions
skillkit cicd github-action

# GitLab CI
skillkit cicd gitlab-ci

# Pre-commit hooks
skillkit cicd pre-commit

Supported Agents (32)

Agent Format Skills Directory
Claude Code SKILL.md .claude/skills/
Cursor MDC (.mdc) .cursor/skills/
Codex SKILL.md .codex/skills/
Gemini CLI SKILL.md .gemini/skills/
OpenCode SKILL.md .opencode/skills/
Antigravity SKILL.md .antigravity/skills/
Amp SKILL.md .amp/skills/
Clawdbot SKILL.md skills/ or ~/.clawdbot/skills/
Droid (Factory) SKILL.md .factory/skills/
GitHub Copilot Markdown .github/skills/
Goose SKILL.md .goose/skills/
Kilo Code SKILL.md .kilocode/skills/
Kiro CLI SKILL.md .kiro/skills/
Roo Code SKILL.md .roo/skills/
Trae SKILL.md .trae/skills/
Windsurf Markdown .windsurf/skills/
Universal SKILL.md skills/
Cline SKILL.md .cline/skills/
CodeBuddy SKILL.md .codebuddy/skills/
CommandCode SKILL.md .commandcode/skills/
Continue SKILL.md .continue/skills/
Crush SKILL.md .crush/skills/
Factory SKILL.md .factory/skills/
MCPJam SKILL.md .mcpjam/skills/
Mux SKILL.md .mux/skills/
Neovate SKILL.md .neovate/skills/
OpenHands SKILL.md .openhands/skills/
Pi SKILL.md .pi/skills/
Qoder SKILL.md .qoder/skills/
Qwen SKILL.md .qwen/skills/
Vercel SKILL.md .vercel/skills/
Zencoder SKILL.md .zencoder/skills/

All Commands

Skill Management

skillkit install <source>     # Install skills from GitHub/GitLab/Bitbucket/local
skillkit remove <skills>      # Remove installed skills
skillkit update [skills]      # Update skills from source
skillkit list                 # List installed skills
skillkit enable <skills>      # Enable specific skills
skillkit pause <skills>       # Temporarily pause skills
skillkit resume <skills>      # Resume paused skills
skillkit sync                 # Sync skills to agent config
skillkit read <skills>        # Read skill content for AI
skillkit status               # Show skill and agent status

Discovery & Recommendations

skillkit recommend            # Get smart recommendations
skillkit marketplace          # Browse skill marketplace
skillkit marketplace search   # Search marketplace
skillkit find <query>         # Quick skill search
skillkit check                # Check skill health and updates

Translation & Context

skillkit translate            # Translate between formats
skillkit context init         # Initialize project context
skillkit context sync         # Sync context to agents

AI Instruction Generation (Primer)

Generate AI instruction files for all 32 supported agents based on your codebase analysis:

skillkit primer               # Analyze codebase, generate for detected agents
skillkit primer --all-agents  # Generate for all 32 agents
skillkit primer --agent claude-code,cursor  # Specific agents only
skillkit primer --dry-run     # Preview without writing files
skillkit primer --analyze-only  # Only show codebase analysis
skillkit primer --output ./instructions  # Write to custom directory
skillkit primer --json        # Output analysis as JSON (for scripting)
skillkit primer --json --analyze-only  # Machine-readable analysis

Inspired by primer but extended for all SkillKit agents.

Custom AI Sub-Agents

skillkit agent list           # List all installed agents
skillkit agent show <name>    # Show agent details
skillkit agent create <name>  # Create a new agent
skillkit agent translate      # Translate agents between formats
  --source ./path             #   Source directory or file
  --to cursor                 #   Target agent format
  --recursive                 #   Scan subdirectories recursively
  --dry-run                   #   Preview without writing
skillkit agent sync           # Sync agents to target AI agent
skillkit agent validate       # Validate agent definitions

Memory System

skillkit memory status        # View memory status
skillkit memory search        # Search learnings
skillkit memory compress      # Compress observations
skillkit memory export        # Export as skill

Mesh Network

skillkit mesh init            # Initialize mesh network
skillkit mesh add <address>   # Add a host to mesh
skillkit mesh remove <id>     # Remove a host from mesh
skillkit mesh list            # List known hosts
skillkit mesh discover        # Discover hosts on LAN
skillkit mesh health          # Check host health
skillkit mesh status          # Show mesh status

# Security
skillkit mesh security init   # Setup encryption keys
skillkit mesh security status # Show security status
skillkit mesh peer trust <id> # Trust a peer
skillkit mesh peer revoke <id># Revoke peer trust
skillkit mesh peer list       # List trusted peers

Inter-Agent Messaging

skillkit message send         # Send message to agent
skillkit message inbox        # View inbox
skillkit message read <id>    # Read a message
skillkit message reply <id>   # Reply to message
skillkit message archive <id> # Archive message
skillkit message sent         # View sent messages
skillkit message status       # Messaging status

Quality & Testing

skillkit test                 # Run skill tests
skillkit validate             # Validate skill format
skillkit fix                  # Auto-fix skill issues
skillkit audit                # Audit skills for security/quality
skillkit manifest             # Generate skill manifest

Team Collaboration

skillkit team init            # Initialize team workspace
skillkit team share           # Share skills with team
skillkit team import          # Import team skills
skillkit team sync            # Sync team skills
skillkit team list            # List team members

Workflows & Automation

skillkit workflow run         # Execute workflow
skillkit plan create          # Create execution plan
skillkit plan execute         # Execute a plan
skillkit cicd init            # Generate CI/CD templates
skillkit hook register        # Register lifecycle hooks
skillkit command generate     # Generate slash commands

Plugins & Extensions

skillkit plugin list          # List available plugins
skillkit plugin install       # Install a plugin
skillkit plugin enable        # Enable a plugin
skillkit methodology list     # List methodologies
skillkit methodology load     # Load a methodology

Publishing & Sharing

skillkit publish              # Publish skill to marketplace
skillkit create               # Create new skill
skillkit init                 # Initialize in project

Configuration

skillkit settings             # View/edit settings
skillkit settings --set key=value  # Update setting

Creating Skills

Quick Start

skillkit create my-skill

Manual Creation

Create a SKILL.md file following the Agent Skills specification:

---
name: my-skill
description: What this skill does and when to use it
license: MIT
metadata:
  author: your-name
  version: "1.0"
---

# My Skill

Instructions for the AI agent.

## When to Use
- Scenario 1
- Scenario 2

## Steps
1. First step
2. Second step

Programmatic API

import {
  // Skill discovery
  findAllSkills,
  discoverSkills,
  detectAgent,
  getAdapter,

  // Translation
  translateSkill,
  translateSkillFile,

  // Recommendations
  RecommendationEngine,
  analyzeProject,

  // Context
  ContextManager,
  syncToAllAgents,

  // Memory
  createMemoryCompressor,
  createMemoryInjector,
  LearningStore,

  // Marketplace
  createMarketplaceAggregator,

  // Testing
  SkillTestRunner,

  // Workflows
  WorkflowOrchestrator,
} from 'skillkit';

// Example: Translate and install
const skill = await translateSkill(skillContent, 'cursor');
console.log(skill.content);

// Example: Get recommendations
const engine = new RecommendationEngine();
const profile = await analyzeProject('./my-project');
const recs = engine.recommend(profile);

Skill Sources & Attribution

SkillKit aggregates skills from trusted sources. We credit and link back to all original creators. Each source retains its original license.

Official Partner Sources

Repository Description License
anthropics/skills Official Claude Code skills from Anthropic Apache 2.0
vercel-labs/agent-skills Next.js, React, and Vercel platform skills MIT
expo/skills Mobile development with Expo and React Native MIT
remotion-dev/skills Programmatic video creation with React MIT
supabase/agent-skills Database, auth, and backend skills Apache 2.0
stripe/ai Payment integration and Stripe API patterns MIT

Community Contributors

Repository Description License
trailofbits/skills Security analysis and vulnerability detection Apache 2.0
obra/superpowers Test-driven development and workflow automation MIT
wshobson/agents Development patterns and agent configurations (48 agents) MIT
ComposioHQ/awesome-claude-skills Curated collection of Claude Code skills MIT
travisvn/awesome-claude-skills Community-curated skill collection MIT
langgenius/dify AI application development platform patterns Apache 2.0
better-auth/skills Authentication and authorization patterns MIT
onmax/nuxt-skills Vue.js and Nuxt framework skills MIT
elysiajs/skills Bun runtime and ElysiaJS framework MIT
kadajett/agent-nestjs-skills NestJS backend framework patterns MIT
cloudai-x/threejs-skills 3D graphics and WebGL development MIT
dimillian/skills iOS and SwiftUI development patterns MIT
waynesutton/convexskills Convex backend development MIT
kepano/obsidian-skills Obsidian plugin and vault management MIT
giuseppe-trisciuoglio/developer-kit UI component libraries (Shadcn/Radix) MIT
openrouterteam/agent-skills OpenRouter API integration patterns MIT

Want to add your skills? Submit your repository to be included in SkillKit

Installation Options

# npm (recommended)
npm install -g skillkit

# pnpm
pnpm add -g skillkit

# yarn
yarn global add skillkit

# bun
bun add -g skillkit

# npx (no install)
npx skillkit <command>

# GitHub Packages (alternative registry)
npm install -g @rohitg00/skillkit --registry=https://npm.pkg.github.com

Configuration

Create skillkit.yaml in your project:

version: 1
agent: cursor           # Override auto-detection
autoSync: true          # Auto-sync on changes
enabledSkills:
  - pdf
  - xlsx
disabledSkills:
  - deprecated-skill

License

Apache License 2.0 - see LICENSE for details.

Contributing

Contributions welcome! Please read our Contributing Guidelines.

S
Description
No description provided
Readme
187 MiB
Languages
TypeScript 99.2%
JavaScript 0.4%
Python 0.2%