@lincyaw/skills 1.0.0-rc.38 → 1.0.0-rc.39
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.
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lincyaw/skills",
|
|
3
|
-
"version": "1.0.0-rc.
|
|
3
|
+
"version": "1.0.0-rc.39",
|
|
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,7 +36,7 @@
|
|
|
36
36
|
],
|
|
37
37
|
"dependencies": {
|
|
38
38
|
"jiti": "^2.7.0",
|
|
39
|
-
"@lincyaw/kernel": "1.0.0-rc.
|
|
39
|
+
"@lincyaw/kernel": "1.0.0-rc.39"
|
|
40
40
|
},
|
|
41
41
|
"presmium": {
|
|
42
42
|
"skills": [
|
package/skills/index.json
CHANGED
|
@@ -12,8 +12,8 @@
|
|
|
12
12
|
"references/publishing.md",
|
|
13
13
|
"references/writing.md"
|
|
14
14
|
],
|
|
15
|
-
"version": "1.0.0-rc.
|
|
16
|
-
"hash": "
|
|
15
|
+
"version": "1.0.0-rc.39",
|
|
16
|
+
"hash": "b91dfb9757d8789661d7b3137a6bfe2a8cb31c2e5dfc7ef60be3bde08b4f3788"
|
|
17
17
|
},
|
|
18
18
|
{
|
|
19
19
|
"name": "presmium-animate",
|
|
@@ -545,7 +545,7 @@
|
|
|
545
545
|
"references/team.md",
|
|
546
546
|
"references/timeline.md"
|
|
547
547
|
],
|
|
548
|
-
"version": "1.0.0-rc.
|
|
548
|
+
"version": "1.0.0-rc.39",
|
|
549
549
|
"hash": "76dc5b50143b8134b36c010e5416033652071373500f214f4e7b1792af8a0c4a"
|
|
550
550
|
},
|
|
551
551
|
{
|
|
@@ -556,7 +556,7 @@
|
|
|
556
556
|
"references/plugin.md",
|
|
557
557
|
"references/testing.md"
|
|
558
558
|
],
|
|
559
|
-
"version": "1.0.0-rc.
|
|
559
|
+
"version": "1.0.0-rc.39",
|
|
560
560
|
"hash": "dc7affcbc93157f7595991a5a34810d733ac2060eecb408da2fba0e7ab3ea1c2"
|
|
561
561
|
}
|
|
562
562
|
]
|
|
@@ -44,10 +44,10 @@ Each page has one idea and two versions. The reading version is written like a b
|
|
|
44
44
|
When the MCP server `presmium` offers author actions (the studio's assistant; or `presmium mcp` while Presmium Studio or `presmium serve` runs for the project, which a new project's `.mcp.json` connects Claude Code to), change the document through them, the same actions the studio's buttons use. The server's instructions list this order too; each tool describes its own parameters.
|
|
45
45
|
|
|
46
46
|
1. **Find the target.** `list_documents`; `get_focus` gives what the author has selected or pointed at, so "this page" or "this paragraph" means that.
|
|
47
|
-
2. **Read
|
|
48
|
-
3. **
|
|
49
|
-
4. **
|
|
50
|
-
5. **
|
|
47
|
+
2. **Read the context the edit needs.** An explicit title change goes straight to `rename_page` with `section` (page number from 1, or stable ID) and `title`. For content, use `get_document_outline` and `read_document_part` for the complete values you will change and the relevant surrounding pages. An advertised tool does not require a separate capability request. Parameter schemas come from MCP tools/list; from the command line, `presmium mcp tools <tool>` returns that same definition, and `presmium mcp tools --json` returns all definitions.
|
|
48
|
+
3. **Save in one call.** Use `rename_page` for a title and `edit_document` for canonical operations on text, blocks, steps, narration, timing and assets. The server reads the current source, preflights, saves and verifies the saved source internally; no separate plan/apply/readback requests are needed. Pass optional `source` when the intent depends on a prior read. A 409 requires a fresh read and an explicit decision, never an automatic retry. The owner's MCP credential already authorizes canonical document editing; execution and paid generation keep their confirmation policies. A simple edit's receipt includes the saved source and reported editor/preview synchronization. Plan/apply tools remain for complex reviewed changes, page creation/move/deletion and duplication; deletion retains explicit confirmation. A refused approval is final for that request.
|
|
49
|
+
4. **Use the returned evidence.** For a simple edit, report its saved value and editor feedback; do not run whole-document checks or captures by default. Run `check_document` and `get_diagnostics` for code or structural changes, reported failures, or when requested. Fix what you caused; report what you cannot fix. Pending or unavailable editor feedback does not invalidate a successful save or justify repeating the write.
|
|
50
|
+
5. **Inspect appearance when the task needs it.** For layout and animation work, `capture_slides` returns the changed page at rest, with `at` for animation moments and `measure` for element boxes. `capture_reading` checks reading layout and phone width; `capture_overview` reviews a deck. Capture only the affected scope. Saved source and reported editor synchronization do not prove visual layout or playback. Don't script a browser for this.
|
|
51
51
|
6. **Voiceover and outputs are explicit.** Editing narration never generates audio. Read `get_voiceover_status`, tell the author the engine, the voice and the number of sentences (a cloud engine charges for them), and call `start_voiceover` only after the author agrees; without an MCP host, `presmium voiceover` gives the same report and generates with `--yes`. `build` and `get_builds` make and list outputs. Details in [Lecture production](references/lecture.md) and [Publishing](references/publishing.md).
|
|
52
52
|
|
|
53
53
|
Undo is `undo_document_change`; `get_document_history` lists the saved changes.
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Editing with the studio and an agent
|
|
2
2
|
|
|
3
|
+
For an explicit title change use `rename_page` with the page number or stable ID and title. For other canonical content changes use `edit_document` with operations. Both read the source, preflight, save through the Web transaction/history and verify saved content inside one call; pass optional source when intent depends on an earlier read. Their receipt includes observed editor synchronization separately from saved source and prepared preview. Pending feedback never means that the save should be repeated. Use plan/apply tools when a change needs separate impact review. The local owner's MCP credential authorizes canonical editing without a second Studio confirmation; execution, browser control and paid generation retain their own policies. CLI parameter discovery is automatic: `presmium mcp tools <tool>` returns the live tools/list definition, including inputSchema, and `tools --json` returns all definitions. Do not look up tool parameters in implementation source.
|
|
4
|
+
|
|
3
5
|
For an external HTTP MCP client, start Studio and configure `http://127.0.0.1:4321/mcp` (Streamable HTTP) with `Authorization: Bearer <token>` from the token file printed at startup. Studio preserves both for the same launch directory across restarts and upgrades. With `--host 0.0.0.0`, use the printed network MCP URL from other machines. A second Studio needs a different fixed `--preview-port`; an occupied port fails instead of silently changing the URL.
|
|
4
6
|
|
|
5
7
|
Install Presmium once with `pnpm add -g @lincyaw/presmium`; Studio is included. Run `presmium studio <workspace-or-document>`; open the complete address it prints. Editing and preview need no model. The document editor uses one native BlockNote editing surface across the whole document, including cross-block selection and native history/comments. An animation or chart preview's toolbar has Comment on step for the whole content block or one step.
|