@lincyaw/skills 1.0.0-rc.49 → 1.0.0-rc.50

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.49",
3
+ "version": "1.0.0-rc.50",
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.49"
39
+ "@lincyaw/kernel": "1.0.0-rc.50"
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.49",
16
- "hash": "658aed8293e71600bd2c6818a29866ce7669302df94429ad26fa0d72faa4dd16"
15
+ "version": "1.0.0-rc.50",
16
+ "hash": "17113589f60fa9a0ab3a05193c851e5cacedac7e3aee6ff1ad6a926099d3974d"
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.49",
548
+ "version": "1.0.0-rc.50",
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.49",
559
+ "version": "1.0.0-rc.50",
560
560
  "hash": "af8f48dbe9dbc5bd772fa3d6172ae9c9b96626fec2cd7933b4e08f7c5f154b75"
561
561
  }
562
562
  ]
@@ -44,7 +44,7 @@ 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.** `get_context` gives the current saved page, step, narration and actually reported selection. When no editor is connected or several targets are possible, name the document/page explicitly; `list_documents` lists documents. Pending editor state is not saved draft content.
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. The external MCP catalog is compact. Find additional actions with `operations`, inspect one by name for generated argument summaries, and request `schema:true` only for a complete input definition. Dispatch through the matching read/edit/spend/write/agent operation tool. CLI `presmium mcp tools <tool>` returns a summary, `--schema` the complete input schema and `tools --all --json` the full catalog.
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. The external MCP catalog is compact. Find additional actions with `operations`, inspect one by name for generated argument summaries, and request `schema:true` only for a complete input definition. For a tool with variants, select the needed action with `name` and `variant` (for example `editor_action` and `body-drafts.read`); its arguments come from the original schema, without returning the other actions. Dispatch through the matching read/edit/spend/write/agent operation tool. CLI `presmium mcp tools <tool>` returns a summary, `--schema` the complete input schema and `tools --all --json` the full catalog.
48
48
  3. **Save in one call.** Use `rename_page` for a title, `edit_narration` for a unique exact phrase replacement or deletion, and the discovered `edit_document` operation for canonical operations on text, blocks, steps, narration, timing and assets. Narration edits default to the current editor page/step; missing or ambiguous original text is refused. Comments, voice, caption scale and component parameters also have generated one-call actions such as `comment_create`, `voice_set` and `caption_scale_set`. 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 returns saved/changed and editor status; request details only for diagnostics. Versions, hashes, plans and source readback stay on the server for ordinary edits. 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
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
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.