Skip to content

supported-tools.md

Latest commit

 

History

History
154 lines (111 loc) · 5.1 KB

supported-tools.md

File metadata and controls

154 lines (111 loc) · 5.1 KB

Supported Tools

aimgr supports installing AI resources to multiple AI coding tools. This reference documents which tools are supported and what resource types each tool accepts.

Tool Support Matrix

Tool Commands Skills Agents Directory
Claude Code Yes Yes Yes .claude/
OpenCode Yes Yes Yes .opencode/
Windsurf - Yes - .windsurf/skills/
GitHub Copilot - Yes Yes .github/skills/, .github/agents/

Key:

  • Commands: Slash commands (e.g., /review, /deploy)
  • Skills: Agent skills that provide specialized knowledge or workflows
  • Agents: Custom agent definitions with specific behaviors

Tool Details

Claude Code

Claude Code is Anthropic's AI coding assistant.

Property Value
Config Directory .claude/
Commands Path .claude/commands/
Skills Path .claude/skills/
Agents Path .claude/agents/
CLI Alias claude

Documentation:

OpenCode

OpenCode is an open-source AI coding assistant that runs in your terminal.

Property Value
Config Directory .opencode/
Commands Path .opencode/commands/
Skills Path .opencode/skills/
Agents Path .opencode/agents/
CLI Alias opencode

Documentation:

Windsurf

Windsurf is Codeium's AI-powered IDE built on VSCode.

Property Value
Config Directory .windsurf/
Skills Path .windsurf/skills/
Commands Not supported
Agents Not supported
CLI Alias windsurf

Documentation:

GitHub Copilot (VSCode)

GitHub Copilot is GitHub's AI pair programmer, integrated into VSCode.

Property Value
Config Directory .github/
Skills Path .github/skills/
Agents Path .github/agents/
Commands aimgr direct install not supported
Agents aimgr direct install supported (.agent.md installed artifacts)
CLI Aliases copilot, vscode

Documentation:

Validated upstream conventions (March 2026):

  • Agent Skills live under .github/skills/<skill-name>/SKILL.md
  • VS Code custom agents live under .github/agents/*.agent.md
  • VS Code slash commands are prompt files under .github/prompts/*.prompt.md
  • Copilot CLI also supports slash commands/reusable prompts and plugin-defined commands, but that model is not the same as aimgr's current command resource type

aimgr contract:

  • aimgr installs Copilot skills and agents
  • Copilot agents are installed as .github/agents/<name>.agent.md
  • Repository source agents remain standard aimgr logical resources in agents/<name>.md
  • aimgr does not currently install VS Code prompt files
  • aimgr does not map generic commands/*.md resources to Copilot prompt files automatically

Resource Formats

Important: Resource file formats (SKILL.md structure, frontmatter fields, markdown syntax) are defined by the tools themselves and the AgentSkills.io skill format specification, not by aimgr.

aimgr's responsibility is:

  • Managing and organizing resources in a central repository
  • Installing resources to the correct tool directories via symlinks
  • Syncing resources from remote sources
  • Applying field mappings for tool-specific values

For resource format specifications, refer to:

  • AgentSkills.io - Community skill format specification
  • Individual tool documentation (linked above)

Configuration

Setting Default Tools

Configure which tools to install to by default in ~/.config/aimgr/aimgr.yaml:

install:
  targets:
    - claude
    - opencode

Per-Install Override

Override default targets for a single installation:

aimgr install skill/code-review --target windsurf

Multi-Tool Installation

Install to multiple tools at once:

aimgr install skill/code-review --target claude --target opencode

Auto-Detection

When installing to a project, aimgr automatically detects which tools are already configured by checking for tool-specific directories:

  • .claude/ - Claude Code detected
  • .opencode/ - OpenCode detected
  • .github/skills/ or .github/agents/ - GitHub Copilot detected (once)
  • .windsurf/skills/ - Windsurf detected

If tool directories already exist, aimgr installs to those tools. If no tool directories exist, it uses your configured default targets.

See Also