Files
Rohit Ghumare 6eb06f647d fix(agents): getAllAdapters returns correct agent types
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').
2026-01-29 19:19:35 +00:00
..

@skillkit/agents

npm version License

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