claude-for-safari 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SDLLL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+<h1 align="center">Claude for Safari</h1>
+
+<p align="center">
+  <strong>Give your AI Agent the power to control Safari</strong>
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://www.apple.com/macos/"><img src="https://img.shields.io/badge/macOS-only-black.svg?style=for-the-badge&logo=apple" alt="macOS"></a>
+  <a href="https://github.com/SDLLL/claude-for-safari/stargazers"><img src="https://img.shields.io/github/stars/SDLLL/claude-for-safari?style=for-the-badge" alt="GitHub Stars"></a>
+</p>
+
+<p align="center">
+  <a href="https://safari.skilljam.dev">Website</a> · <a href="#quick-start">Quick Start</a> · <a href="#features">Features</a> · <a href="#faq">FAQ</a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> | <a href="README_CN.md">中文</a>
+</p>
+
+---
+
+## Why This?
+
+You want your AI Agent to help with browser tasks — then you discover:
+
+- 🔒 **Playwright** → Separate browser instance, hijacks your session
+- 🧩 **Claude for Chrome** → Requires Chrome extension, doesn't work with Safari
+- 📝 **Copy & paste** → Manually feeding page content to AI every time
+
+**You just want AI to use your Safari, as if you were doing it yourself.**
+
+**Claude for Safari makes it one command:**
+
+```
+npx skills add SDLLL/claude-for-safari
+```
+
+After installing, tell Claude "check what's open in my Safari" — it reads and controls your real browser directly.
+
+---
+
+## Quick Start
+
+Run this in your terminal:
+
+```bash
+npx skills add SDLLL/claude-for-safari
+```
+
+Then launch [Claude Code](https://claude.ai/download):
+
+```bash
+claude
+```
+
+Say "show me what tabs are open in Safari". The agent will guide you through permission setup automatically.
+
+> Compatible with any AI Agent that supports Skills: Claude Code, Cursor, Windsurf, etc.
+
+### First-Time Setup
+
+The agent auto-detects and guides you, but you can configure ahead of time:
+
+1. **System Settings > Privacy & Security > Automation** → Allow terminal to control Safari
+2. **Safari > Settings > Advanced** → Enable "Show features for web developers"
+3. **Safari > Develop menu** → Check "Allow JavaScript from Apple Events"
+4. **(Optional) System Settings > Privacy & Security > Screen Recording** → Allow terminal (enables background screenshots)
+
+---
+
+## Features
+
+Zero install. Pure macOS native capabilities. One Skill covers all browser operations:
+
+| Capability | What the Agent Does | How |
+|---|---|---|
+| **List tabs** | List all windows and tabs with title & URL | AppleScript |
+| **Read pages** | Extract text, structured data, simplified DOM | AppleScript + JavaScript |
+| **Execute JS** | Run arbitrary JavaScript in page context | AppleScript `do JavaScript` |
+| **Screenshot** | Capture Safari window — AI can "see" the page | `screencapture` |
+| **Navigate** | Open URLs, new tabs, new windows | AppleScript |
+| **Click** | Click elements (React/Vue/Angular compatible) | JavaScript `dispatchEvent` |
+| **Type** | Fill forms, simulate keyboard input | JavaScript + System Events |
+| **Scroll** | Scroll up/down, scroll to element | JavaScript `scrollBy/scrollTo` |
+| **Switch tabs** | Switch by index or URL keyword | AppleScript |
+| **Wait for load** | Wait until page is fully loaded | JavaScript `readyState` |
+
+### Screenshot Modes
+
+| Mode | Permission Required | Window Switch | Best For |
+|---|---|---|---|
+| **Background** | Screen Recording | No switch | Recommended, seamless |
+| **Foreground** | None | Brief (~0.3s) | Default, auto-switches back |
+
+---
+
+## How It Works
+
+```
+Claude Code ──osascript──► Safari (reads/controls your real browser)
+     │
+     └──screencapture──► screenshot ──► Claude sees the page
+```
+
+No extensions. No proxy servers. No extra processes.
+
+Everything runs through macOS native AppleScript and screencapture. Websites see a real user — no automation fingerprints.
+
+---
+
+## FAQ
+
+<details>
+<summary><strong>Do I need to install anything?</strong></summary>
+
+No. This Skill relies entirely on macOS built-in AppleScript and screencapture. Just grant a few system permissions on first use.
+</details>
+
+<details>
+<summary><strong>Does it support Chrome / Firefox / Arc?</strong></summary>
+
+Safari only. For other browsers, use <a href="https://github.com/nicepkg/playwright-mcp">Playwright MCP</a> or <a href="https://github.com/Areo-Joe/chrome-acp">Chrome ACP</a>. Safari is the only macOS browser with full AppleScript automation support.
+</details>
+
+<details>
+<summary><strong>Is it safe? Will AI do random things?</strong></summary>
+
+Claude Code's permission system asks for your confirmation before every sensitive action. You can approve individually or in bulk. All operations are visible in your terminal.
+</details>
+
+<details>
+<summary><strong>The window flickers when taking screenshots?</strong></summary>
+
+Without Screen Recording permission, Safari briefly activates (~0.3s) then switches back. Grant Screen Recording permission for fully background screenshots with zero window switching.
+</details>
+
+<details>
+<summary><strong>Which AI Agents are compatible?</strong></summary>
+
+Any agent supporting Claude Code Skills: Claude Code, Cursor, Windsurf, etc.
+</details>
+
+---
+
+## License
+
+[MIT](LICENSE)

package/README_CN.md

@@ -0,0 +1,148 @@
+<h1 align="center">Claude for Safari</h1>
+
+<p align="center">
+  <strong>给你的 AI Agent 装上 Safari 浏览器操控能力</strong>
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://www.apple.com/macos/"><img src="https://img.shields.io/badge/macOS-only-black.svg?style=for-the-badge&logo=apple" alt="macOS"></a>
+  <a href="https://github.com/SDLLL/claude-for-safari/stargazers"><img src="https://img.shields.io/github/stars/SDLLL/claude-for-safari?style=for-the-badge" alt="GitHub Stars"></a>
+</p>
+
+<p align="center">
+  <a href="#快速上手">快速开始</a> · <a href="#它能做什么">功能</a> · <a href="#常见问题">FAQ</a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> | <a href="README_CN.md">中文</a>
+</p>
+
+---
+
+## 为什么需要这个？
+
+你想让 AI Agent 帮你操作浏览器——然后发现：
+
+- 🔒 **Playwright** → 独立浏览器实例，抢占用户使用
+- 🧩 **Claude for Chrome** → 需要安装 Chrome 扩展不适配 Safari
+- 📝 **手动复制粘贴** → 每次都要自己把网页内容喂给 AI，效率极低
+
+**你只是想让 AI 直接用你的 Safari，就像你自己操作一样。**
+
+**Claude for Safari 把这一切变成一句话：**
+
+```
+npx skills add SDLLL/claude-for-safari
+```
+
+安装后对 Claude 说「帮我看看 Safari 里打开了什么」，它就能直接读取、操控你的真实浏览器。
+
+---
+
+## 快速上手
+
+复制这行命令，在终端运行：
+
+```bash
+npx skills add SDLLL/claude-for-safari
+```
+
+然后启动 [Claude Code](https://claude.ai/download)：
+
+```bash
+claude
+```
+
+对它说「帮我看看 Safari 当前打开了哪些网页」。Agent 会自动引导完成权限配置。
+
+> 兼容任何支持 Skills 的 AI Agent：Claude Code、Cursor、Windsurf 等。
+
+### 前置配置（仅首次）
+
+Agent 会自动检测并引导你完成，但你也可以提前配置：
+
+1. **系统设置 > 隐私与安全性 > 自动化** → 允许终端控制 Safari
+2. **Safari > 设置 > 高级** → 开启「显示网页开发者功能」
+3. **Safari > 开发菜单** → 勾选「允许 Apple 事件的 JavaScript」
+4. **（可选）系统设置 > 隐私与安全性 > 屏幕录制** → 允许终端录屏（启用后台截图）
+
+---
+
+## 它能做什么
+
+零安装，纯 macOS 原生能力，一个 Skill 覆盖所有浏览器操作：
+
+| 能力 | Agent 做的事 | 实现方式 |
+|------|------------|---------|
+| **查看标签页** | 列出所有窗口和标签的标题、URL | AppleScript |
+| **读取页面** | 提取页面文本、结构化数据、简化 DOM | AppleScript + JavaScript |
+| **执行 JS** | 在页面上下文中运行任意 JavaScript | AppleScript `do JavaScript` |
+| **截图** | 截取 Safari 窗口画面，AI 可以"看到"页面 | `screencapture` |
+| **导航** | 打开 URL、新建标签页、新建窗口 | AppleScript |
+| **点击** | 点击页面元素（兼容 React/Vue/Angular） | JavaScript `dispatchEvent` |
+| **输入** | 填写表单、模拟键盘输入 | JavaScript + System Events |
+| **滚动** | 上下滚动、滚动到指定元素 | JavaScript `scrollBy/scrollTo` |
+| **切换标签** | 按序号或 URL 关键词切换标签页 | AppleScript |
+| **等待加载** | 等待页面加载完成后再操作 | JavaScript `readyState` |
+
+### 截图模式
+
+| 模式 | 需要权限 | 是否切换窗口 | 适用场景 |
+|------|---------|------------|---------|
+| **后台截图** | 屏幕录制权限 | 不切换 | 推荐，无感截图 |
+| **前台截图** | 无需额外权限 | 短暂切换 (~0.3s) | 默认，自动切回 |
+
+---
+
+## 工作原理
+
+```
+Claude Code ──osascript──► Safari（读取/操控你的真实浏览器）
+     │
+     └──screencapture──► 截图 ──► Claude 看到页面内容
+```
+
+没有扩展，没有代理服务器，没有额外进程。
+
+所有操作都通过 macOS 原生的 AppleScript 和 screencapture 完成，Safari 看到的就是真实用户操作。
+
+---
+
+## 常见问题
+
+<details>
+<summary><strong>需要提前安装什么吗？</strong></summary>
+
+不需要安装任何软件。本 Skill 完全依赖 macOS 内置的 AppleScript 和 screencapture，开箱即用。只需在首次使用时授予几个系统权限。
+</details>
+
+<details>
+<summary><strong>支持 Chrome / Firefox / Arc 吗？</strong></summary>
+
+目前仅支持 Safari。其他浏览器推荐使用 <a href="https://github.com/nicepkg/playwright-mcp">Playwright MCP</a> 或 <a href="https://github.com/Areo-Joe/chrome-acp">Chrome ACP</a>。Safari 是 macOS 上唯一完整支持 AppleScript 自动化的浏览器。
+</details>
+
+<details>
+<summary><strong>安全吗？AI 会不会乱操作？</strong></summary>
+
+Claude Code 的权限系统会在每次敏感操作前征求你的确认。你可以选择逐条审批或批量授权。所有操作都在你的终端中可见。
+</details>
+
+<details>
+<summary><strong>截图时窗口会闪一下？</strong></summary>
+
+如果没有授予屏幕录制权限，截图时需要短暂激活 Safari 窗口（约 0.3 秒），之后会自动切回。授予屏幕录制权限后可以实现完全后台截图，不会有任何窗口切换。
+</details>
+
+<details>
+<summary><strong>兼容哪些 AI Agent？</strong></summary>
+
+任何支持 Claude Code Skills 的 AI Agent 都能用，包括 Claude Code、Cursor、Windsurf 等。
+</details>
+
+---
+
+## License
+
+[MIT](LICENSE)

package/SKILL.md

@@ -0,0 +1,383 @@
+---
+name: claude-for-safari
+description: Control the user's real Safari browser on macOS using AppleScript and screencapture. This skill should be used when the user asks to interact with Safari, browse websites, read web pages, automate browser tasks, take screenshots of web content, or when any task would benefit from seeing or interacting with what's in their browser. Triggers on keywords like "safari", "browser", "web page", "open tab", "screenshot the page", "read this site", "browse", "click on", "fill in the form".
+---
+
+# Claude for Safari
+
+Operate the user's real Safari browser on macOS via AppleScript (`osascript`) and `screencapture`. This provides full access to the user's actual browser session — including login state, cookies, and open tabs — without any extensions or additional software.
+
+## Prerequisites
+
+Before first use, verify two settings are enabled. Run this check at the start of every session:
+
+```bash
+osascript -e 'tell application "Safari" to get name of front window' 2>&1
+```
+
+If this fails, instruct the user to enable:
+1. **System Settings > Privacy & Security > Automation** — grant terminal app permission to control Safari
+2. **Safari > Settings > Advanced** — enable "Show features for web developers", then **Develop menu > Allow JavaScript from Apple Events**
+
+## Core Capabilities
+
+### 1. List All Open Tabs
+
+```bash
+osascript -e '
+tell application "Safari"
+  set output to ""
+  repeat with w from 1 to (count of windows)
+    repeat with t from 1 to (count of tabs of window w)
+      set tabName to name of tab t of window w
+      set tabURL to URL of tab t of window w
+      set output to output & "W" & w & "T" & t & " | " & tabName & " | " & tabURL & linefeed
+    end repeat
+  end repeat
+  return output
+end tell'
+```
+
+### 2. Read Page Content
+
+Read the full text content of the current tab:
+
+```bash
+osascript -e '
+tell application "Safari"
+  do JavaScript "document.body.innerText" in current tab of front window
+end tell'
+```
+
+Read structured content (title, URL, meta description, headings):
+
+```bash
+osascript -e '
+tell application "Safari"
+  do JavaScript "JSON.stringify({
+    title: document.title,
+    url: location.href,
+    description: document.querySelector(\"meta[name=description]\")?.content || \"\",
+    h1: [...document.querySelectorAll(\"h1\")].map(e => e.textContent).join(\" | \"),
+    h2: [...document.querySelectorAll(\"h2\")].map(e => e.textContent).join(\" | \")
+  })" in current tab of front window
+end tell'
+```
+
+Read a simplified DOM (similar to Chrome ACP's `browser_read`):
+
+```bash
+osascript -e '
+tell application "Safari"
+  do JavaScript "
+    (function() {
+      const walk = (node, depth) => {
+        let result = \"\";
+        for (const child of node.childNodes) {
+          if (child.nodeType === 3) {
+            const text = child.textContent.trim();
+            if (text) result += text + \"\\n\";
+          } else if (child.nodeType === 1) {
+            const tag = child.tagName.toLowerCase();
+            if ([\"script\",\"style\",\"noscript\",\"svg\"].includes(tag)) continue;
+            const style = getComputedStyle(child);
+            if (style.display === \"none\" || style.visibility === \"hidden\") continue;
+            if ([\"h1\",\"h2\",\"h3\",\"h4\",\"h5\",\"h6\"].includes(tag))
+              result += \"#\".repeat(parseInt(tag[1])) + \" \";
+            if (tag === \"a\") result += \"[\";
+            if (tag === \"img\") result += \"[Image: \" + (child.alt || \"\") + \"]\\n\";
+            else if (tag === \"input\") result += \"[Input \" + child.type + \": \" + (child.value || child.placeholder || \"\") + \"]\\n\";
+            else if (tag === \"button\") result += \"[Button: \" + child.textContent.trim() + \"]\\n\";
+            else result += walk(child, depth + 1);
+            if (tag === \"a\") result += \"](\" + child.href + \")\\n\";
+            if ([\"p\",\"div\",\"li\",\"tr\",\"br\",\"h1\",\"h2\",\"h3\",\"h4\",\"h5\",\"h6\"].includes(tag))
+              result += \"\\n\";
+          }
+        }
+        return result;
+      };
+      return walk(document.body, 0).substring(0, 50000);
+    })()
+  " in current tab of front window
+end tell'
+```
+
+### 3. Execute JavaScript
+
+Run arbitrary JavaScript in the page context and get the return value:
+
+```bash
+osascript -e '
+tell application "Safari"
+  do JavaScript "YOUR_JS_CODE_HERE" in current tab of front window
+end tell'
+```
+
+For multi-line scripts, use a heredoc:
+
+```bash
+osascript << 'APPLESCRIPT'
+tell application "Safari"
+  do JavaScript "
+    (function() {
+      // Multi-line JS here
+      return 'result';
+    })()
+  " in current tab of front window
+end tell
+APPLESCRIPT
+```
+
+### 4. Screenshot
+
+Two approaches are available. Auto-detect which to use at session start:
+
+```bash
+# Test if Screen Recording permission is granted (background screenshot available)
+/tmp/safari_wid 2>/dev/null && echo "BACKGROUND_SCREENSHOT=true" || echo "BACKGROUND_SCREENSHOT=false"
+```
+
+#### Background Screenshot (requires Screen Recording permission)
+
+If the user has granted Screen Recording permission to the terminal app, use `screencapture -l` to capture Safari **without activating it**:
+
+```bash
+# Compile the helper once per session (if not already compiled)
+if [ ! -f /tmp/safari_wid ]; then
+cat > /tmp/safari_wid.swift << 'SWIFT'
+import CoreGraphics
+import Foundation
+let options: CGWindowListOption = [.optionOnScreenOnly, .excludeDesktopElements]
+guard let windowList = CGWindowListCopyWindowInfo(options, kCGNullWindowID) as? [[String: Any]] else { exit(1) }
+for window in windowList {
+    guard let owner = window[kCGWindowOwnerName as String] as? String,
+          owner == "Safari",
+          let layer = window[kCGWindowLayer as String] as? Int,
+          layer == 0,
+          let wid = window[kCGWindowNumber as String] as? Int else { continue }
+    print(wid)
+    exit(0)
+}
+exit(1)
+SWIFT
+swiftc /tmp/safari_wid.swift -o /tmp/safari_wid
+fi
+
+# Capture Safari window in background (no activation needed)
+WID=$(/tmp/safari_wid)
+screencapture -l "$WID" -o -x /tmp/safari_screenshot.png
+```
+
+To enable this, instruct the user: **System Settings > Privacy & Security > Screen Recording** — grant permission to the terminal app (Terminal / iTerm / Warp).
+
+#### Foreground Screenshot (no extra permissions needed)
+
+If Screen Recording is not granted, fall back to region-based capture. This briefly activates Safari (~0.5s), then switches back:
+
+```bash
+# Remember current frontmost app
+FRONT_APP=$(osascript -e 'tell application "System Events" to get name of first process whose frontmost is true')
+
+# Activate Safari and capture its window region
+osascript -e 'tell application "Safari" to activate'
+sleep 0.3
+BOUNDS=$(osascript -e '
+tell application "System Events"
+  tell process "Safari"
+    -- Safari may expose a thin toolbar as window 1; find the largest window
+    set bestW to 0
+    set bestBounds to ""
+    repeat with i from 1 to (count of windows)
+      set {x, y} to position of window i
+      set {w, h} to size of window i
+      if w * h > bestW then
+        set bestW to w * h
+        set bestBounds to (x as text) & "," & (y as text) & "," & (w as text) & "," & (h as text)
+      end if
+    end repeat
+    return bestBounds
+  end tell
+end tell')
+screencapture -x -R "$BOUNDS" /tmp/safari_screenshot.png
+
+# Switch back to the previous app
+osascript -e "tell application \"$FRONT_APP\" to activate"
+```
+
+After capturing with either method, read the screenshot to see what's on screen:
+
+```
+Use the Read tool on /tmp/safari_screenshot.png to view the captured image.
+```
+
+### 5. Navigate
+
+Open a URL in the current tab:
+
+```bash
+osascript -e '
+tell application "Safari"
+  set URL of current tab of front window to "https://example.com"
+end tell'
+```
+
+Open a URL in a new tab:
+
+```bash
+osascript -e '
+tell application "Safari"
+  tell front window
+    set newTab to make new tab with properties {URL:"https://example.com"}
+    set current tab to newTab
+  end tell
+end tell'
+```
+
+Open a URL in a new window:
+
+```bash
+osascript -e 'tell application "Safari" to make new document with properties {URL:"https://example.com"}'
+```
+
+### 6. Click Elements
+
+Click using JavaScript (preferred — works with SPAs and reactive frameworks):
+
+```bash
+osascript -e '
+tell application "Safari"
+  do JavaScript "
+    const el = document.querySelector(\"button.submit\");
+    if (el) {
+      el.dispatchEvent(new MouseEvent(\"click\", {bubbles: true, cancelable: true}));
+      \"clicked\";
+    } else {
+      \"element not found\";
+    }
+  " in current tab of front window
+end tell'
+```
+
+**Important**: Use `dispatchEvent(new MouseEvent(..., {bubbles: true}))` instead of `.click()` for React/Vue/Angular compatibility. Native `.click()` may bypass synthetic event handlers.
+
+### 7. Type and Fill Forms
+
+Set input values via JavaScript:
+
+```bash
+osascript -e '
+tell application "Safari"
+  do JavaScript "
+    const input = document.querySelector(\"input[name=search]\");
+    const nativeSetter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, \"value\").set;
+    nativeSetter.call(input, \"search text\");
+    input.dispatchEvent(new Event(\"input\", {bubbles: true}));
+    input.dispatchEvent(new Event(\"change\", {bubbles: true}));
+  " in current tab of front window
+end tell'
+```
+
+**Important**: For React-controlled inputs, use the native setter + `dispatchEvent` pattern shown above. Directly setting `.value` will not trigger React's state update.
+
+Type via System Events (simulates real keyboard — useful when JS injection is blocked):
+
+```bash
+osascript -e '
+tell application "Safari" to activate
+delay 0.3
+tell application "System Events"
+  keystroke "hello world"
+end tell'
+```
+
+Press special keys:
+
+```bash
+osascript -e '
+tell application "System Events"
+  key code 36  -- Enter/Return
+  key code 48  -- Tab
+  key code 51  -- Delete/Backspace
+  keystroke "a" using command down  -- Cmd+A (select all)
+  keystroke "c" using command down  -- Cmd+C (copy)
+end tell'
+```
+
+### 8. Scroll
+
+```bash
+# Scroll down 500px
+osascript -e 'tell application "Safari" to do JavaScript "window.scrollBy(0, 500)" in current tab of front window'
+
+# Scroll to top
+osascript -e 'tell application "Safari" to do JavaScript "window.scrollTo(0, 0)" in current tab of front window'
+
+# Scroll to bottom
+osascript -e 'tell application "Safari" to do JavaScript "window.scrollTo(0, document.body.scrollHeight)" in current tab of front window'
+
+# Scroll element into view
+osascript -e 'tell application "Safari" to do JavaScript "document.querySelector(\"#target\").scrollIntoView({behavior: \"smooth\"})" in current tab of front window'
+```
+
+### 9. Switch Tabs
+
+```bash
+# Switch to tab 2 in the front window
+osascript -e 'tell application "Safari" to set current tab of front window to tab 2 of front window'
+
+# Switch to a tab by URL match
+osascript -e '
+tell application "Safari"
+  repeat with t from 1 to (count of tabs of front window)
+    if URL of tab t of front window contains "github.com" then
+      set current tab of front window to tab t of front window
+      exit repeat
+    end if
+  end repeat
+end tell'
+```
+
+### 10. Wait for Page Load
+
+```bash
+osascript -e '
+tell application "Safari"
+  -- Wait until page finishes loading (max 10 seconds)
+  repeat 20 times
+    set readyState to do JavaScript "document.readyState" in current tab of front window
+    if readyState is "complete" then exit repeat
+    delay 0.5
+  end repeat
+end tell'
+```
+
+## Workflow: Browsing with Screenshot Feedback Loop
+
+For tasks that require visual confirmation, use the screenshot loop:
+
+1. Perform action (navigate, click, scroll, etc.)
+2. Wait for page load if needed
+3. Take screenshot (background or foreground) → Read the image to see result
+4. Decide next action based on what is visible
+
+## Operating on Specific Tabs
+
+To operate on a tab other than the current one, use `tab N of window M` syntax:
+
+```bash
+# Read content of tab 3 in window 1
+osascript -e 'tell application "Safari" to do JavaScript "document.title" in tab 3 of window 1'
+
+# Execute JS in a specific tab
+osascript -e 'tell application "Safari" to do JavaScript "document.body.innerText.substring(0, 1000)" in tab 2 of front window'
+```
+
+Note: Background screenshots capture the entire Safari window (whichever tab is active). To screenshot a specific tab, first switch to it via AppleScript.
+
+## Limitations
+
+- **macOS only** — AppleScript and screencapture are macOS-specific
+- **Cannot intercept network requests** — only page content and JS execution
+- **Cannot access cross-origin iframes** — browser security applies
+- **Private browsing windows** — AppleScript cannot control private windows
+- **System Events keystroke is "blind"** — it types into whatever is focused; ensure Safari is frontmost before using

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "claude-for-safari",
+  "version": "1.0.0",
+  "description": "Give your AI Agent the power to control Safari on macOS. No extensions, no separate browser.",
+  "keywords": [
+    "claude",
+    "safari",
+    "ai",
+    "agent",
+    "browser",
+    "automation",
+    "macos",
+    "applescript",
+    "claude-code",
+    "skill",
+    "safari-extension"
+  ],
+  "homepage": "https://safari.skilljam.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SDLLL/claude-for-safari"
+  },
+  "bugs": {
+    "url": "https://github.com/SDLLL/claude-for-safari/issues"
+  },
+  "author": {
+    "name": "SDLLL",
+    "url": "https://x.com/Sidrel0610"
+  },
+  "license": "MIT",
+  "files": [
+    "SKILL.md",
+    "README.md",
+    "README_CN.md",
+    "LICENSE"
+  ]
+}