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/agents
Agent adapters for SkillKit - configuration and detection for 45 AI coding agents.
Installation
npm install @skillkit/agents
Supported Agents (45)
| 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/ |
- |
| Amp | SKILL.md | .amp/skills/ |
- |
| Clawdbot | SKILL.md | .clawdbot/skills/ |
- |
| OpenClaw | SKILL.md | skills/ |
- |
| Cline | SKILL.md | .cline/skills/ |
- |
| CodeBuddy | SKILL.md | .codebuddy/skills/ |
- |
| CodeGPT | SKILL.md | .codegpt/skills/ |
- |
| CommandCode | SKILL.md | .commandcode/skills/ |
- |
| Continue | SKILL.md | .continue/skills/ |
~/.continue/skills/ |
| Crush | SKILL.md | .crush/skills/ |
- |
| Devin | SKILL.md | .devin/skills/ |
- |
| Droid (Factory) | SKILL.md | .factory/skills/ |
- |
| Factory | SKILL.md | .factory/skills/ |
- |
| GitHub Copilot | Markdown | .github/skills/ |
- |
| Goose | SKILL.md | .goose/skills/ |
~/.goose/skills/ |
| Kilo Code | SKILL.md | .kilocode/skills/ |
~/.kilocode/skills/ |
| Kiro CLI | SKILL.md | .kiro/skills/ |
~/.kiro/skills/ |
| MCPJam | SKILL.md | .mcpjam/skills/ |
- |
| Mux | SKILL.md | .mux/skills/ |
- |
| Neovate | SKILL.md | .neovate/skills/ |
- |
| OpenHands | SKILL.md | .openhands/skills/ |
- |
| Pi | SKILL.md | .pi/skills/ |
- |
| PlayCode Agent | SKILL.md | .playcode/skills/ |
- |
| Qoder | SKILL.md | .qoder/skills/ |
- |
| Qwen | SKILL.md | .qwen/skills/ |
- |
| Roo Code | SKILL.md | .roo/skills/ |
~/.roo/skills/ |
| Trae | SKILL.md | .trae/skills/ |
- |
| Vercel | SKILL.md | .vercel/skills/ |
- |
| Windsurf | Markdown | .windsurf/skills/ |
~/.codeium/windsurf/skills/ |
| Zencoder | SKILL.md | .zencoder/skills/ |
- |
| Aider | SKILL.md | .aider/skills/ |
- |
| Amazon Q | SKILL.md | .amazonq/skills/ |
- |
| Augment Code | SKILL.md | .augment/skills/ |
- |
| Bolt | SKILL.md | .bolt/skills/ |
- |
| Lovable | SKILL.md | .lovable/skills/ |
- |
| Replit Agent | SKILL.md | .replit/skills/ |
- |
| Sourcegraph Cody | SKILL.md | .cody/skills/ |
- |
| Tabby | SKILL.md | .tabby/skills/ |
- |
| Tabnine | SKILL.md | .tabnine/skills/ |
- |
| Universal | SKILL.md | skills/ |
- |
Usage
Get Agent Adapter
import { getAdapter, AgentType } from '@skillkit/agents';
// Get adapter for specific agent
const adapter = getAdapter('claude-code');
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'
Detect Installed Agents
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
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
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
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
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
type AgentType =
| 'claude-code'
| 'cursor'
| 'codex'
| 'gemini-cli'
| 'opencode'
| 'antigravity'
| 'amp'
| 'clawdbot'
| 'openclaw'
| 'cline'
| 'codebuddy'
| 'codegpt'
| 'commandcode'
| 'continue'
| 'crush'
| 'devin'
| 'droid'
| 'factory'
| 'github-copilot'
| 'goose'
| 'kilo'
| 'kiro-cli'
| 'mcpjam'
| 'mux'
| 'neovate'
| 'openhands'
| 'pi'
| 'playcode-agent'
| 'qoder'
| 'qwen'
| 'roo'
| 'trae'
| 'vercel'
| 'windsurf'
| 'zencoder'
| 'aider'
| 'amazon-q'
| 'augment-code'
| 'bolt'
| 'lovable'
| 'replit-agent'
| 'sourcegraph-cody'
| 'tabby'
| 'tabnine'
| 'universal';
Format Details
SKILL.md Format
Used by most agents. YAML frontmatter + Markdown content:
---
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:
# Skill Name
Instructions for the agent...
Documentation
Full documentation: https://github.com/rohitg00/skillkit
License
Apache-2.0