@lincyaw/skills 1.0.0-rc.3 → 1.0.0-rc.31

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.
Files changed (49) hide show
  1. package/README.md +1 -1
  2. package/package.json +2 -3
  3. package/skills/index.json +16 -18
  4. package/skills/presmium-animate/SKILL.md +5 -3
  5. package/skills/presmium-animate/gallery/algorithms/lecture.json +171 -115
  6. package/skills/presmium-animate/gallery/anime/scenes/kmeans-seeded.ts +2 -1
  7. package/skills/presmium-animate/gallery/catalog/paper-figure/scenes/figure-tour.ts +41 -0
  8. package/skills/presmium-animate/gallery/catalog/paper-figure/scenes/figures/demo-figure.py +89 -0
  9. package/skills/presmium-animate/gallery/catalog/paper-figure/scenes/figures/demo.json +282 -0
  10. package/skills/presmium-animate/gallery/catalog/paper-figure/scenes/lib/figure.ts +206 -0
  11. package/skills/presmium-animate/gallery/catalog/paper-figure/scenes/lib/tour.ts +145 -0
  12. package/skills/presmium-animate/gallery/catalog/paper-figure/tools/figure.py +54 -0
  13. package/skills/presmium-animate/gallery/craft/lecture.json +109 -57
  14. package/skills/presmium-animate/gallery/data/lecture.json +1618 -368
  15. package/skills/presmium-animate/gallery/data/scenes/pf/figure-tour.ts +2 -0
  16. package/skills/presmium-animate/gallery/emphasis/lecture.json +321 -79
  17. package/skills/presmium-animate/gallery/films/lecture.json +36 -10
  18. package/skills/presmium-animate/gallery/lengths/lecture.json +23 -88
  19. package/skills/presmium-animate/gallery/lengths/scenes/kit/fx/time.ts +12 -0
  20. package/skills/presmium-animate/gallery/math-ml/lecture.json +238 -159
  21. package/skills/presmium-animate/gallery/paths-3d/lecture.json +74 -64
  22. package/skills/presmium-animate/gallery/product/lecture.json +27 -3
  23. package/skills/presmium-animate/gallery/story/lecture.json +23 -90
  24. package/skills/presmium-animate/gallery/structure/lecture.json +104 -65
  25. package/skills/presmium-animate/gallery/text/lecture.json +115 -63
  26. package/skills/presmium-animate/gallery/timeline/lecture.json +106 -187
  27. package/skills/presmium-animate/gallery/timeline/scenes/bubble.ts +1 -1
  28. package/skills/presmium-animate/gallery/transitions/lecture.json +103 -52
  29. package/skills/presmium-animate/references/lengths.md +2 -2
  30. package/skills/presmium-animate/references/libraries.md +22 -11
  31. package/skills/presmium-animate/references/procedural.md +2 -0
  32. package/skills/presmium-animate/references/scenarios.md +1 -0
  33. package/skills/presmium-animate/references/story.md +21 -7
  34. package/skills/presmium-animate/references/storyboards.md +1 -1
  35. package/skills/presmium-animate/references/team.md +176 -0
  36. package/skills/presmium-animate/references/timeline.md +6 -0
  37. package/skills/presmium-author/SKILL.md +58 -19
  38. package/skills/presmium-author/references/assistance.md +5 -1
  39. package/skills/{presmium-present → presmium-author}/references/classroom.md +2 -2
  40. package/skills/presmium-author/references/document.md +3 -1
  41. package/skills/{presmium-present → presmium-author}/references/lecture.md +36 -2
  42. package/skills/presmium-author/references/publishing.md +144 -15
  43. package/skills/presmium-author/references/writing.md +191 -7
  44. package/src/cli.ts +4 -4
  45. package/src/install.ts +42 -5
  46. package/src/messages.ts +5 -5
  47. package/src/resources.ts +5 -4
  48. package/skills/presmium-present/SKILL.md +0 -35
  49. package/skills/presmium-present/references/delivery.md +0 -122
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @lincyaw/skills
2
2
 
3
- The bundled `presmium-author`, `presmium-animate`, `presmium-present` and `presmium-develop` skills, with their references and animation gallery text. Their authority is the repository’s `.agents/skills`; packaging generates this package’s `skills/` resources and index.
3
+ The bundled `presmium-author`, `presmium-animate` and `presmium-develop` skills, with their references and animation gallery text. Their authority is the repository’s `.agents/skills`; packaging generates this package’s `skills/` resources and index.
4
4
 
