docs: Comprehensive agent support documentation update

.gemini/skills/correct-skill-name/.skilz-manifest.yaml

@@ -1,7 +1,7 @@
-installed_at: '2026-01-22T05:18:22+00:00'
+installed_at: '2026-01-22T23:55:39+00:00'
 skill_id: local/correct-skill-name
 git_repo: local
-skill_path: /private/var/folders/tm/chrvt43s3rbdld20ghw1qtc40000gn/T/tmpgt2y792z/wrong-name-skill
+skill_path: /private/var/folders/tm/chrvt43s3rbdld20ghw1qtc40000gn/T/tmpc6fubrle/wrong-name-skill
 git_sha: local
 skilz_version: 1.9.4
 install_mode: copy

.gemini/skills/test-skill/.skilz-manifest.yaml

@@ -1,7 +1,7 @@
-installed_at: '2026-01-22T05:18:22+00:00'
+installed_at: '2026-01-22T23:55:39+00:00'
 skill_id: git/test-skill
 git_repo: https://github.com/test/repo
-skill_path: /private/var/folders/tm/chrvt43s3rbdld20ghw1qtc40000gn/T/tmpgfyo5_mm/test-skill
+skill_path: /private/var/folders/tm/chrvt43s3rbdld20ghw1qtc40000gn/T/tmp1vvacq8_/test-skill
 git_sha: local
 skilz_version: 1.9.4
 install_mode: copy

README.md

@@ -8,6 +8,8 @@
 
 Skilz installs and manages AI skills (agents and tools) across multiple AI coding assistants. Think `npm install` or `pip install`, but for skills.
 
