* feat: implement phases 12-18 - complete agentic development platform This comprehensive update implements 7 major phases (12-18) transforming SkillKit into a universal agentic development platform with methodology packs, hooks, orchestration, planning, and AI capabilities. Phase 12: Methodology Framework - MethodologyManager for pack-based methodology distribution - 5 methodology packs (testing, debugging, planning, collaboration, meta) - 13 curated methodology skills - Pack loader with validation and installation - 56 comprehensive tests Phase 13: Hooks & Automatic Triggering System - HookManager with event-driven skill activation - 10+ event types (session:start, file:open, task:start, etc.) - Pattern-based triggers with glob support - Agent-specific hook generation - 29 comprehensive tests Phase 14: Subagent Orchestration - TeamOrchestrator for multi-agent coordination - TaskManager with cross-agent assignment - Plan approval workflow (submit → approve/reject) - TeamMessageBus for agent communication - Two-stage review system (spec compliance + code quality) - 36 comprehensive tests Phase 15: Structured Plan System - PlanParser for markdown → structured plan conversion - PlanValidator for completeness checking - PlanExecutor with dry-run support - Bite-sized task format (2-5 min atomic tasks) - 36 comprehensive tests Phase 16: Slash Commands & Agent Integration - CommandRegistry for slash command management - Agent-specific command generation (Claude, Cursor, OpenCode) - Command aliases and arguments support - 42 comprehensive tests Phase 17: Enhanced Agent Features - Permission system (allow/deny/ask patterns) - Glob pattern matching for file-scoped skills - Bootstrap files (AGENTS.md, SOUL.md, TOOLS.md) - Multi-mode support (Code/Architect/Debug/Ask) - Agent feature tests Phase 18: Advanced Features (AI & Audit) - AIManager with natural language skill search - Automatic skill generation from examples/code - MockAIProvider for testing without API keys - AuditLogger with complete operation trail - Query, export (JSON/CSV/text), and statistics - 37 comprehensive tests (15 AI + 22 audit) CLI Commands Added: - skillkit methodology list|install|sync - skillkit hook add|remove|list|generate - skillkit plan parse|validate|execute|create - skillkit commands generate|list - skillkit ai search|generate|similar - skillkit audit log|export|stats|clear TUI Enhancements: - Methodology screen (o key) for pack browsing - Plan screen (n key) for plan viewing/execution - Updated navigation and sidebar Test Coverage: - Total: 619 tests passing (582 core + 49 agents + 1 cli + 3 app) - New: 245+ tests for phases 12-18 - Coverage maintained at 80%+ Breaking Changes: None Dependencies: No new external dependencies added * fix: apply CodeRabbit security and quality improvements Security Fixes: - Replace custom glob-to-regex with minimatch to prevent ReDoS vulnerabilities - Fix regex pattern generation in globs.ts using battle-tested library - Eliminate unsafe regex patterns in modes.ts and permissions.ts Code Quality Improvements: - Use shared GlobMatcher utility to eliminate code duplication in modes.ts - Preserve command metadata on updates to prevent data loss - Fix single-file vs directory output path handling in command.ts - Pass --strict flag through to plan validator Race Condition & Concurrency Fixes: - Add Promise-based mutex to prevent race condition in audit logger flush() - Handle both sync and async event listeners to prevent unhandled rejections - Maintain synchronous event emission while safely handling async listeners Data Integrity Fixes: - Fix dependency checking to detect missing dependencies - Rehydrate Date fields when importing tasks from JSON - Fix executePlan to properly detect incomplete tasks State Management: - Add validation for missing step executor (fail fast) - Handle cancellation and reset executor state in finally block - Add 'cancelled' status and event to PlanStatus/PlanEvent types Dependencies: - Add minimatch@^10.0.1 to @skillkit/agents package All 639 tests passing. * docs: update READMEs with Phase 10-18 features - Root README: add minimal "What's New in v1.5.0" section with 5 bullet points - packages/core: add usage examples for Team, Plugin, Methodology, Orchestration, Plan, Hooks - packages/cli: add command sections for team, plugin, methodology, plan, hook, command - packages/tui: add screen descriptions for Marketplace, Workflow, Execute, Team, Plugins, Methodology, Plan, Memory - apps/skillkit: expand with practical usage examples for all new features All updates are clean, user-focused, and avoid AI marketing fluff. * fix: resolve multiple code quality and robustness issues - Fix minimatch dependency: downgrade to ^9.0.0 for Node 18 compatibility - Fix command.ts export: handle directory paths and ensure parent directories exist - Fix command.ts merge: preserve curated examples when merging commands - Fix plan.ts: filter empty entries from comma-separated inputs - Fix audit logger pagination: respect explicit 0 for limit and offset - Fix audit logger: gracefully handle malformed JSON lines without data loss - Fix team orchestrator: prevent task assignment to non-idle agents - Fix plan executor: unblock waitIfPaused() when cancel() is called All 639 tests passing. * fix: additional robustness improvements for plan and executor - Fix plan.ts createPlan: filter empty strings from techStack after split/trim - Fix executor.ts: re-check abort signal after waitIfPaused() in both execute() and executeTask() to prevent running additional tasks/steps after cancellation during pause All 639 tests passing.
11 KiB
SkillKit
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.
npm install -g skillkit
What's New in v1.5.0
- Team Collaboration: Share skill bundles with your team via Git
- Plugin System: Extend SkillKit with custom translators, providers, and commands
- Methodologies: 5 ready-to-use development frameworks (Agile, TDD, DevOps, etc.)
- Agent Orchestration: Coordinate multiple AI agents working together
- Hooks & Automation: Auto-trigger skills on git commits, file changes
The Problem
You've built amazing skills for Claude Code. Now you want to try Cursor. Or your team uses different agents. Your options:
- Rewrite everything - each agent has different formats, directories, and conventions
- Pick one agent - lock yourself in, miss out on innovations
- Give up on skills - lose the productivity gains
The Solution
# 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
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 (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
# 1. Install SkillKit globally
npm install -g skillkit
# 2. Launch the interactive TUI (easiest way to start)
skillkit
# Or use CLI commands directly:
# 3. Get personalized skill recommendations
skillkit recommend
# 4. Install skills from the marketplace
skillkit install anthropics/skills
# 5. Sync to your AI agent
skillkit sync
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
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:
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 (17)
| 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
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 disable <skills> # Disable specific skills
skillkit sync # Sync skills to agent config
skillkit read <skills> # Read skill content for AI
Discovery & Recommendations
skillkit recommend # Get smart recommendations
skillkit marketplace # Browse skill marketplace
skillkit marketplace search # Search marketplace
Translation & Context
skillkit translate # Translate between formats
skillkit context init # Initialize project context
skillkit context sync # Sync context to agents
Memory System
skillkit memory status # View memory status
skillkit memory search # Search learnings
skillkit memory compress # Compress observations
skillkit memory export # Export as skill
Testing & Workflows
skillkit test # Run skill tests
skillkit workflow run # Execute workflow
skillkit cicd # Generate CI/CD templates
Utilities
skillkit init # Initialize in project
skillkit validate # Validate skill format
skillkit create # Create new skill
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);
Popular Skill Repositories
| Repository | Description |
|---|---|
| anthropics/skills | Official Claude Code marketplace - PDF, XLSX, DOCX processing |
| vercel-labs/agent-skills | React/Next.js best practices, web design guidelines |
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>
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
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 for details.
Contributing
Contributions welcome! Please read our Contributing Guidelines.
