Add coding agent skill setup instructions to README

Documents how to install the Five9 CLI skill for Claude Code,
OpenAI Codex, and Cursor with platform-specific commands for
macOS/Linux and Windows.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: edumansky

README.md

@@ -109,6 +109,78 @@ Control output with `--output`:
 | `--debug` | Show SOAP request/response details |
 | `--dry-run` | Print write requests without executing them |
 
+## Coding Agent Skill
+
+The Five9 CLI includes a [skill](https://agentskills.io) that enables AI coding agents to query and manage your Five9 environment. It works with any agent that supports the skills standard — [Claude Code](https://claude.com/claude-code), [OpenAI Codex](https://openai.com/codex/), [Cursor](https://cursor.com), and others.
+
+### Setup
+
+1. Install the Five9 CLI (see [Install](#install))
+2. Login: `five9 login`
+3. Download the skill into the correct folder for your coding agent:
+
+#### Claude Code
+
+**macOS / Linux:**
+```bash
+mkdir -p ~/.claude/skills/five9-cli
+curl -fsSL https://raw.githubusercontent.com/Cloverhound/five9-cli/main/skill/SKILL.md \
+  -o ~/.claude/skills/five9-cli/SKILL.md
+```
+
+**Windows (PowerShell):**
+```powershell
+New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills\five9-cli"
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Cloverhound/five9-cli/main/skill/SKILL.md" `
+  -OutFile "$env:USERPROFILE\.claude\skills\five9-cli\SKILL.md"
+```
+
+#### OpenAI Codex
+
+**macOS / Linux:**
+```bash
+mkdir -p ~/.agents/skills/five9-cli
+curl -fsSL https://raw.githubusercontent.com/Cloverhound/five9-cli/main/skill/SKILL.md \
+  -o ~/.agents/skills/five9-cli/SKILL.md
+```
+
+**Windows (PowerShell):**
+```powershell
+New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills\five9-cli"
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Cloverhound/five9-cli/main/skill/SKILL.md" `
+  -OutFile "$env:USERPROFILE\.agents\skills\five9-cli\SKILL.md"
+```
+
+#### Cursor
+
+**macOS / Linux:**
+```bash
+mkdir -p ~/.cursor/skills/five9-cli
+curl -fsSL https://raw.githubusercontent.com/Cloverhound/five9-cli/main/skill/SKILL.md \
+  -o ~/.cursor/skills/five9-cli/SKILL.md
+```
+
+**Windows (PowerShell):**
+```powershell
+New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.cursor\skills\five9-cli"
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Cloverhound/five9-cli/main/skill/SKILL.md" `
+  -OutFile "$env:USERPROFILE\.cursor\skills\five9-cli\SKILL.md"
+```
+
+> These commands install the skill globally (user-level). You can also install per-project by placing the `five9-cli/SKILL.md` folder inside your project's `.claude/skills/`, `.agents/skills/`, or `.cursor/skills/` directory instead.
+
+4. If the `five9` binary is not in your `$PATH`, ask your coding agent to update the binary path in the skill file.
+
+### Example Prompts
+
+```
+/five9-cli list all skills and show which campaigns they're assigned to
+
+/five9-cli how many users are in each agent group?
+
+/five9-cli check auth status and list all dispositions
+```
+
 ## Development
 
 See [AGENTS.md](AGENTS.md) for project structure and development workflow.