mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-18 18:04:26 +00:00
Fixed getAllAdapters() to return the correct agent type from the record keys instead of relying on adapter.type property, which was returning 'universal' for all UniversalAdapter instances. This fixes the E2E test that checks for all 32 agents in init --list output (cline, codebuddy, commandcode, etc. were showing as 'universal').
@skillkit/agents
Agent adapters for SkillKit - configuration and detection for 32 AI coding agents.
Installation
npm install @skillkit/agents
Supported Agents (32)
| 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/ |
- |
| Cline | SKILL.md | .cline/skills/ |
- |
| CodeBuddy | SKILL.md | .codebuddy/skills/ |
- |
| CommandCode | SKILL.md | .commandcode/skills/ |
- |
| Continue | SKILL.md | .continue/skills/ |
~/.continue/skills/ |
| Crush | SKILL.md | .crush/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/ |
- |
| 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/ |
- |
| 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'
| 'cline'
| 'codebuddy'
| 'commandcode'
| 'continue'
| 'crush'
| 'droid'
| 'factory'
| 'github-copilot'
| 'goose'
| 'kilo'
| 'kiro-cli'
| 'mcpjam'
| 'mux'
| 'neovate'
| 'openhands'
| 'pi'
| 'qoder'
| 'qwen'
| 'roo'
| 'trae'
| 'vercel'
| 'windsurf'
| 'zencoder'
| '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