@klickd/core 4.0.0 → 4.0.2

package/README.md

@@ -110,6 +110,42 @@ const recovered = await loadKlickd(
 
 See `SPEC.md §33` and `examples/v4-preview/` for preview-track details.
 
+### Starter `.klickd` skills (v4.0 envelope — non-normative)
+
+Four real, structured, downloadable starter `.klickd` skills ship under [`examples/v4/starter-skills/`](https://github.com/Davincc77/klickdskill/tree/main/examples/v4/starter-skills):
+
+- [`user.klickd`](https://github.com/Davincc77/klickdskill/blob/main/examples/v4/starter-skills/user.klickd) — `x.klickd/user` (transversal base)
+- [`student.klickd`](https://github.com/Davincc77/klickdskill/blob/main/examples/v4/starter-skills/student.klickd) — `x.klickd/student` (education)
+- [`research.klickd`](https://github.com/Davincc77/klickdskill/blob/main/examples/v4/starter-skills/research.klickd) — `x.klickd/research` (research / evidence discipline)
+- [`coding.klickd`](https://github.com/Davincc77/klickdskill/blob/main/examples/v4/starter-skills/coding.klickd) — `x.klickd/coding` (software engineering)
+
+Each skill carries `base_transversal_core`, framework-anchored `competencies[]` (ESCO / DigComp / LifeComp / EQF / CEFR / SFIA), `levels[]`, `mastery[]` (pointer-only), `source_policy`, `evidence_policy`, `verification_gates`, `human_authority`, and a `structured_memory` slice scoped to `memory.x_klickd.<pack>`. They are **non-normative** and trigger **no release**. SHA-256 manifest in [`manifest.json`](https://github.com/Davincc77/klickdskill/blob/main/examples/v4/starter-skills/manifest.json); offline verifier `scripts/verify_starter_skills.py`.
+
+#### Bundled in `@klickd/core` 4.0.1
+
+Starting with **`@klickd/core` 4.0.1** (a packaging-only patch — the stable
+spec release remains **v4.0.0**), these four starter `.klickd` skills are
+shipped inside the npm tarball under `starter-skills/` and exposed through a
+small helper API. The on-the-wire `.klickd` format, the bundled JSON schemas,
+and the spec are unchanged from v4.0.0. This patch ships only the starter
+skill packaging fix; no new schema material is introduced.
+
+```typescript
+import {
+  listStarterSkills,
+  getStarterSkillBytes,
+  getStarterSkillsManifest,
+  getStarterSkillsDir,
+} from '@klickd/core';
+
+listStarterSkills();
+// → ['coding.klickd', 'research.klickd', 'student.klickd', 'user.klickd']
+
+const bytes = getStarterSkillBytes('user.klickd');
+const manifest = getStarterSkillsManifest();
+const dir = getStarterSkillsDir(); // absolute path to bundled starter-skills/
+```
+
 ---
 
 ## Cryptographic specification (v3.0)