Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"name": "Yinghao Tang",
"url": "https://github.com/MisterBrookT"
},
"homepage": "https://github.com/MisterBrookT/skill2",
"repository": "https://github.com/MisterBrookT/skill2",
"homepage": "https://github.com/blackblue-labs/skill2",
"repository": "https://github.com/blackblue-labs/skill2",
"license": "MIT"
}
10 changes: 5 additions & 5 deletions .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@
"name": "Yinghao Tang",
"url": "https://github.com/MisterBrookT"
},
"homepage": "https://github.com/MisterBrookT/skill2",
"repository": "https://github.com/MisterBrookT/skill2",
"homepage": "https://github.com/blackblue-labs/skill2",
"repository": "https://github.com/blackblue-labs/skill2",
"license": "MIT",
"keywords": [
"agent-skills",
Expand All @@ -28,9 +28,9 @@
"Read",
"Write"
],
"websiteURL": "https://github.com/MisterBrookT/skill2",
"privacyPolicyURL": "https://github.com/MisterBrookT/skill2/blob/main/PRIVACY.md",
"termsOfServiceURL": "https://github.com/MisterBrookT/skill2/blob/main/TERMS.md",
"websiteURL": "https://github.com/blackblue-labs/skill2",
"privacyPolicyURL": "https://github.com/blackblue-labs/skill2/blob/main/PRIVACY.md",
"termsOfServiceURL": "https://github.com/blackblue-labs/skill2/blob/main/TERMS.md",
"defaultPrompt": [
"Create a project-level skill for this workflow.",
"Test whether this skill activates and improves the result.",
Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,10 @@
<p align="center"><a href="README.zh.md">中文</a></p>

<p align="center">
<img alt="GitHub stars" src="https://img.shields.io/github/stars/MisterBrookT/skill2?style=flat-square">
<img alt="GitHub stars" src="https://img.shields.io/github/stars/blackblue-labs/skill2?style=flat-square">
<img alt="Python 3.11+" src="https://img.shields.io/badge/python-3.11%2B-111111?style=flat-square">
<img alt="Local first" src="https://img.shields.io/badge/data-local--only-111111?style=flat-square">
<img alt="MIT license" src="https://img.shields.io/github/license/MisterBrookT/skill2?style=flat-square&color=111111">
<img alt="MIT license" src="https://img.shields.io/github/license/blackblue-labs/skill2?style=flat-square&color=111111">
</p>

<p align="center">
Expand All @@ -44,7 +44,7 @@ Skill2 treats Agent Skills as testable, auditable software units. Five focused S
### Claude Code

```text
/plugin marketplace add MisterBrookT/skill2
/plugin marketplace add blackblue-labs/skill2
/plugin install skill2@skill2-marketplace
```

Expand All @@ -53,15 +53,15 @@ Installs five self-contained Skills.
### Codex

```bash
npx skills add MisterBrookT/skill2 -g -a codex -y
npx skills add blackblue-labs/skill2 -g -a codex -y
```

Copies the five self-contained Skills for Codex.

### Manual fallback

```bash
git clone https://github.com/MisterBrookT/skill2.git ~/.skill2 && ~/.skill2/install.sh
git clone https://github.com/blackblue-labs/skill2.git ~/.skill2 && ~/.skill2/install.sh
```

Copies Skills only (`install.sh` supports `--dry-run` and conflict-gated `--force` from a checkout). Requires Git. [uv](https://docs.astral.sh/uv/) is needed only when a Skill runs its deterministic script. Skill scripts use `uv run --script`; first run may fetch declared dependencies into the uv cache; offline use requires a warm cache. Data stays local; no hosted service, telemetry, or PyPI install for users.
Expand Down
10 changes: 5 additions & 5 deletions README.zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,10 @@
<p align="center"><a href="README.md">English</a></p>

<p align="center">
<img alt="GitHub stars" src="https://img.shields.io/github/stars/MisterBrookT/skill2?style=flat-square">
<img alt="GitHub stars" src="https://img.shields.io/github/stars/blackblue-labs/skill2?style=flat-square">
<img alt="Python 3.11+" src="https://img.shields.io/badge/python-3.11%2B-111111?style=flat-square">
<img alt="本地数据" src="https://img.shields.io/badge/data-local--only-111111?style=flat-square">
<img alt="MIT license" src="https://img.shields.io/github/license/MisterBrookT/skill2?style=flat-square&color=111111">
<img alt="MIT license" src="https://img.shields.io/github/license/blackblue-labs/skill2?style=flat-square&color=111111">
</p>

<p align="center">
Expand All @@ -44,7 +44,7 @@ Skill2 把 Agent Skills 当成可测试、可审计的软件单元。五个专
### Claude Code

```text
/plugin marketplace add MisterBrookT/skill2
/plugin marketplace add blackblue-labs/skill2
/plugin install skill2@skill2-marketplace
```

Expand All @@ -53,15 +53,15 @@ Skill2 把 Agent Skills 当成可测试、可审计的软件单元。五个专
### Codex

```bash
npx skills add MisterBrookT/skill2 -g -a codex -y
npx skills add blackblue-labs/skill2 -g -a codex -y
```

为 Codex 复制五个自包含 Skills。

### 手工 fallback

```bash
git clone https://github.com/MisterBrookT/skill2.git ~/.skill2 && ~/.skill2/install.sh
git clone https://github.com/blackblue-labs/skill2.git ~/.skill2 && ~/.skill2/install.sh
```

只复制 Skills(从 checkout 运行时 `install.sh` 支持 `--dry-run` 与冲突门控的 `--force`)。需要 Git。[uv](https://docs.astral.sh/uv/) 仅在 Skill 执行其确定性脚本时需要。Skill 脚本使用 `uv run --script`;首次运行可能将声明依赖拉取进 uv cache;离线使用需要已预热的 cache。数据只留本地;无托管服务、无 telemetry、用户无需 PyPI 安装。
Expand Down
4 changes: 2 additions & 2 deletions docs/CURRENT_STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@ Skill2 = 五个自包含 Skills(create / test / package / audit / visualize)

| 入口 | 命令 / 动作 | 状态 |
| --- | --- | --- |
| Claude Code 主入口 | `/plugin marketplace add MisterBrookT/skill2` + `/plugin install skill2@skill2-marketplace` | README 主路径;本地 marketplace + plugin install smoke 通过(临时 HOME) |
| Codex 当前 | `npx skills add MisterBrookT/skill2 -g -a codex -y` | 文档化 + 本地源 smoke 通过;**未**宣称 curated `/plugins` 可搜索 |
| Claude Code 主入口 | `/plugin marketplace add blackblue-labs/skill2` + `/plugin install skill2@skill2-marketplace` | README 主路径;本地 marketplace + plugin install smoke 通过(临时 HOME) |
| Codex 当前 | `npx skills add blackblue-labs/skill2 -g -a codex -y` | 文档化 + 本地源 smoke 通过;**未**宣称 curated `/plugins` 可搜索 |
| 手工 fallback | `git clone … && ./install.sh` | Skills-only;无 `uv tool install`;smoke 通过 |
| 贡献者 CLI | `uv run skill2 …` | 仅 Development / CI |

Expand Down
4 changes: 2 additions & 2 deletions docs/DESIGN.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ create → test → package [native | artifact | release]

## 公开安装面

1. **Claude Code**:`/plugin marketplace add MisterBrookT/skill2` → `/plugin install skill2@skill2-marketplace`。
2. **Codex**:`npx skills add MisterBrookT/skill2 -g -a codex -y`。Curated marketplace [审核中](https://github.com/openai/codex/issues/32820);合并前不宣称 `/plugins` 可搜索到 Skill2。
1. **Claude Code**:`/plugin marketplace add blackblue-labs/skill2` → `/plugin install skill2@skill2-marketplace`。
2. **Codex**:`npx skills add blackblue-labs/skill2 -g -a codex -y`。Curated marketplace [审核中](https://github.com/openai/codex/issues/32820);合并前不宣称 `/plugins` 可搜索到 Skill2。
3. **手工 fallback**:`git clone` + `install.sh`,只复制 Skills。

需要 [uv](https://docs.astral.sh/uv/) 仅当 Skill 执行其确定性脚本。无托管服务、telemetry、PyPI 用户安装路径。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -344,14 +344,14 @@ git commit -m "make skills self contained"
- README primary Claude commands:

```text
/plugin marketplace add MisterBrookT/skill2
/plugin marketplace add blackblue-labs/skill2
/plugin install skill2@skill2-marketplace
```

- README current Codex command:

```bash
npx skills add MisterBrookT/skill2 -g -a codex -y
npx skills add blackblue-labs/skill2 -g -a codex -y
```

- Contributor CLI remains `uv run skill2 ...` under development section only.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Skills 是产品。顶层 Python package 只服务仓库开发、生成与验证
### Claude Code:主入口

```text
/plugin marketplace add MisterBrookT/skill2
/plugin marketplace add blackblue-labs/skill2
/plugin install skill2@skill2-marketplace
```

Expand All @@ -39,7 +39,7 @@ Plugin 安装整个仓库。六个 Skills、脚本、references 同时可用。
进入 OpenAI curated marketplace 后,README 使用 `/plugins` 作为主入口。进入前使用:

```bash
npx skills add MisterBrookT/skill2 -g -a codex -y
npx skills add blackblue-labs/skill2 -g -a codex -y
```

`npx skills add` 只复制 Skill 目录。因此每个 Skill 必须自包含,不得依赖仓库顶层 `src/`、`.venv` 或已安装的全局 `skill2` 命令。
Expand Down
2 changes: 1 addition & 1 deletion install.sh
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# shellcheck shell=bash
set -eu

REPOSITORY_URL="https://github.com/MisterBrookT/skill2.git"
REPOSITORY_URL="https://github.com/blackblue-labs/skill2.git"
MODE="all"
MODE_SET=0
DRY_RUN=0
Expand Down
2 changes: 1 addition & 1 deletion skills/skill2-audit/scripts/_runtime/skill2/cli.py
Original file line number Diff line number Diff line change
Expand Up @@ -269,7 +269,7 @@ def _to_sarif(issues: tuple[Issue, ...], *, scan: ScanResult | None = None) -> d
"tool": {
"driver": {
"name": "skill2",
"informationUri": "https://github.com/MisterBrookT/skill2",
"informationUri": "https://github.com/blackblue-labs/skill2",
"rules": [{"id": rule_id} for rule_id in rule_ids],
}
},
Expand Down
2 changes: 1 addition & 1 deletion skills/skill2-create/scripts/_runtime/skill2/cli.py
Original file line number Diff line number Diff line change
Expand Up @@ -269,7 +269,7 @@ def _to_sarif(issues: tuple[Issue, ...], *, scan: ScanResult | None = None) -> d
"tool": {
"driver": {
"name": "skill2",
"informationUri": "https://github.com/MisterBrookT/skill2",
"informationUri": "https://github.com/blackblue-labs/skill2",
"rules": [{"id": rule_id} for rule_id in rule_ids],
}
},
Expand Down
2 changes: 1 addition & 1 deletion skills/skill2-package/scripts/_runtime/skill2/cli.py
Original file line number Diff line number Diff line change
Expand Up @@ -269,7 +269,7 @@ def _to_sarif(issues: tuple[Issue, ...], *, scan: ScanResult | None = None) -> d
"tool": {
"driver": {
"name": "skill2",
"informationUri": "https://github.com/MisterBrookT/skill2",
"informationUri": "https://github.com/blackblue-labs/skill2",
"rules": [{"id": rule_id} for rule_id in rule_ids],
}
},
Expand Down
2 changes: 1 addition & 1 deletion skills/skill2-test/scripts/_runtime/skill2/cli.py
Original file line number Diff line number Diff line change
Expand Up @@ -269,7 +269,7 @@ def _to_sarif(issues: tuple[Issue, ...], *, scan: ScanResult | None = None) -> d
"tool": {
"driver": {
"name": "skill2",
"informationUri": "https://github.com/MisterBrookT/skill2",
"informationUri": "https://github.com/blackblue-labs/skill2",
"rules": [{"id": rule_id} for rule_id in rule_ids],
}
},
Expand Down
2 changes: 1 addition & 1 deletion skills/skill2-visualize/scripts/_runtime/skill2/cli.py
Original file line number Diff line number Diff line change
Expand Up @@ -269,7 +269,7 @@ def _to_sarif(issues: tuple[Issue, ...], *, scan: ScanResult | None = None) -> d
"tool": {
"driver": {
"name": "skill2",
"informationUri": "https://github.com/MisterBrookT/skill2",
"informationUri": "https://github.com/blackblue-labs/skill2",
"rules": [{"id": rule_id} for rule_id in rule_ids],
}
},
Expand Down
2 changes: 1 addition & 1 deletion src/skill2/cli.py
Original file line number Diff line number Diff line change
Expand Up @@ -269,7 +269,7 @@ def _to_sarif(issues: tuple[Issue, ...], *, scan: ScanResult | None = None) -> d
"tool": {
"driver": {
"name": "skill2",
"informationUri": "https://github.com/MisterBrookT/skill2",
"informationUri": "https://github.com/blackblue-labs/skill2",
"rules": [{"id": rule_id} for rule_id in rule_ids],
}
},
Expand Down
4 changes: 2 additions & 2 deletions tests/test_package.py
Original file line number Diff line number Diff line change
Expand Up @@ -271,10 +271,10 @@ def test_public_readmes_native_install_surface(self) -> None:
english = (ROOT / "README.md").read_text(encoding="utf-8")
chinese = (ROOT / "README.zh.md").read_text(encoding="utf-8")
claude_commands = (
"/plugin marketplace add MisterBrookT/skill2",
"/plugin marketplace add blackblue-labs/skill2",
"/plugin install skill2@skill2-marketplace",
)
codex_command = "npx skills add MisterBrookT/skill2 -g -a codex -y"
codex_command = "npx skills add blackblue-labs/skill2 -g -a codex -y"
offline_boundary = re.compile(
r"(?is)uv run --script.*first run.*uv cache|uv run --script.*首次.*uv cache|"
r"offline.*warm cache|离线.*预热|离线.*已有.*cache",
Expand Down
Loading