Skip to main content

auto-skill agents

Manage and inspect AI coding agent configurations. Auto-Skill supports 10 coding agents with cross-agent skill sharing via symlinks.

Usage

auto-skill agents [action] [options]

Actions

list
action
default:"true"
Show all known agents and their installation status
detect
action
Show only agents that are currently installed on this system

Options

--json
boolean
default:"false"
Output results in JSON format

Supported Agents

Auto-Skill supports these 10 AI coding agents:

Claude Code

Anthropic’s CLI for ClaudeSkill Directory: ~/.claude/skills

OpenCode

Open-source coding agentSkill Directory: ~/.opencode/skills

Cursor

AI-first code editorSkill Directory: ~/.cursor/skills

Continue

Continue.dev IDE extensionSkill Directory: ~/.continue/skills

Windsurf

Codeium’s AI IDESkill Directory: ~/.windsurf/skills

Aider

AI pair programming toolSkill Directory: ~/.aider/skills

Cline

AI coding agent for VS CodeSkill Directory: ~/.cline/skills

Codex CLI

OpenAI’s Codex CLI agentSkill Directory: ~/.codex/skills

Amp

Sourcegraph’s AI coding agentSkill Directory: ~/.amp/skills

GitHub Copilot

GitHub’s AI coding assistantSkill Directory: ~/.copilot/skills

Detection Strategy

Agents are detected as “installed” if any of these conditions are met:
1

Environment Variable

Agent-specific environment variable is set (indicates the agent is running)
2

Configuration File

Agent’s configuration file exists on disk
3

Skill Directory

Agent’s skill directory exists

Examples

List All Known Agents

auto-skill agents list
Known Agents (10 total)

  [installed] Claude Code (claude-code)
     Skills: /Users/username/.claude/skills
     Anthropic's CLI for Claude

  [not found] OpenCode (opencode)
     Skills: /Users/username/.opencode/skills
     Open-source coding agent

  [not found] Codex CLI (codex)
     Skills: /Users/username/.codex/skills
     OpenAI's Codex CLI agent

  [installed] Continue (continue)
     Skills: /Users/username/.continue/skills
     Continue.dev IDE extension

  [not found] Aider (aider)
     Skills: /Users/username/.aider/skills
     AI pair programming tool

  [installed] Cursor (cursor)
     Skills: /Users/username/.cursor/skills
     AI-first code editor

  [not found] Windsurf (windsurf)
     Skills: /Users/username/.windsurf/skills
     Codeium's AI IDE

  [not found] Cline (cline)
     Skills: /Users/username/.cline/skills
     AI coding agent for VS Code

  [not found] Amp (amp)
     Skills: /Users/username/.amp/skills
     Sourcegraph's AI coding agent

  [not found] GitHub Copilot (copilot)
     Skills: /Users/username/.copilot/skills
     GitHub's AI coding assistant

Detect Installed Agents Only

auto-skill agents detect
Detected Agents (3 installed)

  Claude Code (claude-code)
     Skills: /Users/username/.claude/skills

  Continue (continue)
     Skills: /Users/username/.continue/skills

  Cursor (cursor)
     Skills: /Users/username/.cursor/skills

JSON Output - List

auto-skill agents list --json
{
  "count": 10,
  "agents": [
    {
      "id": "claude-code",
      "name": "Claude Code",
      "skillDir": "/Users/username/.claude/skills",
      "installed": true,
      "description": "Anthropic's CLI for Claude"
    },
    {
      "id": "opencode",
      "name": "OpenCode",
      "skillDir": "/Users/username/.opencode/skills",
      "installed": false,
      "description": "Open-source coding agent"
    },
    {
      "id": "codex",
      "name": "Codex CLI",
      "skillDir": "/Users/username/.codex/skills",
      "installed": false,
      "description": "OpenAI's Codex CLI agent"
    }
  ]
}

JSON Output - Detect

auto-skill agents detect --json
{
  "count": 3,
  "agents": [
    {
      "id": "claude-code",
      "name": "Claude Code",
      "skillDir": "/Users/username/.claude/skills"
    },
    {
      "id": "continue",
      "name": "Continue",
      "skillDir": "/Users/username/.continue/skills"
    },
    {
      "id": "cursor",
      "name": "Cursor",
      "skillDir": "/Users/username/.cursor/skills"
    }
  ]
}

Cross-Agent Skill Sharing

Auto-Skill uses symlinks to share generated skills across all installed agents:
~/.claude/skills/auto/my-skill/     # Source skill
~/.cursor/skills/my-skill/          # Symlink → ~/.claude/skills/auto/my-skill/
~/.continue/skills/my-skill/        # Symlink → ~/.claude/skills/auto/my-skill/
Benefits:
  • Skills learned in one agent are immediately available in others
  • Single source of truth for skill content
  • No duplication or sync issues
  • Works across all 10 supported agents
Symlink creation happens automatically when Auto-Skill generates a new skill. You don’t need to manually manage symlinks.

Agent Configuration

Each agent has these properties:
id
string
required
Unique identifier (e.g., “claude-code”, “cursor”)
name
string
required
Human-readable name (e.g., “Claude Code”, “Cursor”)
skillDir
string
required
Absolute path to the agent’s skill directory
envVar
string
Environment variable that indicates the agent is running (e.g., “CLAUDE_SESSION_ID”)
configFile
string
Path to the agent’s configuration file for detection
description
string
Brief description of the agent

Initialize

Set up Auto-Skill directories for all agents

Lock Status

View locked skills across all agents

Build docs developers (and LLMs) love