Files
skillkit/packages/agents
Rohit Ghumare 821e9f714b chore: bump to 1.23.0, rewrite README, drop dead LLM SDK deps, add branded tags (#116)
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.
2026-04-21 00:25:55 +01:00
..

@skillkit/agents

npm version License

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