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:

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()