Agents Overview

Supported AI coding agents and how adapters work

What Are Agents?

Agents are AI coding assistants that can be enhanced with skills. OpenSkill provides a unified interface for managing skills across different agents, regardless of how each agent stores and loads them.

Supported Agents

All agents support both global and project-level skill installations. Global skills are installed in the home directory config, while project-level skills are installed in the current project directory.

Adapter Pattern

OpenSkill uses the adapter pattern to support multiple agents. Each agent implements a standard interface:

interface Agent {
  info: AgentInfo;
  getInstalledSkills(): Promise<InstalledSkill[]>;
  installSkill(name: string, content: string, options?: InstallOptions): Promise<void>;
  uninstallSkill(name: string, options?: InstallOptions): Promise<boolean>;
}

This means all CLI commands work identically regardless of which agent you're targeting. The adapter handles the agent-specific details of where and how skills are stored.

Auto-Detection

OpenSkill automatically detects which agents are installed on your system by checking for their configuration directories. When you run a command without specifying an agent, OpenSkill will:

1. Check for installed agents
2. If only one is found, use it automatically
3. If multiple are found, prompt you to choose