Platform Guide

Supported Platforms

OMNISKILL supports 5 AI coding assistant platforms through adapters.

Claude Code

Target: ~/.claude/skills/ Format: Each skill becomes a SKILL.md file in a skill directory.

python scripts/install.py --platform claude-code

GitHub Copilot CLI

Target: ~/.copilot/skills/ Format: Each skill becomes a SKILL.md file with optional front-matter.

python scripts/install.py --platform copilot-cli

Cursor

Target: .cursor/rules/ (project-level) or global rules Format: Each skill becomes a .mdc rule file.

python scripts/install.py --platform cursor

Windsurf

Target: .windsurfrules or rules directory Format: Skills are compiled into rule format.

python scripts/install.py --platform windsurf

Antigravity

Target: .antigravity/skills/ Format: Each skill becomes a skill file in the expected format.

python scripts/install.py --platform antigravity

Multi-Platform Install

# Auto-detect all installed platforms
python scripts/install.py

# Install for specific platforms
python scripts/install.py --platform claude-code --platform cursor

Platform Overrides

Skills can have platform-specific behavior via overrides/:

skills/my-skill/overrides/
├── cursor.md       # Cursor-specific additions
└── windsurf.md     # Windsurf-specific additions

Overrides are merged with the base SKILL.md during adapter transformation.

Creating New Platform Adapters

To add support for a new AI coding assistant platform:

"Follow the add-adapter skill to create an adapter for [platform]"

The add-adapter skill guides you through: 1. Understanding the platform's skill/rule format 2. Creating the adapter transformation logic 3. Defining installation paths and conventions 4. Testing the adapter 5. Adding platform detection

SDK as an Alternative

For programmatic integration, use the Python SDK instead of CLI scripts:

from sdk.omniskill import OmniSkill

os = OmniSkill()

# Install to specific platform
os.install(platform="cursor", bundle="web-dev-kit")

# Validate all artifacts
errors = os.validate()

# Get platform info
platforms = os.detect_platforms()