mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-18 18:04:26 +00:00
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.
@skillkit/tui
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