Skip to content

Commit 215c65c

Browse files
LightDevCoderclaude
andcommitted
Add language-learning tutor and stage its prompt-only fast-track admission
Introduce a first-party, user-invoked language-learning Skill that tutors any target language through six study modes: daily lessons, flashcards, conversation practice, grammar decoding, progress quizzes, and immersion translation. It reuses session context and learned vocabulary instead of re-asking, corrects selectively rather than listing every mistake, and evaluates progress after each quiz. Synchronize the package contract tests, collection discovery coverage, bilingual guides, catalog, installation, changelog, and maintenance baseline. The package is proposed, not yet admitted; a fresh independent fast-track Evaluator, a fresh-copy install, and fresh behavior observations remain before a final verdict. Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 68f970d commit 215c65c

25 files changed

Lines changed: 741 additions & 21 deletions

CATALOG.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
[中文目录](CATALOG.zh-CN.md)
44

5-
This catalog is synchronized from the six admitted package directories under
5+
This catalog is synchronized from the seven admitted package directories under
66
`skills/`. It is an inventory, not a
77
static workflow router and not a record of what is installed on a particular
88
Agent host.
@@ -12,8 +12,8 @@ Agent host.
1212
| Field | Value |
1313
| --- | --- |
1414
| Collection | Personal Skills Collection |
15-
| Package count | 6 admitted first-party Skills on this branch; 5 admitted first-party Skills in stable v0.1.1 |
16-
| Current state | `recap` passed the low-risk prompt-only fast track but remains unreleased; v0.1.1 remains installable |
15+
| Package count | 7 admitted first-party Skills on this branch; 5 admitted first-party Skills in stable v0.1.1 |
16+
| Current state | `recap` passed the low-risk prompt-only fast track but remains unreleased; `language-learning` has its fast-track evidence staged and is not yet admitted; v0.1.1 remains installable |
1717
| Stable release | [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1) |
1818
| Installation authority | [docs/INSTALLATION.md](docs/INSTALLATION.md) |
1919
| Discovery check | [tests/collection-discovery-tests.ps1](tests/collection-discovery-tests.ps1) |
@@ -62,6 +62,17 @@ dependencies and modified third-party variants are documented separately.
6262
- **Evidence:** Contract and output-contract tests under [skills/recap/tests/](skills/recap/tests/), [user guide](docs/skills/recap.md), and [admission evidence](docs/evidence/admissions/recap/README.md).
6363
- **Installation path:** `skills/recap/` in a host-recognized Skills root.
6464

65+
## Proposed first-party admission
66+
67+
### language-learning
68+
69+
- **Purpose:** Tutor for any target language through six study modes — daily lessons, flashcards, conversation practice, grammar decoding, progress quizzes, and immersion translation.
70+
- **Invocation:** User-invoked only.
71+
- **Package:** [skills/language-learning/](skills/language-learning/)
72+
- **Status:** Proposed first-party; prompt-only fast-track evidence staged for this branch; not yet admitted and not in any release.
73+
- **Evidence:** Contract tests under [skills/language-learning/tests/](skills/language-learning/tests/), [user guide](docs/skills/language-learning.md), and [admission evidence](docs/evidence/admissions/language-learning/README.md).
74+
- **Installation path:** `skills/language-learning/` in a host-recognized Skills root.
75+
6576
## Remaining admitted Skills
6677

6778
### learn-anything

CATALOG.zh-CN.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22

33
[English catalog](CATALOG.md)
44

5-
本目录从 `skills/` 下六个已准入包同步生成,是可读 inventory,不是静态 workflow router,也不代表某个 Agent host 当前已经安装了哪些 Skill。
5+
本目录从 `skills/` 下七个已准入包同步生成,是可读 inventory,不是静态 workflow router,也不代表某个 Agent host 当前已经安装了哪些 Skill。
66

77
## 集合状态
88

99
| 字段 ||
1010
| --- | --- |
1111
| 集合 | Personal Skills Collection |
12-
| 包数量 | 本分支 6 个已准入第一方 Skill;稳定 v0.1.1 包含 5 个 |
13-
| 当前状态 | `recap` 已通过低风险纯提示型快速通道但尚未发布;v0.1.1 继续可安装 |
12+
| 包数量 | 本分支 7 个已准入第一方 Skill;稳定 v0.1.1 包含 5 个 |
13+
| 当前状态 | `recap` 已通过低风险纯提示型快速通道但尚未发布;`language-learning` 的快速通道证据已准备好但尚未准入;v0.1.1 继续可安装 |
1414
| 稳定版本 | [v0.1.1](https://github.com/LightDevCoder/skills/releases/tag/v0.1.1) |
1515
| 安装权威 | [docs/INSTALLATION.zh-CN.md](docs/INSTALLATION.zh-CN.md) |
1616
| 发现检查 | [collection-discovery-tests.ps1](tests/collection-discovery-tests.ps1) |
@@ -56,6 +56,17 @@
5656
- **证据:** [package tests](skills/recap/tests/)[使用指南](docs/zh-CN/skills/recap.md)[准入证据](docs/evidence/admissions/recap/README.zh-CN.md)
5757
- **安装路径:** host 认可的 Skills root 下的 `skills/recap/`
5858

59+
## 提议准入的第一方 Skill
60+
61+
### language-learning
62+
63+
- **作用:** 通过六种学习模式辅导任意目标语言——每日课程、即时卡片、对话练习、语法解码、进度测验与沉浸翻译。
64+
- **调用:** 仅 user-invoked。
65+
- **包:** [skills/language-learning/](skills/language-learning/)
66+
- **状态:** 提议第一方;纯提示型快速通道证据已为本分支准备好;尚未准入,也不在任何 release 中。
67+
- **证据:** [package tests](skills/language-learning/tests/)[使用指南](docs/zh-CN/skills/language-learning.md)[准入证据](docs/evidence/admissions/language-learning/README.zh-CN.md)
68+
- **安装路径:** host 认可的 Skills root 下的 `skills/language-learning/`
69+
5970
## 其余已准入 Skill
6071

6172
### learn-anything

CHANGELOG.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,14 @@ drafted.
2121
manual-only, text-output Skills with no tools, side effects, runtime
2222
executables, or external dependencies. It uses one fresh Evaluator and does
2323
not require separate Critic or Standards/Spec review.
24+
- Proposed the first-party, user-invoked `language-learning` Skill. It tutors
25+
any target language through six study modes — daily lessons, flashcards,
26+
conversation practice, grammar decoding, progress quizzes, and immersion
27+
translation — reusing session context and previously learned vocabulary
28+
across invocations instead of re-asking.
29+
- Added bilingual `language-learning` guides, package contract tests,
30+
collection discovery coverage, and staged prompt-only fast-track admission
31+
evidence. It is not yet admitted and is not in any release.
2432

2533
`recap` received a final low-risk prompt-only fast-track `PASS`. This entry
2634
does not claim a release tag or a verified published install command; stable

CHANGELOG.zh-CN.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,13 @@
1515
- 新增低风险纯提示型准入快速通道:仅适用于 owner-authored、manual-only、
1616
只输出文本、无工具/副作用/runtime executable/外部依赖的 Skill;只需一个
1717
fresh Evaluator,不再要求额外 Critic 或 Standards/Spec review。
18+
- 提议新增第一方、仅 user-invoked 的 `language-learning` Skill。它通过六种
19+
学习模式辅导任意目标语言——每日课程、即时卡片、对话练习、语法解码、
20+
进度测验与沉浸翻译——并在多次调用之间复用会话上下文与已学词汇,而不是
21+
每次都重新询问。
22+
- 新增 `language-learning` 双语指南、package contract tests、collection
23+
discovery 覆盖和已准备的纯提示型快速通道准入证据。它尚未准入,也不在任何
24+
release 中。
1825

1926
`recap` 已获得低风险纯提示型快速通道 final `PASS`。本条目不宣称 release tag 或已验证的已发布安装命令;稳定 v0.1.1 仍包含五个包。
2027

README.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
# Personal Skills Collection
66

7-
`LightDevCoder/skills` is the public, first-party home for six installable
7+
`LightDevCoder/skills` is the public, first-party home for seven installable
88
Agent Skills on the current branch. Each package is independently discoverable,
99
explicit about its invocation boundary, and small enough to inspect before use.
1010

@@ -22,8 +22,7 @@ explicit about its invocation boundary, and small enough to inspect before use.
2222
> installation or ordinary use; see the [release receipt](docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md)
2323
> and [limitations](docs/evidence/releases/v0.1.1/LIMITATIONS.md) for the detailed boundary.
2424
>
25-
> **Current branch admission:** `recap` passed the low-risk prompt-only fast
26-
> track for this change. It is still unreleased; stable `v0.1.1` contains the original five packages.
25+
> **Current branch admission:** `recap` passed the low-risk prompt-only fast track; `language-learning` has its prompt-only fast-track evidence staged for this branch. Both remain unreleased; stable `v0.1.1` contains the original five packages.
2726
2827
## Quick Start
2928

@@ -68,8 +67,9 @@ outputs, handoffs, and stopping boundaries.
6867

6968
## External capabilities
7069

71-
The current branch contains six admitted first-party packages: the five in
72-
v0.1.1 plus the newly admitted, unreleased `recap` package.
70+
The current branch contains seven first-party packages on this branch: the five
71+
in v0.1.1 plus the newly admitted, unreleased `recap` package and the proposed,
72+
unreleased `language-learning` package.
7373

7474
Optional workflow capabilities are external or third-party dependencies and are
7575
not included by default:
@@ -98,6 +98,7 @@ check their availability before selecting a workflow that names them.
9898
| [review-loop](skills/review-loop/SKILL.md) | Run bounded evidence, repair, and final-acceptance loops. | Model-invoked; manual entry point is supported. | skills/review-loop/ |
9999
| [project-init](skills/project-init/SKILL.md) | Initialize a confirmed software, manuscript, research, knowledge, data, or Skill-development project preset. | User-invoked only. | skills/project-init/ |
100100
| [ask-light](skills/ask-light/SKILL.md) | Inspect the active host and recommend one appropriate next Skill or bounded recipe without executing it. | User-invoked only. | skills/ask-light/ |
101+
| [language-learning](skills/language-learning/SKILL.md) | Tutor for any target language through six study modes: lessons, flashcards, conversation, grammar, quizzes, and immersion. | User-invoked only. | skills/language-learning/ |
101102
| [recap](skills/recap/SKILL.md) | Summarize the current Agent session in exactly one line without changing history or continuing the task. | User-invoked only. | skills/recap/ |
102103
| [learn-anything](skills/learn-anything/SKILL.md) | Distill sufficiently evidenced source material into reusable Agent Skill methods. | User-invoked only. | skills/learn-anything/ |
103104
| [manuscript-ops](skills/manuscript-ops/SKILL.md) | Govern reproducible manuscript engineering across formats, batches, reviews, and handoffs. | Model-invoked; manual entry point is supported. | skills/manuscript-ops/ |
@@ -141,4 +142,5 @@ and is never copied into this public collection.
141142
- [Changelog](CHANGELOG.md)
142143
- [Release receipt](docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.md)
143144
- [recap admission evidence](docs/evidence/admissions/recap/README.md)
145+
- [language-learning admission evidence](docs/evidence/admissions/language-learning/README.md)
144146
- [Collection discovery test](tests/collection-discovery-tests.ps1)

README.zh-CN.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
# Personal Skills Collection
66

7-
`LightDevCoder/skills` 是公开的第一方 Agent Skills 集合;当前分支包含六个可以独立安装、独立发现、明确声明调用边界的 Skill。包内 `SKILL.md` 仍是行为权威;本 README 与用户指南负责说明使用方式。
7+
`LightDevCoder/skills` 是公开的第一方 Agent Skills 集合;当前分支包含七个可以独立安装、独立发现、明确声明调用边界的 Skill。包内 `SKILL.md` 仍是行为权威;本 README 与用户指南负责说明使用方式。
88

99
> **简介:** Personal Skills Collection — Drive your creativity
1010
@@ -20,6 +20,7 @@
2020
> [限制说明](docs/evidence/releases/v0.1.1/LIMITATIONS.zh-CN.md)
2121
>
2222
> **当前分支准入:** `recap` 已通过本变更的低风险纯提示型快速通道,但尚未发布;
23+
> `language-learning` 的纯提示型快速通道证据已为本分支准备好。两者均未发布;
2324
> 稳定 v0.1.1 仍是原来的五个包。
2425
2526
## Quick Start
@@ -57,7 +58,7 @@ $review-loop init # 冻结已有验收标准的 baseline
5758

5859
## 外部能力(External Capabilities)
5960

60-
当前分支包含六个已准入第一方包:v0.1.1 的五个包,以及新准入但尚未发布的 `recap`
61+
当前分支包含七个第一方包:v0.1.1 的五个包,新准入但尚未发布的 `recap`,以及已提议、尚未发布的 `language-learning`
6162

6263
以下是可选的 workflow 能力,来自外部或第三方来源,不属于默认集合:
6364

@@ -79,6 +80,7 @@ $review-loop init # 冻结已有验收标准的 baseline
7980
| [review-loop](skills/review-loop/SKILL.md) | 执行有边界的证据、修复和最终验收循环。 | Model-invoked;支持手动入口。 | skills/review-loop/ |
8081
| [project-init](skills/project-init/SKILL.md) | 从最小 preset 初始化已确认的软件、文稿、研究、知识、数据或 Skill-development 项目。 | 仅 user-invoked。 | skills/project-init/ |
8182
| [ask-light](skills/ask-light/SKILL.md) | 检查 host 并推荐一个下一 Skill 或 bounded recipe,不执行建议。 | 仅 user-invoked。 | skills/ask-light/ |
83+
| [language-learning](skills/language-learning/SKILL.md) | 通过六种学习模式辅导任意目标语言:课程、卡片、对话、语法、测验与沉浸。 | 仅 user-invoked。 | skills/language-learning/ |
8284
| [recap](skills/recap/SKILL.md) | 用严格一行总结当前 Agent session,不改变历史也不继续任务。 | 仅 user-invoked。 | skills/recap/ |
8385
| [learn-anything](skills/learn-anything/SKILL.md) | 从有足够证据的资料中提炼可复用 Agent Skill 方法。 | 仅 user-invoked。 | skills/learn-anything/ |
8486
| [manuscript-ops](skills/manuscript-ops/SKILL.md) | 治理跨格式、批次、审查和 handoff 的可复现文稿工程。 | Model-invoked;支持手动入口。 | skills/manuscript-ops/ |
@@ -108,3 +110,4 @@ $review-loop init # 冻结已有验收标准的 baseline
108110
- [变更记录](CHANGELOG.zh-CN.md)
109111
- [发布收据](docs/evidence/releases/v0.1.1/RELEASE_RECEIPT.zh-CN.md)
110112
- [recap 准入证据](docs/evidence/admissions/recap/README.zh-CN.md)
113+
- [language-learning 准入证据](docs/evidence/admissions/language-learning/README.zh-CN.md)

docs/INSTALLATION.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,16 @@ an unqualified default-branch command as a stable release pin, and do not
6060
publish a pinned `recap` command until a new tag exists and the command has
6161
succeeded against that released repository in a fresh environment.
6262

63+
## Unreleased `language-learning` package
64+
65+
`language-learning` has its prompt-only fast-track evidence staged on this
66+
branch but is not yet admitted and not present in v0.1.1. Its admission record
67+
is under [evidence/admissions/language-learning/](evidence/admissions/language-learning/README.md).
68+
Do not present an unqualified default-branch command as a stable release pin,
69+
and do not publish a pinned `language-learning` command until a new tag exists
70+
and the command has succeeded against that released repository in a fresh
71+
environment.
72+
6373
## Supported installation scopes
6474

6575
| Scope | Destination policy | Required evidence |

docs/INSTALLATION.zh-CN.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,10 @@ npx skills add LightDevCoder/skills#v0.1.1 --skill review-loop --yes --copy --ag
3636

3737
`recap` 已通过纯提示型快速通道在本分支准入,但 v0.1.1 不包含它。它的 fresh-copy 安装与 discovery 检查见[准入记录](evidence/admissions/recap/README.zh-CN.md)。不要把无 fragment 的默认分支命令写成稳定 release pin;只有新 tag 已创建、并在 fresh 环境中针对已发布仓库成功运行后,才能发布 pinned `recap` 安装命令。
3838

39+
## 未发布的 `language-learning`
40+
41+
`language-learning` 的纯提示型快速通道证据已在本分支准备好,但尚未准入,v0.1.1 不包含它。准入记录见[准入证据](evidence/admissions/language-learning/README.zh-CN.md)。不要把无 fragment 的默认分支命令写成稳定 release pin;只有新 tag 已创建、并在 fresh 环境中针对已发布仓库成功运行后,才能发布 pinned `language-learning` 安装命令。
42+
3943
## 安装范围
4044

4145
| 范围 | destination 规则 | 必需证据 |

docs/MAINTENANCE.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,10 @@ Keep each fact in one authoritative location and link to it elsewhere:
2222
## Current synchronization baseline
2323

2424
The admitted collection on this branch contains exactly review-loop,
25-
project-init, ask-light, learn-anything, manuscript-ops, and recap. The recap
26-
package passed the prompt-only fast track but remains unreleased. Stable v0.1.1
25+
project-init, ask-light, learn-anything, manuscript-ops, recap, and the
26+
proposed, unreleased language-learning package. The recap package passed the
27+
prompt-only fast track but remains unreleased; language-learning has its
28+
prompt-only fast-track evidence staged but is not yet admitted. Stable v0.1.1
2729
contains the original five admitted packages. The check at
2830
[tests/collection-discovery-tests.ps1](../tests/collection-discovery-tests.ps1)
2931
guards package names, metadata, catalog entries, README links, header assets,

docs/MAINTENANCE.zh-CN.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88

99
每个事实只保留一个 authority,其他位置链接过去:包行为/触发/调用/输入/输出/资源以 `skills/<skill-name>/SKILL.md` 为准;变换包的 provenance 在 `ATTRIBUTION.md`;可读目录是 `CATALOG.md`;安装与证据是 `docs/INSTALLATION.md`;审查和 verdict 规则是 `docs/REVIEW_POLICY.md`;历史和 release notes 是 `CHANGELOG.md` 与真实 release;组合验证资产在 `docs/workflows/`
1010

11-
本分支的准入集合必须恰好包含 `review-loop``project-init``ask-light``learn-anything``manuscript-ops``recap``recap` 已通过纯提示型快速通道,但尚未发布;稳定 v0.1.1 仍包含原来的五个已准入包。`collection-discovery-tests.ps1` 负责检查包名、metadata、目录、README 链接、头图、治理路径、双语配对和退休 orchestration 边界,但不证明 runtime 或 fresh installation。
11+
本分支的准入集合必须恰好包含 `review-loop``project-init``ask-light``learn-anything``manuscript-ops``recap` 和已提议但尚未发布的 `language-learning``recap` 已通过纯提示型快速通道,但尚未发布`language-learning` 的纯提示型快速通道证据已准备好,但尚未准入;稳定 v0.1.1 仍包含原来的五个已准入包。`collection-discovery-tests.ps1` 负责检查包名、metadata、目录、README 链接、头图、治理路径、双语配对和退休 orchestration 边界,但不证明 runtime 或 fresh installation。
1212

1313
## 变更流程与同步矩阵
1414

0 commit comments

Comments
 (0)