5
5
  `listBundledSkills()` returns names, descriptions and relative file lists. `readBundledSkill({ name, path, offset, limit })` reads at most 12,000 Unicode characters and returns the next offset, package version and file SHA-256. `skillDirectory(name)` supplies a resource base to a host integration. Unsafe paths and unavailable files raise `SkillError` with a stable code.
6
6
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lincyaw/skills",
3
- "version": "1.0.0-rc.3",
3
+ "version": "1.0.0-rc.31",
4
4
  "description": "Presmium's bundled authoring, animation, presentation and plugin-development skills for coding agents",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -36,13 +36,12 @@
36
36
  ],
37
37
  "dependencies": {
38
38
  "jiti": "^2.7.0",
39
- "@lincyaw/kernel": "1.0.0-rc.3"
39
+ "@lincyaw/kernel": "1.0.0-rc.31"
40
40
  },
41
41
  "presmium": {
42
42
  "skills": [
43
43
  "presmium-author",
44
44
  "presmium-animate",
45
- "presmium-present",
46
45
  "presmium-develop"
47
46
  ],
48
47
  "generated": [
package/skills/index.json CHANGED
@@ -1,17 +1,19 @@
1
1
  [
2
2
  {
3
3
  "name": "presmium-author",
4
- "description": "Create and edit a Presmium teaching document: the sole authoritative lecture.json, stable pages and rich-text blocks, steps, narration, assets and component definitions; validate, preview and publish it. 写讲义、改文稿、安排页面、正文、分步与讲稿、检查和构建时使用。",
4
+ "description": "Write, edit, present and produce a Presmium teaching document: the sole lecture.json with its pages, blocks, steps and narration; its reading version (web page, notebook) and presentation version (slides, narrated lecture video); writing style for both; voiceover, captions, classroom, export and publishing. Use it to write or revise a lecture, plan pages, write slide text or narration, check, preview, present, record, generate voiceover or export. 写讲义、改文稿、写正文与幻灯片文字、写讲稿、配音、字幕、放映、上课、导出、发布时使用。",
5
5
  "files": [
6
6
  "SKILL.md",
7
7
  "references/assistance.md",
8
+ "references/classroom.md",
8
9
  "references/code.md",
9
10
  "references/document.md",
11
+ "references/lecture.md",
10
12
  "references/publishing.md",
11
13
  "references/writing.md"
12
14
  ],
13
- "version": "1.0.0-rc.3",
14
- "hash": "3f841d69e55215c71ce44c08a8d5637ed5b6a94be165f9a75283c7df08dbac0c"
15
+ "version": "1.0.0-rc.31",
16
+ "hash": "723fa37079559a044f3a7bf637fd6c968a0fcfada765c7c8bd3259e1df5890cf"
15
17
  },
16
18
  {
17
19
  "name": "presmium-animate",
@@ -98,6 +100,12 @@
98
100
  "gallery/catalog/motion-showcase/scenes/stop-motion.ts",
99
101
  "gallery/catalog/motion-showcase/scenes/surround.ts",
100
102
  "gallery/catalog/motion-showcase/scenes/whiteboard-sketch.ts",
103
+ "gallery/catalog/paper-figure/scenes/figure-tour.ts",
104
+ "gallery/catalog/paper-figure/scenes/figures/demo-figure.py",
105
+ "gallery/catalog/paper-figure/scenes/figures/demo.json",
106
+ "gallery/catalog/paper-figure/scenes/lib/figure.ts",
107
+ "gallery/catalog/paper-figure/scenes/lib/tour.ts",
108
+ "gallery/catalog/paper-figure/tools/figure.py",
101
109
  "gallery/catalog/product-ui/scenes/ai-answer.ts",
102
110
  "gallery/catalog/product-ui/scenes/before-after.ts",
103
111
  "gallery/catalog/product-ui/scenes/chat-thread.ts",
@@ -215,6 +223,7 @@
215
223
  "gallery/data/scenes/motion/bars.ts",
216
224
  "gallery/data/scenes/motion/counter.ts",
217
225
  "gallery/data/scenes/motion/ring.ts",
226
+ "gallery/data/scenes/pf/figure-tour.ts",
218
227
  "gallery/data/scenes/remotion/bar-chart.ts",
219
228
  "gallery/data/scenes/remotion/counter.ts",
220
229
  "gallery/data/scenes/show/stat-gauge.ts",
@@ -533,22 +542,11 @@
533
542
  "references/scenarios.md",
534
543
  "references/story.md",
535
544
  "references/storyboards.md",
545
+ "references/team.md",
536
546
  "references/timeline.md"
537
547
  ],
538
- "version": "1.0.0-rc.3",
539
- "hash": "9e3a9ca95da8c619742adbcfee68112d426a48b442fd375b367e5e5fb3cf5a21"
540
- },
541
- {
542
- "name": "presmium-present",
543
- "description": "Present and deliver a Presmium document, run classroom interaction, export or record it, and manage structured narration, real speech synthesis, subtitles and video playback from lecture.json production settings. 放映、上课、导出、录课、配音、字幕与讲授视频时使用。",
544
- "files": [
545
- "SKILL.md",
546
- "references/classroom.md",
547
- "references/delivery.md",
548
- "references/lecture.md"
549
- ],
550
- "version": "1.0.0-rc.3",
551
- "hash": "04a41943c1bb3ef1a13bf9847946b27b16535dd78358e606de2d999730217560"
548
+ "version": "1.0.0-rc.31",
549
+ "hash": "76dc5b50143b8134b36c010e5416033652071373500f214f4e7b1792af8a0c4a"
552
550
  },
553
551
  {
554
552
  "name": "presmium-develop",
@@ -558,7 +556,7 @@
558
556
  "references/plugin.md",
559
557
  "references/testing.md"
560
558
  ],
561
- "version": "1.0.0-rc.3",
559
+ "version": "1.0.0-rc.31",
562
560
  "hash": "9b3cab9683b45f11c631a19f916639ffb4c0f74c054c14baee24aa5655a35de4"
563
561
  }
564
562
  ]
@@ -27,21 +27,23 @@ A teaching segment, an explainer or paper video, a promo, a product demo and a d
27
27
 
28
28
  [Story](references/story.md) is the process, each stage ending in a check: brief, thesis, central picture, three storylines for the person to pick, a storyboard of rest frames with what carries each boundary, the script, an animatic the person approves, motion, review against the spec and with cold viewers. [Storyboards](references/storyboards.md) has filled-in examples for popular science, papers, courses, data stories and products; [Scenarios](references/scenarios.md) the usual pictures for each subject.
29
29
 
30
+ A piece too large for one agent is made from one storyboard file every agent reads, with a term table that gives each term its definition and first page, shared scene modules that only the coordinator changes, edits through the MCP author actions, a reading of its own words every agent does against the storyboard, review rounds appended to the storyboard and a cold read by a fresh agent in three passes: [Team](references/team.md).
31
+
30
32
  ## 5. Motion, rhythm and sound
31
33
 
32
34
  [Lengths](references/lengths.md): what each second shows at 1, 5, 10, 30 and 60 s, the rules every piece follows, the polish list, measured rhythm, carrying beats instead of replacing them, an operated camera, product screens, sound and music, and how to build and export a film.
33
35
 
34
36
  ## 6. Implementation
35
37
 
36
- Keep animation code in `scenes/<name>.ts` or another project file, using the installed `@lincyaw/addon-motion/scene` public exports (`defineScene`, `gsapScene`, `animeScene`, `motionScene`, `d3Scene`, `threeScene`, `remotionScene`); read the actual public types before choosing one. [Libraries](references/libraries.md) picks the library by the picture, lists each one's pitfalls and indexes every gallery piece under "Find an effect"; [Timeline](references/timeline.md) aligns steps and narration; [Procedural](references/procedural.md) covers motion computed from mathematics and where assets come from. Scene sources live in `gallery/<library>/scenes/` and `gallery/catalog/<deck>/scenes/` (ready pieces whose text, images and data are parameters). The gallery's documents show them by scenario: `algorithms`, `data`, `math-ml`, `text`, `emphasis`, `structure`, `product`, `transitions`, `paths-3d` and `craft`, each scene forwarded from its source by a one-line file; `gallery/lengths` (pieces by length and the shared `kit/`), `gallery/films`, `gallery/story` (the worked narrated example) and `gallery/timeline` are documents of their own. Inspect the closest real example instead of inventing an API. The repository’s `examples/gallery/animation-library` links to this same gallery; `pnpm studio` copies it into a workspace with regular files for editing. Keep reusable effect sources here and method guidance in `references/`; complete public courses and product examples belong in `examples/gallery/`.
38
+ Keep animation code in `scenes/<name>.ts` or another project file, using the installed `@lincyaw/addon-motion/scene` public exports (`defineScene`, `gsapScene`, `animeScene`, `motionScene`, `d3Scene`, `threeScene`, `remotionScene`); read the actual public types before choosing one. [Libraries](references/libraries.md) picks the library by the picture, lists each one's pitfalls and indexes every gallery piece under "Find an effect"; [Timeline](references/timeline.md) aligns steps and narration; [Procedural](references/procedural.md) covers motion computed from mathematics and where assets come from. Scene sources live in `gallery/<library>/scenes/` and `gallery/catalog/<deck>/scenes/` (ready pieces whose text, images and data are parameters; `catalog/paper-figure` explains a paper's own figure and ships the crop tool `tools/figure.py`). The gallery's documents show them by scenario: `algorithms`, `data`, `math-ml`, `text`, `emphasis`, `structure`, `product`, `transitions`, `paths-3d` and `craft`, each scene forwarded from its source by a one-line file; `gallery/lengths` (pieces by length and the shared `kit/`), `gallery/films`, `gallery/story` (the worked narrated example) and `gallery/timeline` are documents of their own. Inspect the closest real example instead of inventing an API. The repository’s `examples/gallery/animation-library` links to this same gallery; `pnpm studio` copies it into a workspace with regular files for editing. Keep reusable effect sources here and method guidance in `references/`; complete public courses and product examples belong in `examples/gallery/`.
37
39
 
