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/core
Core engine for SkillKit - skill discovery, cross-agent translation, recommendations, session memory, testing, and workflow orchestration.
Installation
npm install @skillkit/core
Key Features
- Skill Discovery: Find and parse SKILL.md files from any source
- Cross-Agent Translation: Convert skills between 45 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
- Team Collaboration: Share skill bundles with Git-based remote sync
- Plugin System: Extend with custom translators, providers, and commands
- Methodologies: 5 development frameworks (Agile, TDD, DevOps, Design Thinking, Feature Flags)
- Multi-Agent Orchestration: Coordinate teams of AI agents with task assignment
- Plan System: Parse, validate, and execute structured development plans
- Hooks & Automation: Auto-trigger skills on file changes, git events
Usage
Skill Discovery
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
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
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 = 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
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
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
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
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,
});
Team Collaboration
import { TeamManager, SkillBundle } from '@skillkit/core';
// Initialize team
const teamManager = new TeamManager('./my-project');
await teamManager.init('Engineering Team');
// Create skill bundle
const bundle = await teamManager.createBundle('onboarding', {
skills: ['git-workflow', 'code-review'],
description: 'New developer onboarding',
});
// Share bundle
await teamManager.shareBundle(bundle);
// Sync with remote registry
await teamManager.syncWithRemote('https://github.com/myorg/skills');
Plugin System
import { PluginManager, TranslatorPlugin } from '@skillkit/core';
// Load plugins
const pluginManager = new PluginManager('./my-project');
await pluginManager.loadAll();
// Install plugin
await pluginManager.install('custom-translator');
// Create custom plugin
const myPlugin: TranslatorPlugin = {
name: 'my-agent',
parse: async (content) => ({ /* canonical skill */ }),
generate: async (skill) => '/* custom format */',
};
Methodologies
import { MethodologyManager } from '@skillkit/core';
// List available methodologies
const methodologies = await MethodologyManager.list();
// Load methodology
const tdd = await MethodologyManager.load('tdd');
// Returns: { name: 'TDD', skills: ['red-green-refactor', 'test-first'], ... }
Multi-Agent Orchestration
import { TeamOrchestrator, TaskManager } from '@skillkit/core';
// Create agent team
const orchestrator = new TeamOrchestrator();
const team = await orchestrator.createTeam({
name: 'feature-dev',
leader: { id: 'architect', name: 'System Architect' },
teammates: [
{ id: 'frontend', name: 'Frontend Dev', capabilities: ['react'] },
{ id: 'backend', name: 'Backend Dev', capabilities: ['api'] },
],
});
// Manage tasks
const taskManager = new TaskManager();
const task = taskManager.createTask('Build login', 'Create login endpoint', spec);
await taskManager.assignTask(task.id, 'backend');
// Get stats
const stats = taskManager.getStats();
Plan System
import { PlanParser, PlanValidator, PlanExecutor } from '@skillkit/core';
// Parse plan from markdown
const parser = new PlanParser();
const plan = await parser.parseFile('./plan.md');
// Validate plan
const validator = new PlanValidator();
const validation = validator.validate(plan);
// Execute plan
const executor = new PlanExecutor();
const result = await executor.execute(plan, { dryRun: false });
Hooks & Automation
import { HookRegistry } from '@skillkit/core';
// Register hooks
const hooks = new HookRegistry('./my-project');
await hooks.register('pre-commit', {
event: 'pre-commit',
skill: 'code-review',
enabled: true,
});
// Trigger hook
await hooks.trigger('pre-commit', { files: ['src/index.ts'] });
Supported Agents
The translator supports all 32 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
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
interface ProjectProfile {
name: string;
type: 'web-app' | 'api' | 'cli' | 'library' | 'unknown';
stack: {
languages: Detection[];
frameworks: Detection[];
libraries: Detection[];
testing: Detection[];
databases: Detection[];
};
}
Documentation
Full documentation: https://github.com/rohitg00/skillkit
License
Apache-2.0