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 CATALOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ of what is installed on a particular Agent host.
| --- | --- |
| Collection | Personal Skills Collection |
| Package count | 5 admitted first-party Skills |
| Current state | Release candidate v0.1.1 — release gate pending; v0.1.0 remains the current stable release |
| Stable release | [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0) |
| Current state | Released v0.1.1; independent `review-loop agent-skill` acceptance remains BLOCKED |
| Stable release | [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1) |
| Installation authority | [docs/INSTALLATION.md](docs/INSTALLATION.md) |
| Discovery check | [tests/collection-discovery-tests.ps1](tests/collection-discovery-tests.ps1) |
| Evidence | [v0.1.1 release evidence](docs/evidence/releases/v0.1.1/) |
Expand Down
4 changes: 2 additions & 2 deletions CATALOG.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@
| --- | --- |
| 集合 | Personal Skills Collection |
| 包数量 | 5 个第一方 Skill |
| 当前状态 | Release candidate v0.1.1 — release gate 待通过;v0.1.0 仍是当前稳定版本 |
| 稳定版本 | [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0) |
| 当前状态 | v0.1.1 已发布;独立 `review-loop agent-skill` acceptance 仍为 BLOCKED |
| 稳定版本 | [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1) |
| 安装权威 | [docs/INSTALLATION.zh-CN.md](docs/INSTALLATION.zh-CN.md) |
| 发现检查 | [collection-discovery-tests.ps1](tests/collection-discovery-tests.ps1) |
| 证据 | [v0.1.1 release evidence](docs/evidence/releases/v0.1.1/) |
Expand Down
15 changes: 10 additions & 5 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@ All notable changes are recorded here. A release entry must be tied to an
actual version or tag and must not be created merely because a document was
drafted.

## Unreleased — target v0.1.1 (2026-07-26)
## 0.1.1 2026-07-26

### Added

- Bilingual user guides for all five first-party Skills, validated workflow
recipes, and a runnable-sized Quick Start example.
- A release-candidate evidence tree under
- A release evidence tree under
`docs/evidence/releases/v0.1.1/` and CI checks for structure, metadata,
links, bilingual pairs, package tests, retired references, and header assets.
- Explicit `$ask-light next` and `$ask-light workflow` modes with bounded
Expand All @@ -28,13 +28,18 @@ drafted.
the CLI's default revision, while `#v0.1.1` will pin the target tag once
published.

### Release-candidate evidence
### Release evidence

- Release tag/release: `NOT TESTED` until the release gate passes.
- Release tag: `v0.1.1`, commit `c50f1ef403a5f0bfe02e75d1aeff2c237556db63`.
- GitHub Actions `collection-quality`: `PASS` on the merged release commit.
- Fresh whole-collection and per-Skill installs: `PASS` with CLI `1.5.20`.
- GitHub release: https://github.com/LightDevCoder/skills/releases/tag/v0.1.1
- Whole-collection and per-Skill fresh-install target evidence:
[INSTALLATION_VERIFICATION.md](docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md).
- Structural and package evidence:
[TEST_SUMMARY.md](docs/evidence/releases/v0.1.1/TEST_SUMMARY.md).
- Independent `review-loop agent-skill` acceptance remains `BLOCKED`; see
[release receipt](docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md).

## 0.1.0 — 2026-07-23

Expand All @@ -44,7 +49,7 @@ drafted.
- Stable tag: v0.1.0.
- The v0.1.0 whole-collection and per-Skill installer commands were verified
against a fresh destination and the published package content; this
historical evidence is retained while v0.1.1 remains a release candidate.
historical evidence is retained alongside the v0.1.1 release.
- Historical commands: `npx skills add LightDevCoder/skills` and
`npx skills add LightDevCoder/skills --skill review-loop`.
- Historical installation details:
Expand Down
14 changes: 9 additions & 5 deletions CHANGELOG.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,12 @@

所有变更都必须记录在实际版本/tag 对应的条目中,不能因为文档已起草就提前宣称 release。

## Unreleased — target v0.1.12026-07-26
## 0.1.12026-07-26

### 新增

