AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
fix(skill): anchor runtime paths to installed root
hugohe311faacfebd6f
diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.mdindex f61512ed..712df87f 100644--- a/skills/ppt-master/SKILL.md+++ b/skills/ppt-master/SKILL.md@@ -24,11 +24,17 @@ PPT Master is a routed presentation workflow. This entry owns global execution d## Mandatory Load Order+**Hard rule — paths before commands**: Retain the host-provided absolute+directory containing this file as `SKILL_DIR`. Per tool call, expand+`${SKILL_DIR}` and replace any `skills/ppt-master/` prefix with it. Never `cd`,+use CWD, or assume a repo checkout. If unavailable, ask; never search or guess.+1. Read this file.-2. Run `python3 scripts/attribution_guard.py` from this Skill directory. Any- non-zero result stops the Skill immediately; do not inspect, repair, or- bypass the integrity gate.-3. Read [`workflows/routing.md`](workflows/routing.md).+2. Run `python3 "${SKILL_DIR}/scripts/attribution_guard.py"`. Any non-zero result+ stops the Skill immediately; do not inspect, repair, or bypass the integrity+ gate.+3. Read [`workflows/routing.md`](workflows/routing.md) through the concrete+ absolute path `${SKILL_DIR}/workflows/routing.md`.4. Select exactly one top-level route and its active profile from the routingauthority.5. Read only the resulting runtime authority and its explicitly triggered@@ -61,7 +67,6 @@ never compete with it.5. **No speculative execution** — Do not prepare later-phase artifacts before their owning step.6. **Deterministic routing** — Do not add a route-choice question when [`routing.md`](workflows/routing.md) resolves the request. If a route prerequisite is missing, state it and stop that route.7. **Owning-source recovery** — On failure, repair or regenerate the owning source artifact and resume from the route's declared pointer. Do not silently downgrade a required artifact.-8. **Stable paths** — Use absolute skill/project paths; never derive them from CWD. The Skill root is the directory containing `SKILL.md`; the host supplies its path. If it cannot be determined, ask the user — never guess it via file search.## Global Communication Rulesdiff --git a/skills/ppt-master/scripts/attribution_guard.py b/skills/ppt-master/scripts/attribution_guard.pyindex d43cb2be..023199aa 100644--- a/skills/ppt-master/scripts/attribution_guard.py+++ b/skills/ppt-master/scripts/attribution_guard.py@@ -6,10 +6,10 @@ Fail closed when the distributed Skill attribution bundle or its executiongates are missing or modified.Usage:- python3 scripts/attribution_guard.py+ python3 "<absolute-skill-root>/scripts/attribution_guard.py"Examples:- python3 scripts/attribution_guard.py+ python3 "/opt/agent-skills/ppt-master/scripts/attribution_guard.py"Dependencies:None (only uses standard library)@@ -52,7 +52,7 @@ _REQUIRED_GATE_FILES = ("scripts/register_template.py","scripts/template_preview_pptx.py",)-_SKILL_GATE_MARKER = "python3 scripts/attribution_guard.py"+_SKILL_GATE_MARKER = 'python3 "${SKILL_DIR}/scripts/attribution_guard.py"'_SECONDARY_GATE_FILE = "scripts/console_encoding.py"_SECONDARY_GATE_NAME = "_require_official_distribution_identity"diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex b1c53880..4738c0a2 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -8,6 +8,10 @@ description: Default Generate PPTX authority for source intake, planning, SVG au> Beautify profile. This file owns that runtime's Step 1–7 sequence, gates, role> switching, and mandatory commands. Explicit Quick loads its own profile instead.+**Hard rule — runtime paths**: Resolve every linked or abbreviated package path+below from the entry-time `SKILL_DIR` anchor and expand it inside each tool+call. Never change CWD or inherit a prior shell working directory.+**Default Core Pipeline**: `Initial Materials → [Fact Research] → Create Project → Template Candidate Preparation → Stage-1 Communication + Template Confirmation → [Template Installation] → Stage-2 Solution → [Image Acquisition] → Executor Live Preview → Quality Check → Post-processing → Export`**Generate-specific execution discipline**:@@ -257,8 +261,8 @@ a deck's larger identity/slide-library files only when the specific need belowarises.```-Read references/strategist.md-Read references/canvas-formats.md+Read ${SKILL_DIR}/references/strategist.md+Read ${SKILL_DIR}/references/canvas-formats.md```Then load only the extra role modules triggered by the current plan:@@ -273,15 +277,15 @@ below in one batch before authoring any Stage-2 whole-solution intent, imagesource recommendation, or page roster:```-Read references/strategist-image.md-Read references/image-layout-spec.md-Read references/image-layout-patterns.md-Read references/modes/_index.md-Read references/visual-styles/_index.md-Read references/image-renderings/_index.md-Read templates/icons/README.md-Read templates/charts/chart-vocabulary.md-Read templates/tables/table-vocabulary.md+Read ${SKILL_DIR}/references/strategist-image.md+Read ${SKILL_DIR}/references/image-layout-spec.md+Read ${SKILL_DIR}/references/image-layout-patterns.md+Read ${SKILL_DIR}/references/modes/_index.md+Read ${SKILL_DIR}/references/visual-styles/_index.md+Read ${SKILL_DIR}/references/image-renderings/_index.md+Read ${SKILL_DIR}/templates/icons/README.md+Read ${SKILL_DIR}/templates/charts/chart-vocabulary.md+Read ${SKILL_DIR}/templates/tables/table-vocabulary.md```This is a capability map, not a usage checklist: retain zero-use outcomes and@@ -525,7 +529,7 @@ in Step 7.1. This is frozen production input, not a third planning artifact.**Always load the common framework**:```-Read references/image-base.md+Read ${SKILL_DIR}/references/image-base.md```Then **lazy-load the path-specific reference** for each row that actually needs it:@@ -587,7 +591,7 @@ Workflow:Read the Executor role core before applying its context policy:```-Read references/executor-base.md # REQUIRED: flat/shared execution core+Read ${SKILL_DIR}/references/executor-base.md # REQUIRED: flat/shared execution core```**Planning context**: follow [`executor-base.md`](../references/executor-base.md) §2.1. Reuse the complete Design Spec and lock in an unchanged, uncompacted context. Fresh/resumed/restarted, compacted/summary-only, or externally/unknown changed execution reads both once and reloads triggered inputs. For a local question, consult the retained lock first, then only the owning Design Spec fragment; do not poll files merely to prove validity.@@ -608,14 +612,14 @@ Read the exact execution references named by this deck's retained`spec_lock.md`; do not reopen the planning indexes. Load the remaining fixedconstruction block plus the resolved mode/style detail files as one batch:```-Read references/shared-standards-core.md # REQUIRED: SVG compatibility + shared aesthetic/leading baseline-Read references/svg-effects.md # REQUIRED: Visual Job Router + effects/construction vocabulary-Read references/native-shape-authoring.md # REQUIRED: native-shape selection and Boolean construction-Read references/preset-shape-vocabulary.md # REQUIRED: complete 187-name authoring vocabulary-Read references/executor-structure.md # REQUIRED: qualitative relationship and topology grammar-Read references/semantic-svg.md # REQUIRED: semantic metadata boundary-Read references/modes/<resolved-id>.md # one preset id, or each `mode_references` id-Read references/visual-styles/<resolved-id>.md # one preset id, or each `visual_style_references` id+Read ${SKILL_DIR}/references/shared-standards-core.md # REQUIRED: SVG compatibility + shared aesthetic/leading baseline+Read ${SKILL_DIR}/references/svg-effects.md # REQUIRED: Visual Job Router + effects/construction vocabulary+Read ${SKILL_DIR}/references/native-shape-authoring.md # REQUIRED: native-shape selection and Boolean construction+Read ${SKILL_DIR}/references/preset-shape-vocabulary.md # REQUIRED: complete 187-name authoring vocabulary+Read ${SKILL_DIR}/references/executor-structure.md # REQUIRED: qualitative relationship and topology grammar+Read ${SKILL_DIR}/references/semantic-svg.md # REQUIRED: semantic metadata boundary+Read ${SKILL_DIR}/references/modes/<resolved-id>.md # one preset id, or each `mode_references` id+Read ${SKILL_DIR}/references/visual-styles/<resolved-id>.md # one preset id, or each `visual_style_references` id```Keep the core's shared visual-quality defaults and `svg-effects.md` §6.1 Visual Job Router active during page authoring; they are not passive compatibility reading. Explicit user/template requirements and the locked style override compatible aesthetic defaults, never technical Required / Forbidden boundaries.@@ -708,7 +712,7 @@ Run the command unfiltered—do not pipe it through `tail`, `head`, `grep`, or a| Signal | Reading ||---|---|-| Two or more issues share a category and direction | Method-level bias — resolve it to the authoritative rule before P02; a correction fitted to the observed offset only patches this sample. For text extents that rule is `svg_to_pptx.drawingml.elements.estimate_single_line_text_frame_width(runs)`, with `skills/ppt-master/scripts` on `sys.path` and every run key present — `text`, `font_size`, `font_family`, `font_weight`, `letter_spacing` — since omissions under-measure |+| Two or more issues share a category and direction | Method-level bias — resolve it to the authoritative rule before P02; a correction fitted to the observed offset only patches this sample. For text extents that rule is `svg_to_pptx.drawingml.elements.estimate_single_line_text_frame_width(runs)`, with `${SKILL_DIR}/scripts` on `sys.path` and every run key present — `text`, `font_size`, `font_family`, `font_weight`, `letter_spacing` — since omissions under-measure || One isolated issue tied to this page's structure | Page-local — fix and continue || A recurring element appears for the first time (page furniture, caption format, section numbering, accent discipline) | It will be copied to every later page — confirm its semantics now |diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex 6ab9371d..0fd040a1 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -13,6 +13,10 @@ description: One-pass Generate profile for agent-decided preparation, direct SVGstrategy/confirmation, or directs the agent to proceed to SVG and export.Page count alone never activates or blocks this profile.+**Hard rule — Quick paths**: Apply the entry-time `SKILL_DIR` anchor to every+linked or abbreviated package path below. Expand it inside each tool call;+never change CWD or inherit a prior shell working directory.+---## 1. Profile Boundary@@ -248,15 +252,15 @@ Before resolving the one-pass design, read this fixed planning-capability batchin one pass:```-Read references/canvas-formats.md-Read references/image-layout-spec.md-Read references/image-layout-patterns.md-Read references/modes/_index.md-Read references/visual-styles/_index.md-Read references/image-renderings/_index.md-Read templates/icons/README.md-Read templates/charts/chart-vocabulary.md-Read templates/tables/table-vocabulary.md+Read ${SKILL_DIR}/references/canvas-formats.md+Read ${SKILL_DIR}/references/image-layout-spec.md+Read ${SKILL_DIR}/references/image-layout-patterns.md+Read ${SKILL_DIR}/references/modes/_index.md+Read ${SKILL_DIR}/references/visual-styles/_index.md+Read ${SKILL_DIR}/references/image-renderings/_index.md+Read ${SKILL_DIR}/templates/icons/README.md+Read ${SKILL_DIR}/templates/charts/chart-vocabulary.md+Read ${SKILL_DIR}/templates/tables/table-vocabulary.md```This batch is the complete capability map for planning, not a usage checklist: