name: agent-platforms description: Guide for multi-platform skill compatibility across Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot, and other AI coding agents.

Multi-Platform Agent Skills

Scope

Use this skill when:

• Ensuring skills work across multiple platforms
• Understanding platform-specific conventions
• Converting skills between platforms

Platform Compatibility Matrix

Universal SKILL.md Format

All platforms use YAML frontmatter:

---
name: skill-name
description: When to use this skill
---

# Instructions here...

Cross-Platform Installation

Most tools auto-discover skills in .agent/skills/:

# Universal installation (works with most tools)
git clone https://github.com/user/skills .agent/skills

Platform-Specific Notes

Claude Code

• Auto-discovers from .claude/skills/ and ~/.claude/skills/
• Supports /init command for context bootstrapping

Codex (OpenAI)

• Supports multiple scopes: REPO, USER, ADMIN, SYSTEM
• Built-in $skill-creator and $skill-installer
• Restart required after installing new skills

GitHub Copilot

• Skills in .github/skills/ directory
• Uses SKILL.md with name and description required
• Copilot auto-activates based on description match

Gemini CLI

• Use @ symbol to attach skill files to prompts
• Place skills in .gemini/skills/ or .agent/skills/

Conversion Tips

1. Same SKILL.md format works across platforms
2. Change only the installation path for different platforms
3. Test on each target platform before distribution
4. Document platform-specific requirements in skill README