@dzhechkov/skills-book-digitizer 0.2.10 → 0.2.12

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,15 @@ 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).** Beyond the skills table + install
48
+ commands, author **3–6 of the most likely, most useful ways a user would actually reach for this
49
+ pack**, each as a titled subsection with: (a) a concrete *situation* ("You're containerizing a
50
+ legacy service…"), (b) a **real example prompt** the user would type to their agent (RU+EN), (c)
51
+ **which skills fire and what the agent does** (the concrete outcome), and (d) the command to install
52
+ just the skills that scenario needs. Ground the scenarios in the BOOK's actual decisions — pick the
53
+ situations where this book's methods pay off (audit/refactor, greenfield design, a specific
54
+ decision-at-a-moment, onboarding/teaching-the-why, a domain-specific workflow). This is what turns
55
+ "12 skills" into "here's why you'd install them"; a pack README without it is incomplete.
47
56
  4. **`package.json` distribution guardrails (structural, not policy):**
48
57
  `"private": true` + `"publishConfig": { "access": "restricted" }`. **No automatic
49
58
  `harness-presets` entry** (presets are the public install surface). Flipping to publishable
@@ -99,6 +108,7 @@ Distilled skills + their KUs + routing evals from `book-skill-distill`. `dz benc
99
108
  ## Self-check
100
109
 
101
110
  - [ ] `files[]` whitelists every dir; tarball verified?
111
+ - [ ] **README has a "Usage scenarios" section — 3–6 real situations, each with an example prompt, which skills fire, and the install command?**
102
112
  - [ ] `references/` deep-lookup ships inside the pack; tiers declared in sources.json?
103
113
  - [ ] `private:true` + restricted; no auto preset; CP5 recorded if publishing?
104
114
  - [ ] 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.12",
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",