- 五个第一方 Skill 的双语用户指南、已验证的 workflow recipes 和可运行大小的 Quick Start 示例。
- `docs/evidence/releases/v0.1.1/` release candidate 证据目录,以及覆盖结构、metadata、链接、双语配对、包测试、退休引用和头图的 CI 检查。
- `docs/evidence/releases/v0.1.1/` release 证据目录,以及覆盖结构、metadata、链接、双语配对、包测试、退休引用和头图的 CI 检查。
- 显式 `$ask-light next` 与 `$ask-light workflow` 模式,包含 bounded recipe、availability gap、handoff 字段和不执行测试。
- 可编辑 SVG 与 1600 × 480 PNG 头图:平面叠层的 `LightDevCoder` / `/skills` wordmark 和 serif slogan。

Expand All @@ -18,18 +18,22 @@
- 为 user-invoked 的 `learn-anything`、`ask-light`、`project-init` 补齐 `policy.allow_implicit_invocation: false` 及对应 frontmatter。
- 修正安装语义:无 fragment 的仓库来源遵循 CLI 默认 revision,发布后 `#v0.1.1` 才是固定 target tag。

### Release candidate 证据
### Release 证据

- Release tag/release:`NOT TESTED`,等待 release gate。
- Release tag:`v0.1.1`,commit `c50f1ef403a5f0bfe02e75d1aeff2c237556db63`。
- 合并后的 release commit 上 GitHub Actions `collection-quality`:`PASS`。
- 整仓和单 Skill fresh install:使用 CLI `1.5.20`,均为 `PASS`。
- GitHub release:https://github.com/LightDevCoder/skills/releases/tag/v0.1.1
- 整仓与单 Skill fresh-install 目标记录:[INSTALLATION_VERIFICATION.md](docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。
- 结构与包测试证据:[TEST_SUMMARY.md](docs/evidence/releases/v0.1.1/TEST_SUMMARY.md)。
- 独立 `review-loop agent-skill` acceptance 仍为 `BLOCKED`;见[发布收据](docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md)。

## 0.1.0 — 2026-07-23

- 建立第一方治理基础并准入五个第一方 Skill。
- 已发布于 https://github.com/LightDevCoder/skills。
- 稳定 tag:v0.1.0。
- v0.1.0 的整集合与单 Skill 安装命令曾针对 fresh destination 和已发布包内容完成验证;这份历史证据予以保留,v0.1.1 仍是 release candidate
- v0.1.0 的整集合与单 Skill 安装命令曾针对 fresh destination 和已发布包内容完成验证;这份历史证据与 v0.1.1 release 证据一并保留
- 历史命令:`npx skills add LightDevCoder/skills` 和
`npx skills add LightDevCoder/skills --skill review-loop`。
- 历史安装明细:[v0.1.0 摘要](docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.zh-CN.md#历史-v0.1.0-摘要)。
19 changes: 9 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,26 +10,25 @@ invocation boundary, and small enough to inspect before use.

> **About:** Personal Skills Collection — Drive your creativity

> **Release candidate:** v0.1.1 is prepared in this worktree. The release
> record and fresh-install evidence live in
> [docs/evidence/releases/v0.1.1/](docs/evidence/releases/v0.1.1/); promotion
> remains subject to the recorded release gates.
> **Release:** [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1)
> is published from commit `c50f1ef`. The release record and fresh-install evidence
> live in [docs/evidence/releases/v0.1.1/](docs/evidence/releases/v0.1.1/).
>
> The current published stable release remains [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0).
> Independent `review-loop agent-skill` acceptance remains `BLOCKED`; see the
> receipt for the exact boundary.

## Quick Start

Install the whole first-party collection at the target revision after the
release gate passes:
Install the published first-party collection:

```text
npx skills add LightDevCoder/skills#v0.1.1
npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex
```

Install one Skill at the same target revision after the release gate passes:
Install one Skill at the same published revision:

```text
npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop
npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex
```

Refresh the Agent host, then confirm that the package is visible in its Skill
Expand Down
14 changes: 8 additions & 6 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,22 +8,24 @@

> **About:** Personal Skills Collection — Drive your creativity

> **Release candidate:** 当前工作树准备的是 v0.1.1。发布记录和 fresh-install 证据见 [docs/evidence/releases/v0.1.1/](docs/evidence/releases/v0.1.1/),promotion 仍受其中 release gate 约束。
> **Release:** [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1)
> 已从 commit `c50f1ef` 发布。发布记录和 fresh-install 证据见
> [docs/evidence/releases/v0.1.1/](docs/evidence/releases/v0.1.1/)。
>
> 当前已发布的稳定版本仍是 [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0)
> 独立 `review-loop agent-skill` acceptance 仍为 `BLOCKED`;准确边界见发布收据

## Quick Start

release gate 通过后,安装目标版本的整个第一方集合
安装已发布的第一方集合

```text
npx skills add LightDevCoder/skills#v0.1.1
npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex
```

release gate 通过后,只安装同一目标版本下的一个 Skill:
安装同一已发布版本下的一个 Skill:

```text
npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop
npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex
```

刷新 Agent host,然后在其 Skill catalog 中确认发现结果。若 host 提供文件系统,检查已安装包的 `SKILL.md` 与 `agents/openai.yaml`;脱离 source checkout 后仍能发现,才是有意义的验证。CLI 版本、destination 和结果见 [INSTALLATION_VERIFICATION.md](docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。
Expand Down
21 changes: 10 additions & 11 deletions docs/INSTALLATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,9 @@
[中文安装说明](INSTALLATION.zh-CN.md)

The public first-party collection's current stable release is
[v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0). The
working tree also prepares v0.1.1 as a release candidate; its tag and
fresh-install proof are still release-gate evidence. Until those are recorded,
the v0.1.1 commands below are targets rather than verified installation claims.
[v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1), commit
`c50f1ef403a5f0bfe02e75d1aeff2c237556db63`. Fresh-install evidence for the
published tag is recorded in the [release evidence](evidence/releases/v0.1.1/).
Package contracts remain inside `skills/<name>/`; this document is the
installation authority and does not replace host-specific discovery rules.

Expand All @@ -21,7 +20,7 @@ and [Git helper](https://raw.githubusercontent.com/vercel-labs/skills/main/src/g

## Historical v0.1.0 verification

The current stable release is the published v0.1.0 snapshot at commit
The historical stable release was the published v0.1.0 snapshot at commit
`fb36fc2dad39ee94ad4aa25a5fee3c87c54f05f2`. The following unqualified
commands are retained as historical commands from that published release. The
summarized CLI, host, destination, validator, and known evidence limits are
Expand All @@ -38,18 +37,18 @@ receipt did not record them.

That historical verification does not change the CLI revision semantics: an
unqualified source follows the repository's default revision and is not a
permanent v0.1.0 pin. The v0.1.1 candidate commands below use an explicit tag.
permanent v0.1.0 pin. The published v0.1.1 commands below use an explicit tag.

The target release commands are:

```text
npx skills add LightDevCoder/skills#v0.1.1
npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop
npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex
npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex
```

After the release gate passes, the first installs the five-package collection
and the second selects one complete package at the same tag. Always record the actual CLI version, host,
destination, discovery result, and smoke result; see the
The first installs the five-package collection and the second selects one
complete package at the same tag. The verified CLI version, destination class,
discovery result, and smoke result are recorded in the
[v0.1.1 installation record](evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md).

## Supported installation scopes
Expand Down
10 changes: 5 additions & 5 deletions docs/INSTALLATION.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[English installation guide](INSTALLATION.md)

公开第一方集合当前稳定版本是 [v0.1.0](https://github.com/LightDevCoder/skills/releases/tag/v0.1.0)。当前工作树同时准备 v0.1.1 release candidate;其 tag fresh-install proof 仍属于 release gate。在证据写入前,下列 v0.1.1 命令只是目标,不是已验证的安装声明。`skills/<name>/` 内的包契约仍是行为权威;本页只规定安装和验证证据。
公开第一方集合当前稳定版本是 [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1),commit 为 `c50f1ef403a5f0bfe02e75d1aeff2c237556db63`。已发布 tag fresh-install 证据见[release evidence](evidence/releases/v0.1.1/)。`skills/<name>/` 内的包契约仍是行为权威;本页只规定安装和验证证据。

## Revision 语义

Expand All @@ -21,16 +21,16 @@ npx skills add LightDevCoder/skills --skill review-loop
该历史记录是整理摘要,不是当前重跑;原始 receipt 未记录的
boundary/missing-dependency smoke 和重复安装行为会明确标为 `NOT RECORDED`。

这份历史验证不改变 CLI 的 revision 语义:无 fragment source 遵循仓库默认 revision,并不是永久固定到 v0.1.0。下面的 v0.1.1 candidate 命令使用显式 tag。
这份历史验证不改变 CLI 的 revision 语义:无 fragment source 遵循仓库默认 revision,并不是永久固定到 v0.1.0。下面的已发布 v0.1.1 命令使用显式 tag。

目标 v0.1.1 的命令为:

```text
npx skills add LightDevCoder/skills#v0.1.1
npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop
npx skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex
npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex
```

release gate 通过后,第一条安装五个包,第二条选择同一 tag 下的完整单包。必须记录 CLI version、host、destination、discovery 和 smoke result见 [v0.1.1 安装记录](evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。
第一条安装五个包,第二条选择同一 tag 下的完整单包。已验证的 CLI version、destination 类别、discovery 和 smoke result 见 [v0.1.1 安装记录](evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md)。

## 安装范围

Expand Down
23 changes: 19 additions & 4 deletions docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@

## Status

`STRUCTURAL PASS` — the local collection test returned 668 assertions and
`COLLECTION_DISCOVERY=PASS`. Fresh released-artifact discovery remains
`NOT TESTED` until the final release is inspected from a fresh destination.
`PASS` — the local collection test returned 683 assertions and
`COLLECTION_DISCOVERY=PASS`; the tagged artifact was installed into fresh
destinations and listed successfully without a source checkout.

## Required observations

Expand All @@ -20,11 +20,26 @@
- User-invoked packages are not silently model-invoked.
- `project-workflow` and `to-manuscript-spec` remain outside the admitted tree.

## Fresh artifact command

```text
npx --yes skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex
npx --yes skills list
npx --yes skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex
npx --yes skills list
```

Observed: the whole-collection destination listed exactly 5 packages and the
single-Skill destination listed exactly `review-loop`; both destinations had no
`skills/` source checkout. Installed `review-loop` contract tests passed, and
the installed whole collection's `ask-light` behavior suite returned 52
assertions/PASS.

## Structural command

```text
powershell -File tests/collection-discovery-tests.ps1
```

Observed local result: `COLLECTION_DISCOVERY_ASSERTIONS=668`,
Observed local result: `COLLECTION_DISCOVERY_ASSERTIONS=683`,
`COLLECTION_DISCOVERY=PASS`. This is structural/discovery evidence only.
25 changes: 20 additions & 5 deletions docs/evidence/releases/v0.1.1/DISCOVERY_VERIFICATION.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@

## 状态

本地 collection test 已返回 668 条断言并输出 `COLLECTION_DISCOVERY=PASS`,属于
`STRUCTURAL PASS`。从 fresh destination 检查最终 release artifact 仍为
`NOT TESTED`。
本地 collection test 已返回 683 条断言并输出 `COLLECTION_DISCOVERY=PASS`;tagged
artifact 已安装到 fresh destination,并在没有 source checkout 的情况下成功
列出,结论为 `PASS`。

## 必须观察

Expand All @@ -17,6 +17,21 @@
- user-invoked 包不会被静默当作 model-invoked。
- `project-workflow` 与 `to-manuscript-spec` 仍在准入树外。

## Fresh artifact 命令

```text
npx --yes skills add LightDevCoder/skills#v0.1.1 --yes --copy --agent codex
npx --yes skills list
npx --yes skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --agent codex
npx --yes skills list
```

观察结果:整仓 destination 恰好列出 5 个包,单 Skill destination 恰好列出
`review-loop`;两个 destination 都不存在 `skills/` source checkout。已安装的
`review-loop` contract tests 通过,整仓安装后的 `ask-light` behavior suite
返回 52 assertions/PASS。

结构命令为 `powershell -File tests/collection-discovery-tests.ps1`。
观察结果:`COLLECTION_DISCOVERY_ASSERTIONS=668`、`COLLECTION_DISCOVERY=PASS`。
这只属于 structural/discovery evidence。
观察结果:`COLLECTION_DISCOVERY_ASSERTIONS=683`、`COLLECTION_DISCOVERY=PASS`。
这同时包含 structural/discovery evidence 和 fresh artifact discovery evidence;
不等于 host refresh 或模型介导的 runtime proof。
Loading
Loading