From caa3a4f5746842e9afe3f814555ef053631c39e1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E4=B8=80=E4=B9=8B?= Date: Thu, 5 Nov 2026 15:07:41 +0800 Subject: [PATCH 1/3] =?UTF-8?q?=F0=9F=93=9D=20sctl=20Skill=20=E6=94=B9?= =?UTF-8?q?=E4=B8=BA=E9=80=9A=E8=BF=87=20scriptscat/skills=20=E6=8F=92?= =?UTF-8?q?=E4=BB=B6=E5=B8=82=E5=9C=BA=E5=AE=89=E8=A3=85=EF=BC=8C=E8=A1=A5?= =?UTF-8?q?=20Codex=20=E6=8F=92=E4=BB=B6=E6=B8=85=E5=8D=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 16 +++++++++++++++- docs/README_zh-CN.md | 15 ++++++++++++++- skills/.codex-plugin/plugin.json | 8 ++++++++ 3 files changed, 37 insertions(+), 2 deletions(-) create mode 100644 skills/.codex-plugin/plugin.json diff --git a/README.md b/README.md index e40b78b..d5ba579 100644 --- a/README.md +++ b/README.md @@ -106,7 +106,21 @@ Behavior, exit codes, and confirmations are in [`docs/cli.md`](./docs/cli.md). [`docs/mcp.md`](./docs/mcp.md). **Agent skill.** To have an agent drive the command line instead of MCP, install the skill in -[`skills/sctl/`](./skills/sctl/SKILL.md). For Claude Code, link it from a clone of this repository: +[`skills/sctl/`](./skills/sctl/SKILL.md) from the [scriptscat/skills](https://github.com/scriptscat/skills) plugin +marketplace, which also handles updates: + +```text +# Claude Code +/plugin marketplace add scriptscat/skills +/plugin install sctl@scriptcat + +# Codex +codex plugin marketplace add scriptscat/skills +codex plugin add sctl@scriptcat +``` + +The marketplace fetches `skills/` from this repository's `main` branch; `skills/.codex-plugin/plugin.json` is the +manifest Codex needs. When working on the skill itself, link it from a clone instead so edits apply immediately: ```sh ln -s "$PWD/skills/sctl" ~/.claude/skills/sctl diff --git a/docs/README_zh-CN.md b/docs/README_zh-CN.md index 6bb2870..0e5cecc 100644 --- a/docs/README_zh-CN.md +++ b/docs/README_zh-CN.md @@ -96,7 +96,20 @@ sctl get # ScriptCat 脚本 daemon。客户端配置、工具参考和故障排查见 [`mcp.md`](./mcp.md)(英文)。 **Agent skill。** 想让 AI agent 直接使用命令行而不是 MCP,可以安装 [`skills/sctl/`](../skills/sctl/SKILL.md) 里的 -skill。在 Claude Code 中,于本仓库的克隆目录里把它链接过去: +skill。通过 [scriptscat/skills](https://github.com/scriptscat/skills) 插件市场安装,之后可以检查更新: + +```text +# Claude Code +/plugin marketplace add scriptscat/skills +/plugin install sctl@scriptcat + +# Codex +codex plugin marketplace add scriptscat/skills +codex plugin add sctl@scriptcat +``` + +插件市场从本仓库 `main` 分支取 `skills/` 目录,`skills/.codex-plugin/plugin.json` 是 Codex 需要的清单。修改 skill +本身时改用克隆目录里的软链,改动立即生效: ```sh ln -s "$PWD/skills/sctl" ~/.claude/skills/sctl diff --git a/skills/.codex-plugin/plugin.json b/skills/.codex-plugin/plugin.json new file mode 100644 index 0000000..8e08f8b --- /dev/null +++ b/skills/.codex-plugin/plugin.json @@ -0,0 +1,8 @@ +{ + "name": "sctl", + "description": "Drive the user's running browser and ScriptCat from the terminal: tabs, pages, console, network, CDP, and installing, running and reading logs of userscripts.", + "homepage": "https://github.com/scriptscat/sctl/tree/main/skills/sctl", + "repository": "https://github.com/scriptscat/sctl", + "license": "GPL-3.0", + "skills": "./sctl" +} From f9fd8da1e0928a3c5159a142edd9bceba6ed4583 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E4=B8=80=E4=B9=8B?= Date: Thu, 5 Nov 2026 15:36:34 +0800 Subject: [PATCH 2/3] =?UTF-8?q?=F0=9F=93=9D=20sctl=20README=20=E8=A1=A5?= =?UTF-8?q?=E5=85=85=20npx=20skills=20=E5=AE=89=E8=A3=85=E6=96=B9=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 12 ++++++++++-- docs/README_zh-CN.md | 10 +++++++++- 2 files changed, 19 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index d5ba579..2e9b65d 100644 --- a/README.md +++ b/README.md @@ -106,8 +106,16 @@ Behavior, exit codes, and confirmations are in [`docs/cli.md`](./docs/cli.md). [`docs/mcp.md`](./docs/mcp.md). **Agent skill.** To have an agent drive the command line instead of MCP, install the skill in -[`skills/sctl/`](./skills/sctl/SKILL.md) from the [scriptscat/skills](https://github.com/scriptscat/skills) plugin -marketplace, which also handles updates: +[`skills/sctl/`](./skills/sctl/SKILL.md) with either [`npx skills`](https://skills.sh/) or the +[scriptscat/skills](https://github.com/scriptscat/skills) plugin marketplace; both can check for updates, so pick one, +not both. `npx skills` installs into Claude Code, Codex, Cursor and other agents; `npx skills check -g` and +`npx skills update -g` handle updates: + +```sh +npx skills add scriptscat/sctl -g +``` + +From the plugin marketplace: ```text # Claude Code diff --git a/docs/README_zh-CN.md b/docs/README_zh-CN.md index 0e5cecc..84d2396 100644 --- a/docs/README_zh-CN.md +++ b/docs/README_zh-CN.md @@ -96,7 +96,15 @@ sctl get # ScriptCat 脚本 daemon。客户端配置、工具参考和故障排查见 [`mcp.md`](./mcp.md)(英文)。 **Agent skill。** 想让 AI agent 直接使用命令行而不是 MCP,可以安装 [`skills/sctl/`](../skills/sctl/SKILL.md) 里的 -skill。通过 [scriptscat/skills](https://github.com/scriptscat/skills) 插件市场安装,之后可以检查更新: +skill。用 [`npx skills`](https://skills.sh/) 或 [scriptscat/skills](https://github.com/scriptscat/skills) 插件市场安装, +两种都能检查更新,任选一种即可。`npx skills` 可以装进 Claude Code、Codex、Cursor 等代理,用 `npx skills check -g` 检查更新、 +`npx skills update -g` 更新: + +```sh +npx skills add scriptscat/sctl -g +``` + +用插件市场: ```text # Claude Code From b1cc8756db67612c257ee5a99289f1b9b8fc0a07 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E4=B8=80=E4=B9=8B?= Date: Thu, 5 Nov 2026 15:42:57 +0800 Subject: [PATCH 3/3] =?UTF-8?q?=F0=9F=93=9D=20=E6=94=B9=E4=B8=BA=E5=8F=AA?= =?UTF-8?q?=E7=94=A8=20npx=20skills=20=E5=AE=89=E8=A3=85=20sctl=20Skill?= =?UTF-8?q?=EF=BC=8C=E7=A7=BB=E9=99=A4=20Codex=20=E6=8F=92=E4=BB=B6?= =?UTF-8?q?=E6=B8=85=E5=8D=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 22 ++++------------------ docs/README_zh-CN.md | 19 ++----------------- skills/.codex-plugin/plugin.json | 8 -------- 3 files changed, 6 insertions(+), 43 deletions(-) delete mode 100644 skills/.codex-plugin/plugin.json diff --git a/README.md b/README.md index 2e9b65d..d94b0d1 100644 --- a/README.md +++ b/README.md @@ -106,29 +106,15 @@ Behavior, exit codes, and confirmations are in [`docs/cli.md`](./docs/cli.md). [`docs/mcp.md`](./docs/mcp.md). **Agent skill.** To have an agent drive the command line instead of MCP, install the skill in -[`skills/sctl/`](./skills/sctl/SKILL.md) with either [`npx skills`](https://skills.sh/) or the -[scriptscat/skills](https://github.com/scriptscat/skills) plugin marketplace; both can check for updates, so pick one, -not both. `npx skills` installs into Claude Code, Codex, Cursor and other agents; `npx skills check -g` and -`npx skills update -g` handle updates: +[`skills/sctl/`](./skills/sctl/SKILL.md) with [`npx skills`](https://skills.sh/), which installs into Claude Code, +Codex, Cursor and other agents: ```sh npx skills add scriptscat/sctl -g ``` -From the plugin marketplace: - -```text -# Claude Code -/plugin marketplace add scriptscat/skills -/plugin install sctl@scriptcat - -# Codex -codex plugin marketplace add scriptscat/skills -codex plugin add sctl@scriptcat -``` - -The marketplace fetches `skills/` from this repository's `main` branch; `skills/.codex-plugin/plugin.json` is the -manifest Codex needs. When working on the skill itself, link it from a clone instead so edits apply immediately: +`npx skills check -g` checks for updates and `npx skills update -g` installs them. When working on the skill itself, +link it from a clone instead so edits apply immediately: ```sh ln -s "$PWD/skills/sctl" ~/.claude/skills/sctl diff --git a/docs/README_zh-CN.md b/docs/README_zh-CN.md index 84d2396..97376f7 100644 --- a/docs/README_zh-CN.md +++ b/docs/README_zh-CN.md @@ -96,28 +96,13 @@ sctl get # ScriptCat 脚本 daemon。客户端配置、工具参考和故障排查见 [`mcp.md`](./mcp.md)(英文)。 **Agent skill。** 想让 AI agent 直接使用命令行而不是 MCP,可以安装 [`skills/sctl/`](../skills/sctl/SKILL.md) 里的 -skill。用 [`npx skills`](https://skills.sh/) 或 [scriptscat/skills](https://github.com/scriptscat/skills) 插件市场安装, -两种都能检查更新,任选一种即可。`npx skills` 可以装进 Claude Code、Codex、Cursor 等代理,用 `npx skills check -g` 检查更新、 -`npx skills update -g` 更新: +skill。用 [`npx skills`](https://skills.sh/) 安装,可以装进 Claude Code、Codex、Cursor 等代理: ```sh npx skills add scriptscat/sctl -g ``` -用插件市场: - -```text -# Claude Code -/plugin marketplace add scriptscat/skills -/plugin install sctl@scriptcat - -# Codex -codex plugin marketplace add scriptscat/skills -codex plugin add sctl@scriptcat -``` - -插件市场从本仓库 `main` 分支取 `skills/` 目录,`skills/.codex-plugin/plugin.json` 是 Codex 需要的清单。修改 skill -本身时改用克隆目录里的软链,改动立即生效: +用 `npx skills check -g` 检查更新,`npx skills update -g` 更新。修改 skill 本身时改用克隆目录里的软链,改动立即生效: ```sh ln -s "$PWD/skills/sctl" ~/.claude/skills/sctl diff --git a/skills/.codex-plugin/plugin.json b/skills/.codex-plugin/plugin.json deleted file mode 100644 index 8e08f8b..0000000 --- a/skills/.codex-plugin/plugin.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "name": "sctl", - "description": "Drive the user's running browser and ScriptCat from the terminal: tabs, pages, console, network, CDP, and installing, running and reading logs of userscripts.", - "homepage": "https://github.com/scriptscat/sctl/tree/main/skills/sctl", - "repository": "https://github.com/scriptscat/sctl", - "license": "GPL-3.0", - "skills": "./sctl" -}