Skip to content

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.md
index 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 routing
authority.
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 Rules
diff --git a/skills/ppt-master/scripts/attribution_guard.py b/skills/ppt-master/scripts/attribution_guard.py
index 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 execution
gates 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.md
index 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 below
arises.
```
-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, image
source 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 fixed
construction 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.md
index 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 SVG
strategy/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 batch
in 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: