skillkit 1.0.3 → 1.2.0

package/README.md

@@ -9,6 +9,33 @@ Universal skills loader for AI coding agents. Install, manage, and sync skills a
 
 Skills follow the [Agent Skills](https://agentskills.io) open format—a simple, portable standard for giving agents new capabilities and expertise.
 
+![SkillKit Demo](https://raw.githubusercontent.com/rohitg00/skillkit/main/skillkit.gif)
+
+## Interactive TUI
+
+Manage all your skills with a beautiful terminal interface:
+
+```bash
+skillkit ui
+# or simply
+skillkit
+```
+
+![SkillKit TUI](docs/img/skillkit-ui.png)
+
+**Features:**
+- Browse 33+ skill repositories
+- Install skills with one keystroke
+- Multi-agent installation support
+- View installed skills
+- Sync across agents
+- Responsive design for all terminal sizes
+
+**Navigation:**
+- `h` Home | `b` Browse | `l` List | `s` Sync | `,` Config
+- `↑↓` Navigate | `Enter` Select | `Esc` Back | `q` Quit
+- `m` Multi-agent selection | `r` Refresh/Back
+
 ### Compatible With
 
 | Agent | Status |
@@ -18,17 +45,23 @@ Skills follow the [Agent Skills](https://agentskills.io) open format—a simple,
 | Cursor | ✅ Native |
 | Gemini CLI | ✅ Native |
 | OpenCode | ✅ Native |
-| Amp | ✅ Supported |
-| Goose | ✅ Supported |
-| VS Code (Copilot) | ✅ Supported |
-| Letta | ✅ Supported |
-| Factory | ✅ Supported |
 | Antigravity | ✅ Native |
+| Amp | ✅ Native |
+| Clawdbot | ✅ Native |
+| Droid (Factory) | ✅ Native |
+| GitHub Copilot | ✅ Native |
+| Goose | ✅ Native |
+| Kilo Code | ✅ Native |
+| Kiro CLI | ✅ Native |
+| Roo Code | ✅ Native |
+| Trae | ✅ Native |
+| Windsurf | ✅ Native |
 | *Any markdown-config agent* | ✅ Universal |
 
 ## Features
 
-- **Multi-Agent Support**: Works with 10+ AI coding agents out of the box
+- **Interactive TUI**: Beautiful terminal interface for managing skills
+- **Multi-Agent Support**: Works with 17+ AI coding agents out of the box
 - **Multi-Platform Git**: GitHub, GitLab, Bitbucket, and local paths
 - **CI/CD Friendly**: Non-interactive flags for automation (`--skills`, `--all`, `--yes`)
 - **Skill Toggle**: Enable/disable skills without removing them
@@ -46,6 +79,9 @@ npx skillkit <command>
 ## Quick Start
 
 ```bash
+# Launch interactive TUI
+skillkit ui
+
 # Initialize in your project (auto-detects agent)
 skillkit init
 
@@ -58,6 +94,9 @@ skillkit install gitlab:owner/repo
 # Install specific skills (CI/CD friendly)
 skillkit install owner/repo --skills=pdf,xlsx,docx
 
+# Create a new skill
+skillkit create my-skill
+
 # Sync skills to your agent config
 skillkit sync
 
@@ -85,6 +124,34 @@ skillkit install vercel-labs/agent-skills/skills
 
 ## Commands
 
+### `skillkit ui` / `skillkit`
+
+Launch the interactive Terminal User Interface (TUI) for managing skills.
+
+```bash
+skillkit ui          # Explicit TUI launch
+skillkit             # Launch TUI if no arguments provided
+```
+
+**TUI Features:**
+- **Browse**: Discover skills from 33+ repositories
+- **List**: View all installed skills
+- **Sync**: Sync skills across multiple agents
+- **Settings**: Configure SkillKit preferences
+
+**Keyboard Shortcuts:**
+- `h` - Home screen
+- `b` - Browse skills marketplace
+- `l` - List installed skills
+- `s` - Sync skills across agents
+- `,` - Settings
+- `↑↓` - Navigate lists
+- `Enter` - Select / Install
+- `m` - Multi-agent selection (when viewing skills)
+- `r` - Refresh / Go back
+- `Esc` - Return to home
+- `q` - Quit
+
 ### `skillkit install <source>`
 
 Install skills from various sources.
@@ -109,12 +176,14 @@ skillkit install ./my-skills
 skillkit install ~/dev/skills
 
 # Options
+--list               # List available skills without installing
 --skills=pdf,xlsx    # Install specific skills only (CI/CD)
 --all                # Install all discovered skills
 --yes                # Skip confirmation prompts
 --global             # Install to global directory
 --force              # Overwrite existing skills
 --provider=gitlab    # Force specific provider
+--agent=cursor       # Install to specific agent (can specify multiple)
 ```
 
 ### `skillkit sync`
@@ -192,20 +261,45 @@ skillkit validate ./my-skill        # Validate single skill
 skillkit validate ./skills --all    # Validate all skills in directory
 ```
 
+### `skillkit create <skill-name>`
+
+Create a new skill with proper structure and template.
+
+```bash
+skillkit create my-skill                    # Basic skill
+skillkit create my-skill --full             # Include all directories (references, scripts, assets)
+skillkit create my-skill --scripts          # Include scripts directory
+skillkit create my-skill --references       # Include references directory
+skillkit create my-skill --assets           # Include assets directory
+skillkit create my-skill --dir ./skills     # Create in specific directory
+```
+
 ## Supported Agents
 
-| Agent | Config File | Skills Directory |
-|-------|-------------|------------------|
-| Claude Code | `AGENTS.md` | `.claude/skills/` |
-| Cursor | `.cursorrules` | `.cursor/skills/` |
-| Codex | `AGENTS.md` | `.codex/skills/` |
-| Gemini CLI | `GEMINI.md` | `.gemini/skills/` |
-| OpenCode | `AGENTS.md` | `.opencode/skills/` |
-| Antigravity | `AGENTS.md` | `.antigravity/skills/` |
-| Universal | `AGENTS.md` | `.agent/skills/` |
+| Agent | Config File | Project Path | Global Path |
+|-------|-------------|--------------|-------------|
+| Claude Code | `AGENTS.md` | `.claude/skills/` | `~/.claude/skills/` |
+| Cursor | `.cursorrules` | `.cursor/skills/` | `~/.cursor/skills/` |
+| Codex | `AGENTS.md` | `.codex/skills/` | `~/.codex/skills/` |
+| Gemini CLI | `GEMINI.md` | `.gemini/skills/` | `~/.gemini/skills/` |
+| OpenCode | `AGENTS.md` | `.opencode/skills/` | `~/.config/opencode/skills/` |
+| Antigravity | `AGENTS.md` | `.antigravity/skills/` | `~/.gemini/antigravity/skills/` |
+| Amp | `AGENTS.md` | `.agents/skills/` | `~/.config/agents/skills/` |
+| Clawdbot | `AGENTS.md` | `skills/` | `~/.clawdbot/skills/` |
+| Droid (Factory) | `AGENTS.md` | `.factory/skills/` | `~/.factory/skills/` |
+| GitHub Copilot | `AGENTS.md` | `.github/skills/` | `~/.copilot/skills/` |
+| Goose | `AGENTS.md` | `.goose/skills/` | `~/.config/goose/skills/` |
+| Kilo Code | `AGENTS.md` | `.kilocode/skills/` | `~/.kilocode/skills/` |
+| Kiro CLI | `AGENTS.md` | `.kiro/skills/` | `~/.kiro/skills/` |
+| Roo Code | `AGENTS.md` | `.roo/skills/` | `~/.roo/skills/` |
+| Trae | `AGENTS.md` | `.trae/skills/` | `~/.trae/skills/` |
+| Windsurf | `AGENTS.md` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
+| Universal | `AGENTS.md` | `.agent/skills/` | `~/.agent/skills/` |
 
 ## Creating Skills
 
+Use `skillkit create <name>` to scaffold a new skill, or create manually:
+
 A skill is a directory with a `SKILL.md` file:
 
 ```