@dzhechkov/skills-book-digitizer 0.2.10 → 0.2.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -44,6 +44,21 @@ Distilled skills + their KUs + routing evals from `book-skill-distill`. `dz benc
44
44
  owner-local — the skill degrades honestly.
45
45
  3. **`files[]` whitelist** every skill dir + `references`/`evals` + `brain/` (the KB slice, step 9) +
46
46
  `sources.json` + `README.md` + `LICENSE` (forget one → npm silently drops it). Verify the tarball after.
47
+ 3b. **README MUST include a "Usage scenarios" section (MANDATORY), leading with the SIMPLEST usage.**
48
+ The section MUST **open with the easiest path a non-expert can actually follow** — NOT a giant
49
+ `--select id,id,id,…` list (nobody types 12 ids). Lead with: (1) install the WHOLE pack in ONE
50
+ command — `dz install <npm-pkg> --target claude-code` for a published pack (or, for a private/local
51
+ pack, `dz init --target claude-code --select <ids>` noting it installs all), then (2) **just describe
52
+ the task to Claude Code in plain language** — e.g. «используй нужные скиллы из набора <slug> для
53
+ решения задачи: <описание>» — and the agent **auto-selects** the right skills (routing-gated); the
54
+ user never types skill ids. THEN author **3–6 of the most likely, most useful scenarios**, each as a
55
+ titled subsection with: (a) a concrete *situation*, (b) a **real natural-language example prompt**
56
+ (RU+EN) the user types to their agent (the prompt is the primary action — the pack is already
57
+ installed), (c) **which skills fire and what the agent does** (the concrete outcome). Keep the
58
+ granular `dz init --select <one-id>` only as an optional "just this one decision" advanced note.
59
+ Ground scenarios in the BOOK's actual decisions (audit/refactor, greenfield design, a
60
+ decision-at-a-moment, onboarding/teaching-the-why, a domain workflow). This turns "N skills" into
61
+ "here's the easy way to use them"; a pack README without it is incomplete.
47
62
  4. **`package.json` distribution guardrails (structural, not policy):**
48
63
  `"private": true` + `"publishConfig": { "access": "restricted" }`. **No automatic
49
64
  `harness-presets` entry** (presets are the public install surface). Flipping to publishable
@@ -99,6 +114,7 @@ Distilled skills + their KUs + routing evals from `book-skill-distill`. `dz benc
99
114
  ## Self-check
100
115
 
101
116
  - [ ] `files[]` whitelists every dir; tarball verified?
117
+ - [ ] **README has a "Usage scenarios" section — 3–6 real situations, each with an example prompt, which skills fire, and the install command?**
102
118
  - [ ] `references/` deep-lookup ships inside the pack; tiers declared in sources.json?
103
119
  - [ ] `private:true` + restricted; no auto preset; CP5 recorded if publishing?
104
120
  - [ ] Collision gate clean; slug-prefixed unique ids?
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dzhechkov/skills-book-digitizer",
3
- "version": "0.2.10",
3
+ "version": "0.2.14",
4
4
  "description": "Canonical book-digitizer skill pack — 8 skills that turn an engineering book/textbook/monograph into an installable skill pack whose skills make AI coders work within the book's methodologies: digitize-book (orchestrator), book-ingest, book-knowledge-extract, book-skill-distill, book-pack-assemble, book-kb-index, book-brain-register (terminal promote-to-brain, CP6), source-brain-ingest (repo/dir sibling).",
5
5
  "license": "MIT",
6
6
  "author": "dzhechko",