Compare commits

..
Author SHA1 Message Date
Rohit Ghumare b34177ca85 docs: rewrite READMEs with compelling value proposition
- Main README now leads with "One CLI. 17 AI Agents. Zero Lock-in."
- Clear problem/solution format showing SkillKit's value
- Feature comparison table (with vs without SkillKit)
- Organized command reference by category
- Updated all package READMEs with comprehensive docs:
  - @skillkit/core: Full API examples for all features
  - @skillkit/cli: Complete command reference
  - @skillkit/tui: Screen descriptions and keyboard shortcuts
  - @skillkit/agents: Agent adapter documentation
2026-01-23 18:24:07 +00:00
Rohit Ghumare 2fa62e6863 Merge branch 'feat/session-memory-system' 2026-01-23 18:18:57 +00:00
Rohit Ghumare d3ffb79512 feat: add session memory system for cross-agent learning (#3)
* feat: add session memory system for cross-agent learning

Implements a lightweight, local-first memory system that works across
all 17 AI coding agents. Key features:

- YAML-based storage (no databases or external services)
- Three memory layers: Session, Project, and Global
- AI-powered compression of observations into learnings
- Cross-agent memory injection with relevance matching
- Progressive disclosure for token efficiency

Core modules:
- ObservationStore: Capture raw session observations
- LearningStore: Persist compressed learnings
- MemoryCompressor: AI/rule-based compression engine
- MemoryInjector: Context-aware memory retrieval
- MemoryObserver: Automatic observation capture

CLI commands (skillkit memory):
- status, search, list, show, compress, export
- import, clear, add, rate, config

TUI integration:
- New Memory screen with tabs (Learnings/Observations/Search)
- useMemory hook for state management
- Updated navigation and keybindings

Code quality improvements:
- Replaced nested ternaries with explicit functions
- Added named constants for magic numbers
- Simplified navigation with lookup map

* feat: add marketplace, testing, CI/CD, workflows, and fix dry-run bug

New Features:
- Skill Marketplace: Aggregates skills from GitHub repos with caching
- Skill Testing Framework: 18+ assertion types for skill validation
- CI/CD Integration: Templates for GitHub Actions, GitLab CI, CircleCI
- Workflow Orchestration: Wave-based parallel skill execution
- Session Management: Pause/resume support with state persistence
- Agent Execution: CLI spawning for claude/codex/gemini/opencode/goose

New CLI Commands:
- skillkit marketplace - Browse and install from marketplace
- skillkit test - Run skill tests with assertions
- skillkit run - Execute skills with orchestration
- skillkit status - Show session state
- skillkit pause/resume - Session management
- skillkit workflow - Workflow management

New TUI Screens:
- Marketplace browser with search
- History viewer with session details
- Workflow management screen

Bug Fix:
- Fixed dry-run mode in memory compress command (Devin review)
  The --dry-run flag now properly prevents storing learnings

* fix: add missing yaml dependency to @skillkit/cli

* chore: update pnpm-lock.yaml

* fix: address 7 bugs identified by Devin code review

- Fix MemoryIndexStore ignoring isGlobal flag (memory-index.ts)
- Fix ESM runtime crash using require('yaml') in test runner (runner.ts)
- Fix ESM runtime crash using require('node:fs') in MarketplaceAggregator (aggregator.ts)
- Fix ESM runtime crash using require('node:fs') in SessionManager (manager.ts)
- Fix memory rate command parsing rating from --content instead of positional arg (memory.ts)
- Fix SkillExecutionEngine emitting failed status for paused executions (engine.ts)
- Fix run command misclassifying directories as skill markdown files (run.ts)

* fix: address CodeRabbit/Devin review issues (batch 2)

- Fix resume skipping checkpoint handling in engine.ts
- Add paused status guard before completeExecution call
- Fix NaN% progress when totalSteps=0 in Execute.tsx
- Fix effectiveness ?? instead of || to preserve 0% values in compressor.ts
- Clear cache on source change in aggregator.ts addSource/removeSource

* fix: address critical and major CodeRabbit/Devin issues (batch 3)

Security fixes:
- Remove shell: true from spawn to prevent shell injection (agents.ts)
- Add safe regex test with ReDoS protection (engine.ts)
- Add security warning for verification commands (engine.ts)

Bug fixes:
- Fix global memory index path to use ~/.skillkit/ (compressor.ts, memory-index.ts)
- Add task_complete events and verification to resumeExecution (engine.ts)
- Handle absolute URLs in skill entries (aggregator.ts)
- Implement actual port availability check (runner.ts)
- Remove invalid JUnit report format (templates.ts)
- Add crash guard to workflow list command (workflow/list.ts)

* fix: address remaining CodeRabbit/Devin issues (batch 4)

- ReDoS protection: Add pattern validator to reject dangerous regex patterns
  (nested quantifiers, overlapping alternations, excessive quantifiers)
- Add missing 'cancelled' status message in execution engine
- Make completedAt/durationMs optional in TaskExecutionResult
- Fix tag filter to skip untagged tests when tags are specified
- Improve error-solution matching: require keyword similarity + solution indicator
- Validate --limit and sanitize --tags in memory/marketplace CLI commands
- Guard against missing arrays when importing YAML learnings
- Escape YAML frontmatter values to prevent invalid output
- Preserve original learning source when merging learnings
- Fix keyword double-counting in memory index search
- Normalize keywords by stripping punctuation for better matching
2026-01-23 18:12:15 +00:00
5 changed files with 928 additions and 554 deletions
+260 -464
View File
@@ -5,535 +5,324 @@
[![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**The universal skills platform for AI coding agents.** Install, manage, translate, and sync skills across 17+ AI tools with smart recommendations.
## One CLI. 17 AI Agents. Zero Lock-in.
**Write skills once, use everywhere.** SkillKit is the universal platform that lets your AI coding skills work across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 12 more agents.
```bash
npm install -g skillkit && skillkit
npm install -g skillkit
```
## Why SkillKit?
## The Problem
| Problem | SkillKit Solution |
|---------|------------------|
| Skills only work with one agent | **Cross-agent translation** - use any skill with any agent |
| Don't know which skills to install | **Smart recommendations** - project-aware suggestions |
| Config fragmented across agents | **One config, all agents** - sync everywhere |
| Manual skill discovery | **Task-based search** - find skills by what you need |
You've built amazing skills for Claude Code. Now you want to try Cursor. Or your team uses different agents. Your options:
## 30-Second Quick Start
1. **Rewrite everything** - each agent has different formats, directories, and conventions
2. **Pick one agent** - lock yourself in, miss out on innovations
3. **Give up on skills** - lose the productivity gains
## The Solution
```bash
# Install globally
# 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
```
![SkillKit Demo](https://raw.githubusercontent.com/rohitg00/skillkit/main/skillkit.gif)
## What Makes SkillKit Different
| Feature | Without SkillKit | With SkillKit |
|---------|-----------------|---------------|
| **Multi-Agent Support** | Manual rewrite for each agent | One command, all agents |
| **Skill Discovery** | Search GitHub manually | Smart recommendations for your stack |
| **Format Translation** | Learn each agent's format | Automatic conversion (17 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
```bash
# 1. Install SkillKit globally
npm install -g skillkit
# Get personalized skill recommendations for your project
# 2. Launch the interactive TUI (easiest way to start)
skillkit
# Or use CLI commands directly:
# 3. Get personalized skill recommendations
skillkit recommend
# Install top-rated skills
# 4. Install skills from the marketplace
skillkit install anthropics/skills
# Launch interactive TUI
skillkit
# 5. Sync to your AI agent
skillkit sync
```
## Key Features
### Smart Recommendations
Analyzes your project and suggests the best skills:
```bash
skillkit recommend
# Project: my-app (Next.js + TypeScript + Tailwind)
#
# Recommended Skills:
# 92% ██████████ vercel-react-best-practices
# 87% █████████░ tailwind-v4-patterns
# 85% █████████░ nextjs-app-router
```
## Core Features
### Cross-Agent Translation
Use any skill with any agent - automatic format conversion:
Use any skill with any agent. SkillKit automatically converts between formats:
```bash
# Translate a Claude skill to Cursor format
skillkit translate react-patterns --to cursor
# Translate all skills for a new agent
skillkit translate --all --to antigravity
# 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
```
### Project Context Sync
Configure once, sync to all your agents:
**Supported Agents:** Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Antigravity, Amp, Clawdbot, Droid, GitHub Copilot, Goose, Kilo, Kiro, Roo, Trae, Windsurf, Universal
### Smart Recommendations
SkillKit analyzes your project and suggests the perfect skills:
```bash
# Analyze project and create context
skillkit context init
skillkit recommend
# Sync your config to all detected agents
skillkit context sync --all
# 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
```
## Interactive TUI
Filter by task, category, or minimum score:
Launch the beautiful terminal interface:
```bash
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:
```bash
# 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:
```bash
# 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:
```bash
skillkit ui
# or simply
# or just
skillkit
```
![SkillKit TUI](docs/img/skillkit-ui.png)
**Navigation:** `h` Home | `b` Browse | `r` Recommend | `t` Translate | `c` Context | `l` List | `s` Sync | `q` Quit
**Features:**
- Browse 33+ skill repositories
- Smart skill recommendations based on your project
- Install skills with one keystroke
- Multi-agent installation support
- Cross-agent skill translation
- Responsive design for all terminal sizes
### Skill Testing Framework
**Navigation:**
- `h` Home | `b` Browse | `r` Recommend | `l` List | `s` Sync | `,` Config
- `↑↓` Navigate | `Enter` Select | `Esc` Back | `q` Quit
- `m` Multi-agent selection | `/` Search
### Compatible With
| Agent | Status |
|-------|--------|
| Claude Code | ✅ Native |
| OpenAI Codex | ✅ Native |
| Cursor | ✅ Native |
| Gemini CLI | ✅ Native |
| OpenCode | ✅ Native |
| 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
- **Smart Recommendations**: AI-powered skill suggestions based on your project stack
- **Cross-Agent Translation**: Convert skills between any of 17+ agent formats
- **Project Context Sync**: One config that syncs to all your agents
- **Session Memory**: Cross-agent learning system that captures and shares knowledge
- **Skill Marketplace**: Browse and install skills from curated GitHub repositories
- **Skill Testing**: Test framework for validating skills with assertions
- **Workflow Orchestration**: Compose skills into multi-step workflows
- **Interactive TUI**: Beautiful terminal interface for managing skills
- **Multi-Agent Support**: Works with Claude Code, Cursor, Codex, Windsurf, and 13+ more
- **Multi-Platform Git**: GitHub, GitLab, Bitbucket, and local paths
- **CI/CD Integration**: GitHub Actions, GitLab CI, CircleCI templates
- **Zero Config**: Auto-detects your agent and configures appropriately
## Installation
Test your skills with built-in assertions:
```bash
# Global install (recommended)
npm install -g skillkit
# Run all skill tests
skillkit test
# Or use without installing
npx skillkit <command>
# Test specific skills
skillkit test ./my-skill
# Or with other package managers
pnpm add -g skillkit
yarn global add skillkit
bun add -g skillkit
# Run tests with specific tags
skillkit test --tags unit,integration
# JSON output for CI
skillkit test --json
```
## Quick Start
### Workflow Orchestration
Compose skills into multi-step workflows:
```bash
# 1. Get recommendations for your project
skillkit recommend
# List available workflows
skillkit workflow list
# 2. Install recommended skills
skillkit install anthropics/skills
# Run a workflow
skillkit workflow run feature-development
# 3. Sync to your agent
skillkit sync
# Or just launch the TUI and do it all interactively
skillkit
# Create new workflow
skillkit workflow create my-workflow
```
## Popular Skill Repositories
### CI/CD Integration
Install skills from these community repositories:
Generate CI/CD templates for automated skill management:
```bash
# Anthropic's official skill marketplace
skillkit install anthropics/skills
# GitHub Actions
skillkit cicd github-action
# Vercel's React & Next.js best practices
skillkit install vercel-labs/agent-skills/skills
# GitLab CI
skillkit cicd gitlab-ci
# Pre-commit hooks
skillkit cicd pre-commit
```
![SkillKit Demo](https://raw.githubusercontent.com/rohitg00/skillkit/main/skillkit.gif)
## Supported Agents (17)
| Repository | Skills | Description |
|------------|--------|-------------|
| [anthropics/skills](https://github.com/anthropics/skills) | `pdf`, `xlsx`, `docx`, etc. | Official Claude Code skill marketplace |
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | `vercel-react-best-practices`, `web-design-guidelines` | React/Next.js optimization & UI review |
| 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/` |
| 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/` |
## All Commands
## Commands
### `skillkit ui` / `skillkit`
Launch the interactive Terminal User Interface (TUI) for managing skills.
### Skill Management
```bash
skillkit ui # Explicit TUI launch
skillkit # Launch TUI if no arguments provided
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 disable <skills> # Disable specific skills
skillkit sync # Sync skills to agent config
skillkit read <skills> # Read skill content for AI
```
**TUI Features:**
- **Browse**: Discover skills from 33+ repositories
- **Recommend**: Get smart skill suggestions for your project
- **List**: View all installed skills
- **Sync**: Sync skills across multiple agents
- **Settings**: Configure SkillKit preferences
**Keyboard Shortcuts:**
- `h` - Home screen
- `b` - Browse skills marketplace
- `r` - Smart recommendations
- `l` - List installed skills
- `s` - Sync skills across agents
- `,` - Settings
- `↑↓` - Navigate lists
- `Enter` - Select / Install
- `m` - Multi-agent selection (when viewing skills)
- `/` - Search skills
- `Esc` - Return to home
- `q` - Quit
### `skillkit install <source>`
Install skills from various sources.
### Discovery & Recommendations
```bash
# GitHub (default)
skillkit install owner/repo
skillkit install https://github.com/owner/repo
# Install from a subdirectory
skillkit install owner/repo/skills
# GitLab
skillkit install gitlab:owner/repo
skillkit install https://gitlab.com/owner/repo
# Bitbucket
skillkit install bitbucket:owner/repo
# Local path
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 recommend # Get smart recommendations
skillkit marketplace # Browse skill marketplace
skillkit marketplace search # Search marketplace
```
### `skillkit sync`
Sync installed skills to your agent's config file.
### Translation & Context
```bash
skillkit sync
skillkit sync --agent cursor
skillkit sync --output AGENTS.md
skillkit sync --enabled-only
skillkit translate # Translate between formats
skillkit context init # Initialize project context
skillkit context sync # Sync context to agents
```
### `skillkit recommend`
Get smart skill recommendations based on your project's tech stack.
### Memory System
```bash
skillkit recommend # Analyze current directory
skillkit recommend --path ./my-app # Analyze specific project
skillkit recommend --verbose # Show detailed match reasons
skillkit recommend --limit 5 # Limit results
skillkit recommend --min-score 50 # Only show high matches
skillkit recommend --category security # Filter by category
skillkit recommend --search "auth" # Search skills by task
skillkit recommend --update # Update skill index
skillkit recommend --json # Output as JSON
skillkit memory status # View memory status
skillkit memory search # Search learnings
skillkit memory compress # Compress observations
skillkit memory export # Export as skill
```
### `skillkit translate`
Translate skills between different agent formats.
### Testing & Workflows
```bash
skillkit translate react-skill --to cursor # Translate to Cursor format
skillkit translate ./skill --from claude --to windsurf # Explicit source/target
skillkit translate --all --to cursor # Translate all installed skills
skillkit translate react-skill --to cursor --dry-run # Preview without writing
skillkit test # Run skill tests
skillkit workflow run # Execute workflow
skillkit cicd # Generate CI/CD templates
```
**Supported translations:** All 17 agents can translate to/from each other.
### `skillkit context`
Manage project context for cross-agent synchronization.
### Utilities
```bash
skillkit context init # Analyze project and create context
skillkit context show # Display current context
skillkit context export # Export context to file
skillkit context import ./context.yaml # Import context from file
skillkit context sync --agent cursor # Sync context to specific agent
skillkit context sync --all # Sync to all detected agents
skillkit init # Initialize in project
skillkit validate # Validate skill format
skillkit create # Create new skill
```
### `skillkit read <skills>`
Read skill content for AI agent consumption.
```bash
skillkit read pdf
skillkit read pdf,xlsx,docx # Multiple skills
```
### `skillkit list`
List all installed skills.
```bash
skillkit list
skillkit list --enabled
skillkit list --json
```
### `skillkit enable/disable <skills>`
Toggle skills on/off without removing them.
```bash
skillkit enable pdf xlsx
skillkit disable docx
```
### `skillkit update [skills]`
Update skills from their original sources.
```bash
skillkit update # Update all
skillkit update pdf xlsx # Update specific
```
### `skillkit remove <skills>`
Remove installed skills.
```bash
skillkit remove pdf xlsx
```
### `skillkit init`
Initialize skillkit in a project.
```bash
skillkit init
skillkit init --agent cursor
skillkit init --list # List supported agents
```
### `skillkit validate <path>`
Validate skills against the [Agent Skills specification](https://agentskills.io/specification).
```bash
skillkit validate ./my-skill # Validate single skill
skillkit validate ./skills --all # Validate all skills in directory
```
### `skillkit marketplace`
Browse and install skills from the curated marketplace.
```bash
skillkit marketplace # Browse all skills
skillkit marketplace search typescript # Search for skills
skillkit marketplace refresh # Refresh skill index
skillkit marketplace tags # Show popular tags
skillkit marketplace sources # List skill sources
skillkit marketplace --limit 20 # Limit results
skillkit marketplace --tags react,next # Filter by tags
```
### `skillkit memory`
Manage session memory - learnings captured across AI coding sessions.
```bash
skillkit memory status # Show memory status
skillkit memory search "auth" # Search memories
skillkit memory list # List all learnings
skillkit memory show <id> # Show specific learning
skillkit memory compress # Compress observations into learnings
skillkit memory export <id> # Export learning as a skill
skillkit memory import ./file.yaml # Import memories
skillkit memory add --title "..." # Add manual learning
skillkit memory rate <id> 85 # Rate effectiveness (0-100)
skillkit memory --global # Use global memory scope
```
### `skillkit test`
Test skills with the built-in testing framework.
```bash
skillkit test # Run all skill tests
skillkit test ./my-skill # Test specific skill
skillkit test --tags unit # Run tests with specific tags
skillkit test --json # Output results as JSON
skillkit test --verbose # Verbose output
```
### `skillkit workflow`
Manage and run skill workflows (multi-step skill compositions).
```bash
skillkit workflow list # List available workflows
skillkit workflow run <name> # Run a workflow
skillkit workflow create <name> # Create new workflow
skillkit workflow validate <name> # Validate workflow definition
skillkit workflow --verbose # Verbose output
```
### `skillkit cicd`
Generate CI/CD integration templates.
```bash
skillkit cicd github-action # Generate GitHub Actions workflow
skillkit cicd pre-commit # Generate pre-commit hook
skillkit cicd gitlab-ci # Generate GitLab CI config
skillkit cicd circleci # Generate CircleCI config
skillkit cicd --list # List available templates
skillkit cicd --output ./path # Output to specific path
```
### `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 | 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:
### Quick Start
A skill is a directory with a `SKILL.md` file:
```
my-skill/
├── SKILL.md # Required: Instructions for the AI
├── references/ # Optional: Documentation
├── scripts/ # Optional: Helper scripts
└── assets/ # Optional: Templates, configs
```bash
skillkit create my-skill
```
### SKILL.md Format
### Manual Creation
Follows the [Agent Skills specification](https://agentskills.io/specification):
Create a `SKILL.md` file following the [Agent Skills specification](https://agentskills.io/specification):
```markdown
---
name: my-skill
description: What this skill does and when to use it. Include trigger keywords.
description: What this skill does and when to use it
license: MIT
compatibility: Requires Node.js 18+
metadata:
author: your-org
author: your-name
version: "1.0"
---
# My Skill
Instructions for the AI agent on how to use this skill.
Instructions for the AI agent.
## When to Use
- Scenario 1
- Scenario 2
## Steps
1. First step
2. Second step
```
| Field | Required | Description |
|-------|----------|-------------|
| `name` | Yes | Lowercase alphanumeric with hyphens (max 64 chars) |
| `description` | Yes | What it does and when to use it (max 1024 chars) |
| `license` | No | License name or reference |
| `compatibility` | No | Environment requirements |
| `metadata` | No | Arbitrary key-value pairs |
## CI/CD Usage
```yaml
# GitHub Actions example
- name: Setup skills
run: |
npx skillkit install owner/skills --skills=lint,test,deploy --yes
npx skillkit sync --yes
```
## Programmatic API
```typescript
@@ -543,73 +332,68 @@ import {
discoverSkills,
detectAgent,
getAdapter,
// Recommendations
RecommendationEngine,
analyzeProject,
// Translation
translateSkill,
translateSkillFile,
// Recommendations
RecommendationEngine,
analyzeProject,
// Context
ContextManager,
initContext,
syncToAllAgents,
// Marketplace
createMarketplaceAggregator,
// Session Memory
// Memory
createMemoryCompressor,
createMemoryInjector,
LearningStore,
ObservationStore,
// Marketplace
createMarketplaceAggregator,
// Testing
SkillTestRunner,
// Workflows
WorkflowOrchestrator,
parseWorkflow,
// CI/CD
getCICDTemplate,
listCICDTemplates,
} from 'skillkit';
// Find all installed skills
const skills = findAllSkills(searchDirs);
// Example: Translate and install
const skill = await translateSkill(skillContent, 'cursor');
console.log(skill.content);
// Detect current agent
const agent = await detectAgent();
// Generate config
const adapter = getAdapter(agent);
const config = adapter.generateConfig(skills);
// Get smart recommendations
// Example: Get recommendations
const engine = new RecommendationEngine();
const profile = await analyzeProject('./my-project');
const recommendations = engine.recommend(profile, skills);
const recs = engine.recommend(profile);
```
// Translate skills between agents
const result = translateSkill(skillContent, 'cursor');
console.log(result.content); // Cursor MDC format
## Popular Skill Repositories
// Manage project context
const ctx = new ContextManager('./my-project');
await ctx.init();
await syncToAllAgents(ctx.getContext());
| Repository | Description |
|------------|-------------|
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code marketplace - PDF, XLSX, DOCX processing |
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | React/Next.js best practices, web design guidelines |
// Browse marketplace
const marketplace = createMarketplaceAggregator();
const results = await marketplace.search({ query: 'react' });
## Installation Options
// Session memory
const injector = createMemoryInjector('./my-project');
const memories = injector.search('authentication patterns');
```bash
# npm (recommended)
npm install -g skillkit
// Run skill tests
const runner = new SkillTestRunner('./my-project');
const testResults = await runner.runAll();
# pnpm
pnpm add -g skillkit
// Run workflows
const workflow = parseWorkflow('./workflow.yaml');
const orchestrator = new WorkflowOrchestrator(workflow);
await orchestrator.execute();
# yarn
yarn global add skillkit
# bun
bun add -g skillkit
# npx (no install)
npx skillkit <command>
```
## Configuration
@@ -627,14 +411,26 @@ disabledSkills:
- deprecated-skill
```
## Why SkillKit Exists
AI coding agents are amazing, but the ecosystem is fragmented:
- **Skills don't transfer** between agents
- **Knowledge dies** when sessions end
- **No standard** for skill quality or testing
- **Manual discovery** of useful skills
SkillKit solves these problems with a universal platform that works across all major AI coding agents.
## License
Apache License 2.0 - see [LICENSE](LICENSE) for details.
## Contributing
Contributions welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) before submitting a pull request.
Contributions welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md).
## Acknowledgments
## Links
Implements the [Agent Skills](https://agentskills.io) open format, originally developed by Anthropic and adopted by leading AI development tools.
- [Agent Skills Specification](https://agentskills.io/specification)
- [GitHub Repository](https://github.com/rohitg00/skillkit)
- [NPM Package](https://www.npmjs.com/package/skillkit)
+177 -24
View File
@@ -1,6 +1,9 @@
# @skillkit/agents
Agent adapters for SkillKit - supports 17+ AI coding agents.
[![npm version](https://img.shields.io/npm/v/@skillkit/agents.svg)](https://www.npmjs.com/package/@skillkit/agents)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Agent adapters for SkillKit** - configuration and detection for 17 AI coding agents.
## Installation
@@ -8,40 +11,190 @@ Agent adapters for SkillKit - supports 17+ AI coding agents.
npm install @skillkit/agents
```
## Supported Agents
## Supported Agents (17)
| Agent | Config Format | Skills Directory |
|-------|--------------|------------------|
| Claude Code | SKILL.md | `.claude/skills/` |
| Cursor | .cursorrules, .mdc | `.cursor/skills/` |
| Codex | SKILL.md | `.codex/skills/` |
| Gemini CLI | SKILL.md | `.gemini/skills/` |
| Windsurf | .windsurfrules | `.windsurf/skills/` |
| GitHub Copilot | Markdown | `.github/copilot-instructions.md` |
| OpenCode | SKILL.md | `.opencode/skills/` |
| Antigravity | SKILL.md | `.antigravity/skills/` |
| Amp | SKILL.md | `.amp/skills/` |
| Goose | SKILL.md | `.goose/skills/` |
| Kilo | SKILL.md | `.kilocode/skills/` |
| Roo | SKILL.md | `.roo/skills/` |
| Trae | SKILL.md | `.trae/skills/` |
| And more... | | |
| Agent | Config Format | Project Skills | Global Skills |
|-------|--------------|----------------|---------------|
| Claude Code | SKILL.md | `.claude/skills/` | `~/.claude/skills/` |
| Cursor | MDC (.mdc) | `.cursor/skills/` | `~/.cursor/skills/` |
| Codex | SKILL.md | `.codex/skills/` | `~/.codex/skills/` |
| Gemini CLI | SKILL.md | `.gemini/skills/` | `~/.gemini/skills/` |
| OpenCode | SKILL.md | `.opencode/skills/` | `~/.config/opencode/skills/` |
| Antigravity | SKILL.md | `.antigravity/skills/` | `~/.gemini/antigravity/skills/` |
| Amp | SKILL.md | `.agents/skills/` | `~/.config/agents/skills/` |
| Clawdbot | SKILL.md | `skills/` | `~/.clawdbot/skills/` |
| Droid (Factory) | SKILL.md | `.factory/skills/` | `~/.factory/skills/` |
| GitHub Copilot | Markdown | `.github/skills/` | `~/.copilot/skills/` |
| Goose | SKILL.md | `.goose/skills/` | `~/.config/goose/skills/` |
| Kilo Code | SKILL.md | `.kilocode/skills/` | `~/.kilocode/skills/` |
| Kiro CLI | SKILL.md | `.kiro/skills/` | `~/.kiro/skills/` |
| Roo Code | SKILL.md | `.roo/skills/` | `~/.roo/skills/` |
| Trae | SKILL.md | `.trae/skills/` | `~/.trae/skills/` |
| Windsurf | Markdown | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
| Universal | SKILL.md | `skills/` | `~/.agent/skills/` |
## Usage
### Get Agent Adapter
```typescript
import { getAdapter, detectAgent, listAdapters } from '@skillkit/agents';
import { getAdapter, AgentType } from '@skillkit/agents';
// Get adapter for specific agent
const adapter = getAdapter('claude-code');
console.log(adapter.skillsDir); // .claude/skills/
// Detect installed agents
const detected = detectAgent();
console.log(detected); // ['claude-code', 'cursor']
console.log(adapter.name); // 'claude-code'
console.log(adapter.skillsDir); // '.claude/skills/'
console.log(adapter.globalSkillsDir); // '~/.claude/skills/'
console.log(adapter.configFile); // 'AGENTS.md'
console.log(adapter.format); // 'skill-md'
```
// List all available adapters
### Detect Installed Agents
```typescript
import { detectAgent, detectAllAgents } from '@skillkit/agents';
// Detect primary agent in current directory
const primary = await detectAgent();
console.log(primary); // 'claude-code'
// Detect all installed agents
const all = await detectAllAgents();
console.log(all); // ['claude-code', 'cursor', 'windsurf']
// Detect in specific directory
const agents = await detectAllAgents('./my-project');
```
### List All Adapters
```typescript
import { listAdapters, getAdapterNames } from '@skillkit/agents';
// Get all adapter configurations
const adapters = listAdapters();
adapters.forEach(adapter => {
console.log(`${adapter.name}: ${adapter.skillsDir}`);
});
// Get just the names
const names = getAdapterNames();
console.log(names); // ['claude-code', 'cursor', 'codex', ...]
```
### Generate Agent Config
```typescript
import { getAdapter } from '@skillkit/agents';
import { findAllSkills } from '@skillkit/core';
const adapter = getAdapter('cursor');
const skills = findAllSkills([adapter.skillsDir]);
// Generate config file content
const config = adapter.generateConfig(skills);
console.log(config);
```
### Get Skills Directory
```typescript
import { getAdapter } from '@skillkit/agents';
import { homedir } from 'os';
const adapter = getAdapter('claude-code');
// Project-local skills directory
const projectDir = adapter.skillsDir; // '.claude/skills/'
// Global skills directory
const globalDir = adapter.globalSkillsDir.replace('~', homedir());
// '/Users/you/.claude/skills/'
```
## Adapter Interface
```typescript
interface AgentAdapter {
// Agent identifier
name: AgentType;
// Display name
displayName: string;
// Skill file format
format: 'skill-md' | 'mdc' | 'markdown';
// Project skills directory (relative)
skillsDir: string;
// Global skills directory (with ~)
globalSkillsDir: string;
// Config file name
configFile: string;
// Generate config from skills
generateConfig(skills: Skill[]): string;
// Parse existing config
parseConfig(content: string): Skill[];
}
```
## Agent Types
```typescript
type AgentType =
| 'claude-code'
| 'cursor'
| 'codex'
| 'gemini-cli'
| 'opencode'
| 'antigravity'
| 'amp'
| 'clawdbot'
| 'droid'
| 'github-copilot'
| 'goose'
| 'kilo'
| 'kiro-cli'
| 'roo'
| 'trae'
| 'windsurf'
| 'universal';
```
## Format Details
### SKILL.md Format
Used by most agents. YAML frontmatter + Markdown content:
```markdown
---
name: my-skill
description: What this skill does
---
# My Skill
Instructions...
```
### MDC Format (Cursor)
Cursor-specific format with globs and alwaysApply:
```
---
description: What this skill does
globs: ["**/*.tsx"]
alwaysApply: false
---
Instructions...
```
### Markdown Format
Plain markdown used by Windsurf and Copilot:
```markdown
# Skill Name
Instructions for the agent...
```
## Documentation
+171 -18
View File
@@ -1,39 +1,192 @@
# @skillkit/cli
CLI commands for SkillKit - install, manage, and sync skills across AI agents.
[![npm version](https://img.shields.io/npm/v/@skillkit/cli.svg)](https://www.npmjs.com/package/@skillkit/cli)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 17 AI coding agents.
## Installation
```bash
npm install @skillkit/cli
npm install -g @skillkit/cli
# or
npm install -g skillkit # includes CLI
```
## Commands
## Quick Start
```bash
skillkit init # Initialize skillkit in project
skillkit install <skill> # Install a skill
skillkit remove <skill> # Remove a skill
skillkit list # List installed skills
skillkit update # Update installed skills
skillkit sync # Sync skills across agents
skillkit translate # Translate skills between formats
skillkit recommend # Get skill recommendations
skillkit context # Manage project context
skillkit ui # Launch interactive TUI
# Get skill recommendations for your project
skillkit recommend
# Install skills from GitHub
skillkit install anthropics/skills
# Translate skills between agents
skillkit translate my-skill --to cursor
# Launch interactive TUI
skillkit ui
```
## Usage
## All Commands
### Skill Management
```bash
skillkit install <source> # Install 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 disable <skills> # Disable specific skills
skillkit sync # Sync to agent config
skillkit read <skills> # Read skill content
```
### Discovery & Recommendations
```bash
skillkit recommend # Project-based recommendations
skillkit recommend --search "auth" # Task-based search
skillkit recommend --category security # Filter by category
skillkit recommend --min-score 80 # Quality threshold
skillkit marketplace # Browse skills
skillkit marketplace search "react" # Search marketplace
skillkit marketplace --tags typescript # Filter by tags
skillkit marketplace refresh # Refresh index
```
### Translation
```bash
skillkit translate <skill> --to <agent> # Translate single skill
skillkit translate --all --to cursor # Translate all skills
skillkit translate skill --dry-run # Preview without writing
```
### Context Management
```bash
skillkit context init # Analyze project, create context
skillkit context show # Display current context
skillkit context sync --all # Sync to all detected agents
skillkit context export # Export context file
```
### Session Memory
```bash
skillkit memory status # View memory status
skillkit memory search "auth" # Search learnings
skillkit memory list # List all learnings
skillkit memory compress # Compress observations
skillkit memory export <id> # Export as skill
skillkit memory add # Add manual learning
skillkit memory --global # Use global scope
```
### Testing & Workflows
```bash
skillkit test # Run all skill tests
skillkit test ./my-skill # Test specific skill
skillkit test --tags unit # Run tagged tests
skillkit workflow list # List workflows
skillkit workflow run <name> # Execute workflow
skillkit workflow create # Create new workflow
skillkit cicd github-action # Generate GitHub Actions
skillkit cicd gitlab-ci # Generate GitLab CI
skillkit cicd pre-commit # Generate pre-commit hook
```
### Utilities
```bash
skillkit init # Initialize in project
skillkit init --agent cursor # Initialize for specific agent
skillkit validate ./skill # Validate skill format
skillkit create my-skill # Create new skill
```
## Install Options
```bash
skillkit install owner/repo # GitHub repository
skillkit install gitlab:owner/repo # GitLab repository
skillkit install ./local/path # Local directory
# Options
--list # List available skills without installing
--skills=pdf,xlsx # Install specific skills
--all # Install all discovered skills
--yes # Skip confirmation prompts
--global # Install globally
--force # Overwrite existing
--agent=cursor,windsurf # Install to specific agents
```
## Programmatic Usage
```typescript
import { installCommand, listCommand, syncCommand } from '@skillkit/cli';
import {
installCommand,
listCommand,
syncCommand,
translateCommand,
recommendCommand,
} from '@skillkit/cli';
// Programmatic access to CLI commands
await installCommand('github.com/owner/repo:skill-name');
await listCommand();
// Install skills programmatically
await installCommand('anthropics/skills', {
agent: ['claude-code', 'cursor'],
yes: true,
});
// List installed skills
const skills = await listCommand({ json: true });
// Sync to agent
await syncCommand({ all: true });
// Translate skill
await translateCommand('my-skill', {
to: 'cursor',
dryRun: false,
});
// Get recommendations
const recs = await recommendCommand({
path: './my-project',
minScore: 70,
});
```
## CI/CD Usage
```yaml
# GitHub Actions example
- name: Setup skills
run: |
npx skillkit install owner/skills --skills=lint,test --yes
npx skillkit sync --yes
```
## Supported Agents
| Agent | Format |
|-------|--------|
| Claude Code | SKILL.md |
| Cursor | MDC (.mdc) |
| Codex | SKILL.md |
| Gemini CLI | SKILL.md |
| Windsurf | Markdown |
| GitHub Copilot | Markdown |
| + 11 more | SKILL.md |
## Documentation
Full documentation: https://github.com/rohitg00/skillkit
+189 -17
View File
@@ -1,6 +1,9 @@
# @skillkit/core
Core functionality for SkillKit - skill discovery, parsing, translation, and context management.
[![npm version](https://img.shields.io/npm/v/@skillkit/core.svg)](https://www.npmjs.com/package/@skillkit/core)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Core engine for SkillKit** - skill discovery, cross-agent translation, recommendations, session memory, testing, and workflow orchestration.
## Installation
@@ -8,34 +11,203 @@ Core functionality for SkillKit - skill discovery, parsing, translation, and con
npm install @skillkit/core
```
## Features
## Key Features
- **Skill Discovery**: Find and parse SKILL.md files
- **Skill Translation**: Convert between agent formats (Claude Code, Cursor, Windsurf, etc.)
- **Project Context Detection**: Analyze project stack and dependencies
- **Recommendation Engine**: Smart skill suggestions based on project profile
- **Skill Discovery**: Find and parse SKILL.md files from any source
- **Cross-Agent Translation**: Convert skills between 17 agent formats (Claude Code, Cursor, Windsurf, etc.)
- **Project Context Detection**: Analyze project stack, dependencies, and configurations
- **Smart Recommendations**: AI-powered skill suggestions based on project profile
- **Session Memory**: Capture and persist learnings across AI coding sessions
- **Skill Testing**: Test framework with assertions for skill validation
- **Workflow Orchestration**: Compose skills into multi-step workflows
- **Marketplace Aggregation**: Browse and search curated skill repositories
## Usage
```typescript
import {
loadConfig,
getSearchDirs,
translateSkill,
ProjectDetector,
RecommendationEngine
} from '@skillkit/core';
### Skill Discovery
// Load skillkit config
const config = loadConfig();
```typescript
import { findAllSkills, discoverSkills, parseSkill } from '@skillkit/core';
// Find all installed skills
const skills = findAllSkills(['.claude/skills', '.cursor/skills']);
// Discover skills from a repository
const repoSkills = await discoverSkills('anthropics/skills');
// Parse a single skill file
const skill = parseSkill('./my-skill/SKILL.md');
```
### Cross-Agent Translation
```typescript
import { translateSkill, translateSkillFile, TranslatorRegistry } from '@skillkit/core';
// Translate skill content to Cursor format
const result = translateSkill(skillContent, 'cursor');
console.log(result.content); // MDC format for Cursor
// Translate a skill file
const translated = await translateSkillFile('./skill.md', 'windsurf');
// Get available translators
const registry = new TranslatorRegistry();
const formats = registry.getSupportedFormats();
```
### Project Context & Recommendations
```typescript
import { ProjectDetector, RecommendationEngine, ContextManager } from '@skillkit/core';
// Detect project context
const detector = new ProjectDetector();
const profile = await detector.analyze('./my-project');
// profile.stack includes: languages, frameworks, libraries, testing tools, etc.
// Get skill recommendations
const engine = new RecommendationEngine();
const recommendations = await engine.recommend(profile);
const recommendations = engine.recommend(profile, availableSkills);
// Returns skills sorted by match score
// Manage project context
const ctx = new ContextManager('./my-project');
await ctx.init();
const context = ctx.getContext();
```
### Session Memory
```typescript
import {
createMemoryCompressor,
createMemoryInjector,
LearningStore,
ObservationStore,
} from '@skillkit/core';
// Compress observations into learnings
const compressor = createMemoryCompressor('./my-project');
const learnings = compressor.compress();
// Inject relevant memories into prompts
const injector = createMemoryInjector('./my-project');
const memories = injector.search('authentication patterns');
// Manage learnings directly
const store = new LearningStore('./my-project');
const learning = store.add({
title: 'React hooks best practices',
content: 'Always cleanup effects...',
tags: ['react', 'hooks'],
});
```
### Skill Testing
```typescript
import { SkillTestRunner, parseTestCases } from '@skillkit/core';
// Run skill tests
const runner = new SkillTestRunner('./my-project');
const results = await runner.runAll();
// Run specific tests
const result = await runner.run('./my-skill', {
tags: ['unit'],
verbose: true,
});
// Parse test cases from skill
const testCases = parseTestCases(skillContent);
```
### Workflow Orchestration
```typescript
import { WorkflowOrchestrator, parseWorkflow, WorkflowStore } from '@skillkit/core';
// Parse and run a workflow
const workflow = parseWorkflow('./workflow.yaml');
const orchestrator = new WorkflowOrchestrator(workflow);
await orchestrator.execute();
// Manage workflows
const store = new WorkflowStore('./my-project');
const workflows = store.list();
```
### Marketplace
```typescript
import { createMarketplaceAggregator, MarketplaceSource } from '@skillkit/core';
// Browse skill marketplace
const marketplace = createMarketplaceAggregator();
const results = await marketplace.search({ query: 'react' });
// Filter by tags
const filtered = await marketplace.search({
query: 'authentication',
tags: ['security', 'auth'],
limit: 10,
});
```
## Supported Agents
The translator supports all 17 SkillKit-compatible agents:
| Agent | Format |
|-------|--------|
| Claude Code | SKILL.md |
| Cursor | MDC (.mdc) |
| Codex | SKILL.md |
| Gemini CLI | SKILL.md |
| Windsurf | Markdown |
| GitHub Copilot | Markdown |
| OpenCode, Antigravity, Amp, Goose, Kilo, Kiro, Roo, Trae | SKILL.md |
| Universal | SKILL.md |
## API Reference
### Skill Types
```typescript
interface CanonicalSkill {
name: string;
description?: string;
version?: string;
author?: string;
tags?: string[];
globs?: string[];
alwaysApply?: boolean;
content: string;
metadata?: Record<string, unknown>;
}
interface TranslationResult {
content: string;
format: string;
warnings?: string[];
}
```
### Context Types
```typescript
interface ProjectProfile {
name: string;
type: 'web-app' | 'api' | 'cli' | 'library' | 'unknown';
stack: {
languages: Detection[];
frameworks: Detection[];
libraries: Detection[];
testing: Detection[];
databases: Detection[];
};
}
```
## Documentation
+131 -31
View File
@@ -1,57 +1,157 @@
# @skillkit/tui
Interactive terminal UI for SkillKit - browse, install, and manage skills visually.
[![npm version](https://img.shields.io/npm/v/@skillkit/tui.svg)](https://www.npmjs.com/package/@skillkit/tui)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Interactive terminal UI for SkillKit** - browse, install, translate, and manage skills visually in your terminal.
## Installation
```bash
npm install @skillkit/tui
# or
npm install -g skillkit # includes TUI
```
## Quick Start
```bash
skillkit ui
# or just
skillkit
```
## Features
- **Browse Skills**: Discover skills from the marketplace
- **Smart Recommendations**: Project-aware skill suggestions
- **Skill Translation**: Convert between agent formats
- **Context Management**: View and sync project context
- **Keyboard Navigation**: Fast, intuitive controls
## Usage
```typescript
import { startTUI } from '@skillkit/tui';
// Launch the interactive TUI
await startTUI();
```
Or via CLI:
```bash
skillkit ui
```
- **Browse Skills**: Explore 33+ skill repositories with search and filtering
- **Smart Recommendations**: See project-aware skill suggestions with match scores
- **Cross-Agent Translation**: Convert skills between any of 17 agent formats
- **Context Management**: View detected stack and sync to all agents
- **Multi-Agent Install**: Install skills to multiple agents at once
- **Responsive Design**: Adapts to any terminal size
## Screens
- **Home**: Overview and quick actions
- **Browse**: Explore available skills
- **Recommend**: Get personalized recommendations
- **Translate**: Convert skills between formats
- **Context**: Manage project context
- **Installed**: View and manage installed skills
- **Sync**: Sync skills across agents
- **Settings**: Configure skillkit
### Home
Overview of your project and quick actions. Shows detected agents, installed skills count, and navigation hints.
### Browse (b)
Explore available skills from curated repositories. Features:
- Search skills with `/`
- Filter by tags
- View skill details
- One-key installation
### Recommend (r)
AI-powered skill suggestions based on your project:
- Analyzes your package.json, configs, and file structure
- Shows match percentage for each skill
- Explains why skills are recommended
- Filter by minimum score
### Translate (t)
Convert skills between agent formats:
- Select source skill
- Choose target agent(s)
- Preview translation
- Apply with confirmation
### Context (c)
View and manage project context:
- Detected languages and frameworks
- Found testing tools and databases
- Installed agents
- Sync context to all agents
### Installed (l)
Manage your installed skills:
- View all installed skills
- Enable/disable skills
- Remove skills
- Update from source
### Sync (s)
Sync skills across agents:
- Select target agents
- Preview changes
- Apply sync
### Settings (,)
Configure SkillKit:
- Default agent
- Auto-sync settings
- Skill directories
## Keyboard Shortcuts
| Key | Action |
|-----|--------|
| `↑/↓` | Navigate |
| `Enter` | Select |
| `h` | Home screen |
| `b` | Browse skills |
| `r` | Recommendations |
| `t` | Translate skills |
| `c` | Context management |
| `l` | List installed |
| `s` | Sync skills |
| `,` | Settings |
| `↑/↓` | Navigate lists |
| `Enter` | Select / Confirm |
| `/` | Search |
| `m` | Multi-select mode |
| `Tab` | Switch focus |
| `Esc` | Go back |
| `?` | Help |
| `q` | Quit |
## Programmatic Usage
```typescript
import { startTUI, TUIOptions } from '@skillkit/tui';
// Launch with defaults
await startTUI();
// Launch with options
await startTUI({
projectPath: './my-project',
initialScreen: 'browse',
theme: 'dark',
});
```
## Architecture
Built with:
- **Ink** - React for CLIs
- **React** - Component architecture
- **@skillkit/core** - Core functionality
```
src/
├── app.tsx # Main app component
├── screens/ # Screen components
│ ├── Home.tsx
│ ├── Browse.tsx
│ ├── Recommend.tsx
│ ├── Translate.tsx
│ ├── Context.tsx
│ └── ...
├── components/ # Reusable UI components
│ ├── SkillCard.tsx
│ ├── AgentSelector.tsx
│ └── ...
└── hooks/ # React hooks
├── useSkills.ts
├── useContext.ts
└── ...
```
## Terminal Requirements
- Minimum: 80x24 characters
- Recommended: 120x40 characters
- Supports: True Color, 256 colors, basic ANSI
## Documentation
Full documentation: https://github.com/rohitg00/skillkit