38
40
  Register an explicit component definition in `definitions` with a file implementation reference, parameter Schema and declared states. Insert a component block pointing to it; put its state on the corresponding section's steps. Stable state IDs describe implementation states, not the component's position in the document. Existing migrated numeric bindings retain explicit `legacyIndex`; do not rename their numbers into guessed semantic states. Use design tokens for styling, reuse the project's semantic icons and public host controls, dispose timelines, subscriptions, canvas/WebGL resources and timers, provide readable static fallback data and report unsupported rendering capabilities.
39
41
 
40
42
  ## 7. Voice, verify and deliver
41
43
 
42
- Narration is structured in `narrations`; steps name narration IDs. Cue targets use stable block IDs. Timing and voice inheritance belong in `production`, never a second timing object on a step or scene. The voice comes from the workspace's speech engine (Volcengine built in, or an OpenAI-compatible service); see `presmium-present/references/lecture.md` for synthesis, playback and export.
44
+ Narration is structured in `narrations`; steps name narration IDs. Cue targets use stable block IDs. Timing and voice inheritance belong in `production`, never a second timing object on a step or scene. While the narrated lecture plays, each scene state lasts until its step's voice ends: place beats at fractions of their state (`at(k) + f * durations[k]`) and never rewrite `durations` to the voice ([Timeline](references/timeline.md)). The voice comes from the workspace's speech engine (Volcengine built in, or an OpenAI-compatible service); see `presmium-author/references/lecture.md` for synthesis, playback and export, and `presmium-author/references/writing.md` for how narration is written.
43
45
 
44
- Validate the edited document, then build only the relevant form. Open the actual result, jump forward and backward in arbitrary order, and inspect the static fallback if it matters. Do not claim an animation works merely because JSON validation or compilation succeeded.
46
+ Validate the edited document (`presmium check` or `check_document` also bundles each scene and reports one that doesn't compile, with its file and line), then look at the actual result. With the MCP server, `capture_slides` gives the rest frame of each step of a page and, with `at`, frames that many milliseconds into a step's animation, drawn by the step clock as a lecture export draws them, so they are reproducible; `measure` returns the boxes of elements (a CSS selector) in slide pixels, for positions and overlaps. Capture the steps in any order you like, since each picture is made from its step and time alone; `arrive: 'backward'` checks that going back to a step shows its frame, and `capture_reading` shows the scene on the reading page, also at a phone width (390). Without the MCP server, build only the relevant form, open it, jump forward and backward in arbitrary order, and inspect the static fallback if it matters (exports print it). Do not claim an animation works merely because JSON validation or compilation succeeded, and do not write browser scripts for pictures the tool takes.
45
47
 
46
48
  ```sh
47
49
  presmium check lesson --json