Merge pull request #20 from Soumyadas15/marketing

docs: add Claude Code skill install + first-run permission setup

Author: Soumyadas15

README.md

@@ -68,6 +68,31 @@ The setup script installs Rust (if needed), builds the CLI, installs it to `~/.c
 cargo install --git https://github.com/kortix-ai/agent-computer-use --path cli
 ```
 
+## Use with Claude Code, Cursor, Codex, Copilot, …
+
+agent-cu ships as a skill on [skills.sh](https://skills.sh). Install it and your AI agent will drive `agent-cu` directly whenever you ask it to operate a desktop app.
+
+```bash
+npx skills add kortix-ai/agent-computer-use -a claude-code -g
+```
+
+The `-a claude-code` flag installs for Claude Code; drop it to pick interactively from [40+ supported agents](https://skills.sh) (Cursor, Codex, Copilot, OpenCode, Cline, VS Code, etc.). `-g` installs globally — available in every project.
+
+### First-run setup (optional)
+
+The first time your agent runs an `agent-cu` command, Claude Code (or whichever agent you use) will ask for approval. You can:
+
+- **Approve once**: pick _"Yes, and don't ask again for: `agent-cu _`"\* — saved to project settings
+- **Preconfigure globally**: add this to `~/.claude/settings.json`:
+
+  ```json
+  {
+    "permissions": {
+      "allow": ["Bash(agent-cu *)"]
+    }
+  }
+  ```
+
 ## Quick start
 
 ```bash

skills/agent-computer-use/SKILL.md

@@ -12,6 +12,15 @@ metadata:
 
 You have access to `agent-cu`, a CLI tool that controls desktop applications. You can click buttons, type text, read screens, scroll, drag files, move windows — all from the terminal.
 
+## First-run setup (user action)
+
+The first time you run an `agent-cu` command, Claude Code will prompt the user to approve it. Tell the user they have two options:
+
+1. **Quick**: pick _"Yes, and don't ask again for: `agent-cu _`"\* — one-time approval, saved automatically
+2. **Preconfigure**: add to `~/.claude/settings.json` → `permissions.allow`: `"Bash(agent-cu *)"`
+
+After that, all agent-cu subcommands run without prompts. Do not attempt to modify the user's settings file yourself — only the user should grant this permission.
+
 ## How to think
 
 **Think like a human sitting at the computer.** Before you act, ask yourself: what would I see on screen? What would I click? What would I type?