+Skilz follows the [agentskills.io](https://agentskills.io/) standard and supports the [AGENTS.md](https://agents.md/) ecosystem.
+
 **Built by [Spillwave](https://spillwave.com)** — Leaders in agentic software development.
 
 **Browse skills at [Skillzwave.ai](https://skillzwave.ai)** — The largest agent and agent skills marketplace.
@@ -305,26 +307,64 @@ For complete documentation including troubleshooting and advanced examples, see
 
 ## Supported Agents
 
-Skilz supports 14 AI coding assistants:
-
-| Agent | User-Level | Project-Level | Default Mode |
-|-------|------------|---------------|--------------|
-| Claude Code | `~/.claude/skills/` | `.claude/skills/` | copy |
-| OpenAI Codex | `~/.codex/skills/` | `.codex/skills/` | copy |
-| OpenCode CLI | `~/.config/opencode/skill/` | `.opencode/skill/` | copy |
-| Universal | `~/.skilz/skills/` | `.skilz/skills/` | copy |
-| Gemini CLI | - | `.skilz/skills/` | copy |
-| GitHub Copilot | - | `.github/skills/` | copy |
-| Cursor | - | `.skills/skills/` | copy |
-| Aider | - | `.skills/skills/` | copy |
-| Windsurf | - | `.skills/skills/` | copy |
-| Qwen CLI | - | `.skills/skills/` | copy |
-| Kimi CLI | - | `.skills/skills/` | copy |
-| Crush | - | `.skills/skills/` | copy |
-| Plandex | - | `.skills/skills/` | copy |
-| Zed AI | - | `.skills/skills/` | copy |
-
-For detailed agent-specific instructions, see the [Comprehensive User Guide](docs/COMPREHENSIVE_USER_GUIDE.md)
+Skilz supports **22+ AI coding agents** from the [AGENTS.md](https://agents.md/) ecosystem, including Claude Code, OpenAI Codex, Gemini CLI, GitHub Copilot, Cursor, Aider, Windsurf, Zed AI, RooCode, Devin, Google Antigravity, and many more.
+
+### Skill Support Levels
+
+| Level | Description | Example Agents |
+|-------|-------------|----------------|
+| **Full Support** | Native skill directories at user or project level | Claude Code, OpenCode, Codex |
+| **Project Support** | Project-level installation via `--project` | Cursor, Aider, Gemini CLI |
+| **Universal** | Any AGENTS.md-compatible agent via `--agent universal` | Ona, Amp, Devin, Factory, Jules |
+
+### Full Skill Support (Native Directories)
+
+Agents with dedicated skill directories - skills install to user or project level.
+
+| Agent | User-Level | Project-Level | Notes |
+|-------|------------|---------------|-------|
+| Claude Code | `~/.claude/skills/` | `.claude/skills/` | Uses CLAUDE.md (not AGENTS.md) |
+| OpenCode CLI | `~/.config/opencode/skill/` | `.opencode/skill/` | Reads AGENTS.md |
+| OpenAI Codex | `~/.codex/skills/` | `.codex/skills/` | Reads AGENTS.md |
+| Cursor | - | `.skills/skills/` | Project only |
+| Aider | - | `.skilz/skills/` | Project only |
+| Windsurf | - | `.skilz/skills/` | Project only |
+| Zed AI | - | `.skilz/skills/` | Project only |
+| RooCode | - | `.skilz/skills/` | Project only |
+
+### Project-Only Support
+
+Agents that work with project-level skills via `--project` flag.
+
+| Agent | Project-Level | Config File | Notes |
+|-------|---------------|-------------|-------|
+| Gemini CLI | `.gemini/skills/` | - | Reads AGENTS.md natively |
+| GitHub Copilot | `.github/skills/` | - | Reads AGENTS.md natively |
+| Qwen CLI | `.skilz/skills/` | AGENTS.md | Via universal |
+| Kimi CLI | `.skilz/skills/` | AGENTS.md | Via universal |
+
+### Universal Support (AGENTS.md Compatible)
+
+All agents from the [agents.md](https://agents.md/) ecosystem work via `--agent universal --project`.
+
+| Agent | Provider | Installation Command |
+|-------|----------|---------------------|
+| Ona | - | `skilz install skill --agent universal --project` |
+| Amp | Sourcegraph | `skilz install skill --agent universal --project` |
+| Kilo Code | - | `skilz install skill --agent universal --project` |
+| Devin | Cognition | `skilz install skill --agent universal --project` |
+| Factory | Factory | `skilz install skill --agent universal --project` |
+| Jules | Google | `skilz install skill --agent universal --project` |
+| Phoenix | - | `skilz install skill --agent universal --project` |
+| Goose | - | `skilz install skill --agent universal --project` |
+| Warp | Warp | `skilz install skill --agent universal --project` |
+| VS Code | Microsoft | `skilz install skill --agent universal --project` |
+| Semgrep | Semgrep | `skilz install skill --agent universal --project` |
+| Autopilot | UiPath | `skilz install skill --agent universal --project` |
+
+**Note:** Universal support works with any agent that reads the AGENTS.md config file format. Skills are installed to `.skilz/skills/` and referenced in the project's AGENTS.md file.
+
+For detailed agent-specific instructions, see the [Supported Agents Guide](docs/SUPPORTED_AGENTS.md) and [Comprehensive User Guide](docs/COMPREHENSIVE_USER_GUIDE.md)
 
 ---
 
@@ -527,7 +567,7 @@ This enables:
 | Private repositories | ✓ | ✗ | ✓ |
 | Version pinning | ✓ | ✗ | Manual |
 | Install manifest | ✓ | ✗ | ✗ |
-| Cross-agent support | ✓ (14 agents) | ✗ | ✗ |
+| Cross-agent support | ✓ (22+ agents) | ✗ | ✗ |
 | Symlink mode | ✓ | ✗ | ✓ |
 
 ---
@@ -555,7 +595,7 @@ This enables:
 
 ### Phase 6-7 - Multi-Agent Support (Complete)
 
-- [x] 14 AI agent support (Claude, Codex, Gemini, Copilot, Cursor, Aider, etc.)
+- [x] 22+ AI agent support via AGENTS.md ecosystem
 - [x] Universal skills directory (`~/.skilz/skills/`)
 - [x] Copy vs symlink installation modes
 - [x] Config file sync (agentskills.io standard)
@@ -671,7 +711,9 @@ PYTHONPATH=src python -m skilz --version               # Test CLI
 
 ## Vision
 
-**Skilz brings Anthropic's skills system to all AI agents.**
+**Skilz brings skills to all AI agents via the [AGENTS.md](https://agents.md/) standard.**
+
+Skilz follows the [agentskills.io](https://agentskills.io/) standard for skill format and supports the full AGENTS.md ecosystem of 22+ coding agents.
 
 For Claude Code users:
 - Install skills from any GitHub repository
@@ -680,7 +722,7 @@ For Claude Code users:
 - Version-control skills in your own repositories
 
 For other agents:
-- Universal access to Claude's skills ecosystem
+- Universal access to Claude's skills ecosystem via AGENTS.md
 - Use Anthropic marketplace skills via GitHub
 - Progressive disclosure — load skills on demand
 

docs/COMPREHENSIVE_USER_GUIDE.md

@@ -4,7 +4,7 @@
 
 [![PyPI version](https://badge.fury.io/py/skilz.svg)](https://pypi.org/project/skilz/)
 
-Skilz is like npm or pip, but for AI coding assistants. It lets you install, manage, and share skills across 14+ AI agents including Claude Code, OpenAI Codex, Gemini CLI, GitHub Copilot, and more.
+Skilz is like npm or pip, but for AI coding assistants. It lets you install, manage, and share skills across 22+ AI agents from the AGENTS.md ecosystem, including Claude Code, OpenAI Codex, Gemini CLI, GitHub Copilot, Cursor, Aider, Windsurf, Zed AI, RooCode, Devin, Google Antigravity, and many more.
 
 **Browse skills:** [skillzwave.ai](https://skillzwave.ai) — The largest agent and agent skills marketplace
 **Built by:** [Spillwave](https://spillwave.com) — Leaders in agentic software development
@@ -17,7 +17,7 @@ Skilz is like npm or pip, but for AI coding assistants. It lets you install, man
 2. [Understanding Agents](#understanding-agents)
 3. [Installation Modes: Copy vs Symlink](#installation-modes-copy-vs-symlink)
 4. [User-Level vs Project-Level Installation](#user-level-vs-project-level-installation)
-5. [Agent Reference](#agent-reference)
+5. [Agent Reference](#agent-reference) | [Full Agent List](SUPPORTED_AGENTS.md)
 6. [Command Reference](#command-reference)
 7. [Search Paths and Resolution Order](#search-paths-and-resolution-order)
 8. [Configuration File](#configuration-file)
@@ -49,7 +49,7 @@ skilz read algorithmic-art
 
 ## Understanding Agents
 
-Skilz supports 14 AI coding assistants. Each agent has different capabilities:
+Skilz supports 22+ AI coding agents from the AGENTS.md ecosystem. Each agent has different capabilities:
 
 | Agent | Display Name | Home Support | Native Skills | Default Mode |
 |-------|--------------|--------------|---------------|--------------|

docs/SUPPORTED_AGENTS.md

@@ -0,0 +1,213 @@
+# Supported AI Coding Agents
+
+Skilz supports **22+ AI coding agents** from the [AGENTS.md](https://agents.md/) ecosystem, following the [agentskills.io](https://agentskills.io/) standard for skill format and installation.
+
+## Agent Categories
+
+### Full Skill Support (Native Directories)
+
+Agents with dedicated skill directories at user or project level.
+
+#### Claude Code
+**Provider:** Anthropic
+**Website:** [claude.ai/code](https://claude.ai/code)
+**Description:** Claude Code is Anthropic's native coding assistant with deep integration into their AI platform. It provides intelligent code completion, refactoring, and multi-file editing capabilities.
+**Skill Directory:** `~/.claude/skills/` (user-level), `.claude/skills/` (project-level)
+**Notes:** Uses CLAUDE.md config file (not AGENTS.md)
+
+#### OpenCode CLI
+**Provider:** OpenCode
+**Website:** [opencode.dev](https://opencode.dev)
+**Description:** OpenCode CLI is a terminal-based coding assistant that provides AI-powered code generation and editing directly in your command line.
+**Skill Directory:** `~/.config/opencode/skill/` (user-level), `.opencode/skill/` (project-level)
+**Notes:** Reads AGENTS.md natively
+
+#### OpenAI Codex
+**Provider:** OpenAI
+**Website:** [platform.openai.com](https://platform.openai.com)
+**Description:** OpenAI Codex is a general-purpose code generation model and API that underpins several AI coding experiences. It transforms natural language instructions into code across many languages and performs structured edits on existing codebases.
+**Skill Directory:** `~/.codex/skills/` (user-level), `.codex/skills/` (project-level)
+**Notes:** Reads AGENTS.md natively
+
+#### Cursor
+**Provider:** Anysphere
+**Website:** [cursor.sh](https://cursor.sh)
+**Description:** Cursor is an AI-native code editor built around deep model integration, multi-file awareness, and repo-scale refactors. It provides tight model integration with inline edits, chat-over-repo, and structured refactors.
+**Skill Directory:** `.skills/skills/` (project-level only)
+**Notes:** Project-only installation
+
+#### Aider
+**Provider:** Paul Gauthier
+**Website:** [aider.chat](https://aider.chat)
+**Description:** Aider is a CLI-first coding agent that operates directly on local git repos, using an LLM to plan and apply code changes while keeping everything under version control. It provides precise, diff-based edits in polyglot monorepos.
+**Skill Directory:** `.skilz/skills/` (project-level only)
+**Notes:** Project-only, reads AGENTS.md via `.aider.conf.yml`
+
+#### Windsurf
+**Provider:** Cognition
+**Website:** [windsurf.io](https://windsurf.io)
+**Description:** Windsurf from Cognition is an AI-enhanced development environment that emphasizes intelligent navigation and editing of codebases. It combines navigation, search, and AI edits for quick movement through large codebases.
+**Skill Directory:** `.skilz/skills/` (project-level only)
+**Notes:** Project-only installation
+
+#### Zed AI
+**Provider:** Zed Industries
+**Website:** [zed.dev](https://zed.dev)
+**Description:** Zed is a high-performance, collaborative code editor that integrates AI-powered coding assistance and real-time pair programming features. It combines fast native performance with built-in collaboration primitives and AI features.
+**Skill Directory:** `.skilz/skills/` (project-level only)
+**Notes:** Project-only installation
+
+#### RooCode
+**Provider:** RooCode
+**Website:** [roocode.com](https://roocode.com)
+**Description:** RooCode is an AI coding agent focused on handling larger changes and scaffolding work, often integrating with tools like git and CI. It helps manage multi-file edits and feature implementations.
+**Skill Directory:** `.skilz/skills/` (project-level only)
+**Notes:** Project-only installation
+
+### Project-Only Support
+
+Agents that work with project-level skills via `--project` flag.
+
+#### Gemini CLI
+**Provider:** Google
+**Website:** [ai.google.dev](https://ai.google.dev)
+**Description:** Gemini CLI is a command-line client for interacting with Google's Gemini models, including coding workflows and agents. It provides scriptable, model-centric interface for code generation and repository modification.
+**Skill Directory:** `.gemini/skills/` (project-level)
+**Notes:** Requires `experimental.skills` plugin, reads AGENTS.md via `.gemini/settings.json`
+
+#### GitHub Copilot
+**Provider:** GitHub/Microsoft
+**Website:** [github.com/copilot](https://github.com/copilot)
+**Description:** GitHub Copilot represents the autonomous evolution of Copilot, expanding from inline completions to task-oriented multi-file edits. It leverages GitHub's ecosystem for context-aware coding assistance.
+**Skill Directory:** `.github/skills/` (project-level)
+**Notes:** Reads AGENTS.md natively
+
+#### Qwen CLI
+**Provider:** Alibaba Cloud
+**Website:** [qwenlm.ai](https://qwenlm.ai)
+**Description:** Qwen CLI provides AI-assisted coding capabilities with support for multiple programming languages and development workflows.
+**Skill Directory:** `.skilz/skills/` (project-level)
+**Notes:** Via universal agent
+
+#### Kimi CLI
+**Provider:** Moonshot AI
+**Website:** [kimi.ai](https://kimi.ai)
+**Description:** Kimi CLI offers intelligent coding assistance with natural language processing and code generation capabilities.
+**Skill Directory:** `.skilz/skills/` (project-level)
+**Notes:** Via universal agent
+
+### Universal Support (AGENTS.md Compatible)
+
+All agents from the AGENTS.md ecosystem work via `--agent universal --project`.
+
+#### Ona
+**Provider:** Independent
+**Description:** Ona provides configurable, possibly self-hostable agents that can operate over local code with flexible behavior tuning.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Amp
+**Provider:** Sourcegraph
+**Website:** [sourcegraph.com](https://sourcegraph.com)
+**Description:** Amp focuses on AI-powered developer tooling and agents for structured help across the development lifecycle.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Kilo Code
+**Provider:** Independent
+**Description:** Kilo Code provides deeper structural assistance for large-scale edits and pattern enforcement across multiple files.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Devin
+**Provider:** Cognition
+**Website:** [cognition.ai](https://cognition.ai)
+**Description:** Devin is positioned as an "AI software engineer" that can autonomously plan, code, run tests, and iterate on tasks end-to-end.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Factory
+**Provider:** Factory
+**Description:** Factory provides opinionated automation around repetitive coding tasks, codebase maintenance, and templated changes.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Jules
+**Provider:** Google
+**Description:** Jules leverages Google's LLM stack and cloud integrations to provide coding help, refactors, and multi-file edits.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Phoenix
+**Provider:** Independent
+**Description:** Phoenix offers agentic assistance that can understand and modify codebases with autonomy, focusing on debugging and iterative improvement.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Goose
+**Provider:** Independent
+**Description:** Goose provides lightweight assistants that can run in terminals, editors, or pipelines without heavy vendor lock-in.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Google Antigravity
+**Provider:** Google
+**Description:** Google Antigravity is an advanced AI coding assistant that provides intelligent code generation, refactoring, and multi-file editing capabilities. Currently supported via universal mode with plans for native integration.
+**Installation:** `skilz install skill --agent universal --project`
+**Notes:** Native support planned for future release
+
+#### Warp
+**Provider:** Warp
+**Website:** [warp.dev](https://warp.dev)
+**Description:** Warp is a next-generation terminal with structured input, rich UI, and built-in AI assistance for command composition.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### VS Code (with coding agents)
+**Provider:** Microsoft
+**Website:** [code.visualstudio.com](https://code.visualstudio.com)
+**Description:** VS Code serves as the integration hub for various AI coding extensions, acting as the default environment for many organizations.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Semgrep
+**Provider:** Semgrep
+**Website:** [semgrep.dev](https://semgrep.dev)
+**Description:** Semgrep is a static analysis engine and rule framework for code scanning, security checks, and pattern-based refactors.
+**Installation:** `skilz install skill --agent universal --project`
+
+#### Autopilot
+**Provider:** UiPath
+**Website:** [uipath.com](https://uipath.com)
+**Description:** UiPath Autopilot extends automation platform with generative AI for understanding natural language and generating workflows.
+**Installation:** `skilz install skill --agent universal --project`
+
+## Quick Reference
+
+### Native Support (User-Level)
+- Claude Code → `~/.claude/skills/`
+- OpenAI Codex → `~/.codex/skills/`
+- OpenCode CLI → `~/.config/opencode/skill/`
+- Universal → `~/.skilz/skills/`
+
+### Project-Level Support
+- Gemini CLI → `.gemini/skills/`
+- GitHub Copilot → `.github/skills/`
+- Cursor → `.skills/skills/`
+- Aider → `.skilz/skills/`
+- Windsurf → `.skilz/skills/`
+- Qwen CLI → `.skilz/skills/`
+- Kimi CLI → `.skilz/skills/`
+- Zed AI → `.skilz/skills/`
+- RooCode → `.skilz/skills/`
+
+### Universal Mode (AGENTS.md Compatible)
+All agents listed above work via: `skilz install <skill> --agent universal --project`
+
+## Configuration
+
+Most agents automatically detect and use AGENTS.md files for project-specific configuration. For agents without native support, use:
+
+```bash
+skilz install <skill-id> --agent universal --project --config AGENTS.md
+```
+
+This installs skills to `.skilz/skills/` and references them in your project's AGENTS.md file.
+
+## Getting Started
+
+1. Choose your AI coding agent from the list above
+2. Browse skills at [skillzwave.ai](https://skillzwave.ai)
+3. Install with: `skilz install <skill-id> --agent <your-agent>`
+
+For detailed setup instructions for each agent, see the [Comprehensive User Guide](COMPREHENSIVE_USER_GUIDE.md).