release: prepare v0.1.1 first-party collection

Merges the tested first-party collection release candidate. Tag and release evidence follow after default-branch verification.

Author: LightDevCoder

.gitattributes

@@ -0,0 +1,3 @@
+# Keep the editable header pair byte-stable across Windows and Linux runners.
+skills/docs/assets/*.svg text eol=lf
+skills/docs/assets/*.json text eol=lf

.github/workflows/quality.yml

@@ -0,0 +1,51 @@
+name: collection-quality
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  quality:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Run collection and package checks
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = "Stop"
+          ./tests/header-asset-tests.ps1
+          ./tests/quick-start-smoke-tests.ps1
+          ./tests/collection-discovery-tests.ps1
+          ./skills/ask-light/tests/ask-light-contract-tests.ps1
+          ./skills/ask-light/tests/ask-light-behavior-tests.ps1
+          ./skills/project-init/tests/project-init-contract-tests.ps1
+          ./skills/project-init/tests/project-init-behavior-tests.ps1
+          ./skills/review-loop/tests/agent-skill-profile-contract-tests.ps1
+          ./skills/review-loop/tests/agent-skill-profile-behavior-tests.ps1
+          ./skills/review-loop/tests/generic-profile-contract-tests.ps1
+          ./skills/review-loop/tests/generic-profile-behavior-tests.ps1
+          ./skills/review-loop/tests/manuscript-profile-contract-tests.ps1
+          ./skills/review-loop/tests/manuscript-profile-behavior-tests.ps1
+          ./skills/review-loop/tests/software-profile-contract-tests.ps1
+          ./skills/review-loop/tests/software-profile-behavior-tests.ps1
+          ./skills/review-loop/tests/specification-profile-contract-tests.ps1
+          ./skills/review-loop/tests/specification-profile-behavior-tests.ps1
+      - name: Run Python contract tests and compile checks
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = "Stop"
+          python -m unittest discover -s tests -p "test*.py"
+          python -m compileall -q skills/learn-anything skills/manuscript-ops tests/test_collection_contract.py
+      - name: Retired package boundary
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = "Stop"
+          $hits = @(Get-ChildItem -LiteralPath skills -Recurse -File | Select-String -Pattern "project-workflow|to-manuscript-spec")
+          if ($hits.Count -gt 0) { throw "Retired package references remain under skills/: $($hits -join '; ')" }

.gitignore

@@ -0,0 +1,3 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/

CATALOG.md

@@ -1,19 +1,22 @@
 # First-Party Skill Catalog
 
+[中文目录](CATALOG.zh-CN.md)
+
 This catalog is synchronized from the five admitted package directories under
-skills/. It is a human-readable inventory, not a static workflow router and
-not a record of what is currently installed on any particular Agent host.
+`skills/`. It is an inventory, not a static workflow router and not a record
+of what is installed on a particular Agent host.
 
 ## Collection status
 
 | Field | Value |
 | --- | --- |
 | Collection | Personal Skills Collection |
 | Package count | 5 admitted first-party Skills |
-| Current state | Stable v0.1.0 — public release |
+| 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) |
 | 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/) |
 
 No package in this table is an unmodified upstream copy. Direct upstream
 dependencies and modified third-party variants are documented separately.
@@ -22,71 +25,57 @@ dependencies and modified third-party variants are documented separately.
 
 ### review-loop
 
-- **Purpose:** Run a generic final-acceptance and bounded-repair loop after the
-  target and acceptance source are already defined.
+- **Purpose:** Run a generic final-acceptance and bounded-repair loop after the target and acceptance source are defined.
 - **Invocation:** Model-invoked, with a supported manual entry point.
 - **Package:** [skills/review-loop/](skills/review-loop/)
-- **Status:** Admitted first-party; five Profiles are included.
-- **Evidence:** Package contract and Profile tests under
-  [skills/review-loop/tests/](skills/review-loop/tests/).
-- **Installation path:** skills/review-loop/ in a host-recognized Skills root.
+- **Status:** Admitted first-party; generic, software, specification, manuscript, and agent-skill Profiles are included.
+- **Evidence:** Package and Profile tests under [skills/review-loop/tests/](skills/review-loop/tests/); user guide at [docs/skills/review-loop.md](docs/skills/review-loop.md).
+- **Installation path:** `skills/review-loop/` in a host-recognized Skills root.
 
 ### project-init
 
-- **Purpose:** Initialize a confirmed project from a minimal preset while
-  preserving existing instructions and validating resulting paths.
+- **Purpose:** Initialize a confirmed project from a minimal preset while preserving existing instructions and validating resulting paths.
 - **Invocation:** User-invoked only.
 - **Package:** [skills/project-init/](skills/project-init/)
 - **Status:** Admitted first-party.
-- **Evidence:** Contract and behavior tests under
-  [skills/project-init/tests/](skills/project-init/tests/).
-- **Installation path:** skills/project-init/ in a host-recognized Skills root.
+- **Evidence:** Contract and behavior tests under [skills/project-init/tests/](skills/project-init/tests/); user guide at [docs/skills/project-init.md](docs/skills/project-init.md).
+- **Installation path:** `skills/project-init/` in a host-recognized Skills root.
 
 ### ask-light
 
-- **Purpose:** Inspect the active Agent host and recommend the single most
-  appropriate next Skill from current context.
+- **Purpose:** Inspect the active Agent host and recommend one next Skill or one bounded workflow recipe from the current context.
 - **Invocation:** User-invoked only; it never executes the recommendation.
 - **Package:** [skills/ask-light/](skills/ask-light/)
-- **Status:** Admitted first-party.
-- **Evidence:** Contract and behavior tests under
-  [skills/ask-light/tests/](skills/ask-light/tests/).
-- **Installation path:** skills/ask-light/ in a host-recognized Skills root.
+- **Status:** Admitted first-party; supports explicit `next` and `workflow` modes.
+- **Evidence:** Contract, scanner, and behavior tests under [skills/ask-light/tests/](skills/ask-light/tests/); user guide at [docs/skills/ask-light.md](docs/skills/ask-light.md).
+- **Installation path:** `skills/ask-light/` in a host-recognized Skills root.
 
 ### learn-anything
 
-- **Purpose:** Turn sufficiently evidenced conversations, notes, workflows, or
-  other source material into reusable Agent Skill methods.
+- **Purpose:** Turn sufficiently evidenced conversations, notes, workflows, or source material into reusable Agent Skill methods.
 - **Invocation:** User-invoked only.
 - **Package:** [skills/learn-anything/](skills/learn-anything/)
-- **Status:** Admitted first-party.
-- **Evidence:** [package contract](skills/learn-anything/SKILL.md), 41-test
-  suite, and method/behavior evidence are preserved in the accepted package
-  record.
-- **Installation path:** skills/learn-anything/ in a host-recognized Skills
-  root.
+- **Status:** Admitted first-party; source sufficiency and deterministic package-build boundaries are preserved.
+- **Evidence:** [package contract](skills/learn-anything/SKILL.md), hook evidence, and user guide at [docs/skills/learn-anything.md](docs/skills/learn-anything.md).
+- **Installation path:** `skills/learn-anything/` in a host-recognized Skills root.
 
 ### manuscript-ops
 
-- **Purpose:** Route and govern manuscript engineering from small notes through
-  large, multilingual, multi-format deliverables.
+- **Purpose:** Route and govern manuscript engineering from small notes through large, multilingual, multi-format deliverables.
 - **Invocation:** Model-invoked, with a supported manual entry point.
 - **Package:** [skills/manuscript-ops/](skills/manuscript-ops/)
-- **Status:** Admitted first-party; generic review mechanics delegate to
-  review-loop.
-- **Evidence:** Package contract, manuscript boundary tests, and referenced
-  templates/scripts under [skills/manuscript-ops/](skills/manuscript-ops/).
-- **Installation path:** skills/manuscript-ops/ in a host-recognized Skills
-  root.
+- **Status:** Admitted first-party; generic review mechanics delegate to `review-loop`.
+- **Evidence:** Package contract, referenced templates/scripts, and user guide at [docs/skills/manuscript-ops.md](docs/skills/manuscript-ops.md).
+- **Installation path:** `skills/manuscript-ops/` in a host-recognized Skills root.
 
 ## Source-state boundaries
 
 | State | Where it belongs | Catalog treatment |
 | --- | --- | --- |
 | First-party | This repository | Listed above when admitted. |
 | Direct upstream | Original upstream repository | Mentioned as a dependency; never copied here. |
-| Modified third-party | skills-3rdParty | Listed in that repository's source catalog only after fork admission. |
+| Modified third-party | `skills-3rdParty` | Listed in that private repository's source catalog after fork admission. |
 | Deprecated or archived | Released migration record | Listed with replacement and migration guidance. |
 
-See [maintenance](docs/MAINTENANCE.md) for the synchronization procedure and
+See [maintenance](docs/MAINTENANCE.md) for synchronization and
 [admission](docs/SKILL_ADMISSION.md) for the ownership gate.

CATALOG.zh-CN.md

@@ -0,0 +1,75 @@
+# 第一方 Skill 目录
+
+[English catalog](CATALOG.md)
+
+本目录从 `skills/` 下的五个准入包同步生成，是可读 inventory，不是静态 workflow router，也不代表某个 Agent host 当前已经安装了哪些 Skill。
+
+## 集合状态
+
+| 字段 | 值 |
+| --- | --- |
+| 集合 | 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) |
+| 安装权威 | [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/) |
+
+## 已准入 Skill
+
+### review-loop
+
+- **作用：** 在 target 和 acceptance source 已定义后，执行通用的 final-acceptance 和 bounded-repair loop。
+- **调用：** Model-invoked，支持手动入口。
+- **包：** [skills/review-loop/](skills/review-loop/)
+- **状态：** 第一方已准入；包含 generic、software、specification、manuscript、agent-skill Profiles。
+- **证据：** [Profile tests](skills/review-loop/tests/)；[使用指南](docs/zh-CN/skills/review-loop.md)。
+- **安装路径：** host 认可的 Skills root 下的 `skills/review-loop/`。
+
+### project-init
+
+- **作用：** 从最小 preset 初始化项目，保留既有指令并验证结果路径。
+- **调用：** User-invoked only。
+- **包：** [skills/project-init/](skills/project-init/)
+- **状态：** 第一方已准入。
+- **证据：** [package tests](skills/project-init/tests/)；[使用指南](docs/zh-CN/skills/project-init.md)。
+- **安装路径：** host 认可的 Skills root 下的 `skills/project-init/`。
+
+### ask-light
+
+- **作用：** 从当前上下文推荐一个下一 Skill 或一个 bounded workflow recipe。
+- **调用：** User-invoked only；永不执行推荐结果。
+- **包：** [skills/ask-light/](skills/ask-light/)
+- **状态：** 第一方已准入；支持显式 `next` 和 `workflow` 模式。
+- **证据：** [scanner tests](skills/ask-light/tests/)；[使用指南](docs/zh-CN/skills/ask-light.md)。
+- **安装路径：** host 认可的 Skills root 下的 `skills/ask-light/`。
+
+### learn-anything
+
+- **作用：** 将证据充分的对话、笔记、workflow 或资料转成可复用 Agent Skill 方法。
+- **调用：** User-invoked only。
+- **包：** [skills/learn-anything/](skills/learn-anything/)
+- **状态：** 第一方已准入；保留 source-sufficiency 与 deterministic package-build 边界。
+- **证据：** [package contract](skills/learn-anything/SKILL.md)；[使用指南](docs/zh-CN/skills/learn-anything.md)。
+- **安装路径：** host 认可的 Skills root 下的 `skills/learn-anything/`。
+
+### manuscript-ops
+
+- **作用：** 管理从小型笔记到多语言、多格式交付的文稿工程。
+- **调用：** Model-invoked，支持手动入口。
+- **包：** [skills/manuscript-ops/](skills/manuscript-ops/)
+- **状态：** 第一方已准入；generic review mechanics 委托给 `review-loop`。
+- **证据：** [package contract](skills/manuscript-ops/SKILL.md)；[使用指南](docs/zh-CN/skills/manuscript-ops.md)。
+- **安装路径：** host 认可的 Skills root 下的 `skills/manuscript-ops/`。
+
+## 来源边界
+
+| 状态 | 所属位置 | 目录处理 |
+| --- | --- | --- |
+| First-party | 本仓库 | 准入后列在上方。 |
+| Direct upstream | 原始上游仓库 | 作为 dependency 说明，不能复制到这里。 |
+| Modified third-party | `skills-3rdParty` | 仅在私有仓库的 source catalog 中列出。 |
+| Deprecated / archived | 已发布 migration record | 写明 replacement 和迁移路径。 |
+
+参见 [维护说明](docs/MAINTENANCE.zh-CN.md) 与 [准入说明](docs/SKILL_ADMISSION.zh-CN.md)。

CHANGELOG.md

@@ -1,23 +1,51 @@
 # Changelog
 
-All notable changes to this repository 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.
+[中文变更记录](CHANGELOG.zh-CN.md)
 
-## 0.1.0 — 2026-07-23
+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)
 
 ### Added
 
-- First-party governance foundation: ownership boundary, admission,
-  maintenance, installation, review, catalog, and composition-example policies.
-- Five admitted first-party Skills: review-loop, project-init, ask-light,
-  learn-anything, and manuscript-ops.
-- Human-readable catalog, repository-local header assets, composition example,
-  and collection discovery cross-reference tests.
+- 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
+  `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
+  recipe output, availability gaps, handoff fields, and non-execution tests.
+- A redesigned editable SVG and 1600 × 480 PNG header with a flat layered
+  `LightDevCoder` / `/skills` wordmark and serif slogan.
+
+### Fixed
+
+- Added `policy.allow_implicit_invocation: false` and matching frontmatter to
+  the user-invoked `learn-anything`, `ask-light`, and `project-init` packages.
+- Corrected installation language: an unqualified repository source follows
+  the CLI's default revision, while `#v0.1.1` will pin the target tag once
+  published.
 
-### Release verification
+### Release-candidate evidence
+
+- Release tag/release: `NOT TESTED` until the release gate passes.
+- 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).
+
+## 0.1.0 — 2026-07-23
 
+- Established the first-party governance foundation and admitted the five
+  first-party Skills.
 - Published at https://github.com/LightDevCoder/skills.
 - 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.
+  against a fresh destination and the published package content; this
+  historical evidence is retained while v0.1.1 remains a release candidate.
+- Historical commands: `npx skills add LightDevCoder/skills` and
+  `npx skills add LightDevCoder/skills --skill review-loop`.
+- Historical installation details:
+  [v0.1.0 summary](docs/evidence/releases/v0.1.1/INSTALLATION_VERIFICATION.md#historical-v0.1.0-summary).

CHANGELOG.zh-CN.md

@@ -0,0 +1,35 @@
+# 变更记录
+
+[English changelog](CHANGELOG.md)
+
+所有变更都必须记录在实际版本/tag 对应的条目中，不能因为文档已起草就提前宣称 release。
+
+## Unreleased — target v0.1.1（2026-07-26）
+
+### 新增
+
+- 五个第一方 Skill 的双语用户指南、已验证的 workflow recipes 和可运行大小的 Quick Start 示例。
+- `docs/evidence/releases/v0.1.1/` release candidate 证据目录，以及覆盖结构、metadata、链接、双语配对、包测试、退休引用和头图的 CI 检查。
+- 显式 `$ask-light next` 与 `$ask-light workflow` 模式，包含 bounded recipe、availability gap、handoff 字段和不执行测试。
+- 可编辑 SVG 与 1600 × 480 PNG 头图：平面叠层的 `LightDevCoder` / `/skills` wordmark 和 serif slogan。
+
+### 修复
+
+- 为 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 tag/release：`NOT TESTED`，等待 release gate。
+- 整仓与单 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)。
+
+## 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。
+- 历史命令：`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-摘要)。