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
feat(vocabularies): add complete chart and preset maps
hugohe3b1112ac564f3
diff --git a/skills/ppt-master/references/preset-shape-vocabulary.md b/skills/ppt-master/references/preset-shape-vocabulary.mdnew file mode 100644index 00000000..43d69d71--- /dev/null+++ b/skills/ppt-master/references/preset-shape-vocabulary.md@@ -0,0 +1,133 @@+# Native Preset Shape Vocabulary++This is Executor's complete authoring-side map of the 187 registered DrawingML+preset names. Read it once before choosing a newly authored page or template+contour. The Office categories and family descriptions expose what exists and+what each contour objectively depicts; the current page's meaning, visual+system, and composition determine whether and how to use it.++**Reference — not a constraint**: the order and families are browse aids, not+rankings, recommendations, whitelists, quotas, or automatic selections. A+primitive, compound construction, necessary freeform, or no drawn carrier may+still be the best result.++**Hard rule — registered identities and behavior boundaries**:++- `flowChart*` names carry conventional flowchart meanings; they are not generic decorative nodes.+- `actionButton*` names provide visual button geometry only; they create no action, hyperlink, or navigation target.+- `bentConnector*` and `curvedConnector*` are connector contours, but newly authored instances have no endpoint attachment.+- `chartX`, `chartStar`, and `chartPlus` are partition symbols, not data charts.+- Literal pictograms and mathematical operators retain the identity named here.++**When to run**: run `preset_shape_svg.py describe <name> --compact` only when+an exact candidate needs objective adjustment, connector, path,+connection-site, or text rectangle facts. Authoring syntax and fragment+contracts remain in+[`native-shape-authoring.md`](./native-shape-authoring.md).++## 1. Lines++Straight, bent, and curved relationship contours.++| Family | Objective identity | Exact preset names |+|---|---|---|+| Straight lines and connectors | Two diagonal orientations plus one straight connector contour. | `line`, `lineInv`, `straightConnector1` |+| Bent connectors | Orthogonal connector contours with one through four bends. | `bentConnector2`, `bentConnector3`, `bentConnector4`, `bentConnector5` |+| Curved connectors | Curved connector contours with increasing segment complexity. | `curvedConnector2`, `curvedConnector3`, `curvedConnector4`, `curvedConnector5` |++## 2. Rectangles++Neutral and corner-inflected rectangular carriers.++| Family | Objective identity | Exact preset names |+|---|---|---|+| Neutral rectangular carriers | Square-corner and uniformly rounded rectangular contours. | `rect`, `roundRect` |+| Corner-inflected rectangles | Rectangles with one-sided, paired, diagonal, rounded, clipped, or mixed corner treatments. | `round1Rect`, `round2SameRect`, `round2DiagRect`, `snipRoundRect`, `snip1Rect`, `snip2SameRect`, `snip2DiagRect` |++## 3. Basic Shapes++Geometric bodies, boundaries, radial contours, and literal symbols.++| Family | Objective identity | Exact preset names |+|---|---|---|+| Triangular bodies | Symmetric and right-triangle contours. | `triangle`, `rtTriangle` |+| Slanted quadrilaterals | Diamond, parallelogram, symmetric trapezoid, and asymmetric trapezoid contours. | `diamond`, `parallelogram`, `trapezoid`, `nonIsoscelesTrapezoid` |+| Regular polygon bodies | Five-, six-, seven-, eight-, ten-, and twelve-sided polygon contours. | `pentagon`, `hexagon`, `heptagon`, `octagon`, `decagon`, `dodecagon` |+| Organic carriers | Oval and teardrop contours. | `ellipse`, `teardrop` |+| Ornamental carriers | Concave-corner plaque and beveled rectangle contours. | `plaque`, `bevel` |+| Radial contours and segments | Wedge, partial circle, thick arc, ring, chord, and open arc contours. | `pieWedge`, `pie`, `blockArc`, `donut`, `chord`, `arc` |+| Frames, corners, and edge pieces | Folded corner, closed/open frames, L-corner, and diagonal stripe contours. | `foldedCorner`, `frame`, `halfFrame`, `corner`, `diagStripe` |+| Brackets | Left, right, and paired square-bracket contours. | `leftBracket`, `rightBracket`, `bracketPair` |+| Braces | Left, right, and paired curly-brace contours. | `leftBrace`, `rightBrace`, `bracePair` |+| Literal pictograms | Named object, weather, emotion, prohibition, and cloud symbols. | `cube`, `can`, `lightningBolt`, `heart`, `sun`, `moon`, `smileyFace`, `noSmoking`, `cloud` |+| Functional pictograms | Six- and nine-tooth gears plus a funnel symbol. | `gear6`, `gear9`, `funnel` |+| Plus symbol | Broad plus/cross body. | `plus` |+| Corner and edge tabs | Four corner or edge tabs that imply a rectangular field. | `cornerTabs`, `squareTabs`, `plaqueTabs` |+| Partition symbols | Rectangles divided into four or six internal regions. | `chartX`, `chartStar`, `chartPlus` |++## 4. Block Arrows++Filled directional bodies for movement, sequence, return, exchange, and route+emphasis.++| Family | Objective identity | Exact preset names |+|---|---|---|+| Arrow-shaped carriers | A pointed pentagonal stage body and a V-notched directional stage. | `homePlate`, `chevron` |+| Cardinal block arrows | Filled arrows pointing right, left, up, or down. | `rightArrow`, `leftArrow`, `upArrow`, `downArrow` |+| Stylized forward arrows | Rightward arrows with tail stripes or an inward tail notch. | `stripedRightArrow`, `notchedRightArrow` |+| Multi-axis arrows | Two-, three-, and four-direction arrow bodies. | `leftRightArrow`, `upDownArrow`, `leftUpArrow`, `leftRightUpArrow`, `quadArrow` |+| Bent and return arrows | Sharp or rounded turns plus an explicit U-turn contour. | `bentUpArrow`, `bentArrow`, `uturnArrow` |+| Circular arrows | One-way, counter-oriented, and two-way circular arrow contours. | `circularArrow`, `leftCircularArrow`, `leftRightCircularArrow` |+| Curved and swoosh arrows | Curved arrows ending on each cardinal side plus a tapered swoosh. | `curvedRightArrow`, `curvedLeftArrow`, `curvedUpArrow`, `curvedDownArrow`, `swooshArrow` |+| Arrow callout bodies | Text-bearing directional callouts in one-, two-, or four-way variants. | `leftArrowCallout`, `rightArrowCallout`, `upArrowCallout`, `downArrowCallout`, `leftRightArrowCallout`, `upDownArrowCallout`, `quadArrowCallout` |++## 5. Equation Shapes++Literal mathematical operators.++| Family | Objective identity | Exact preset names |+|---|---|---|+| Equation operators | Addition, subtraction, multiplication, division, equality, and inequality symbols. | `mathPlus`, `mathMinus`, `mathMultiply`, `mathDivide`, `mathEqual`, `mathNotEqual` |++## 6. Flowchart++Conventional flowchart notation for explicit process diagrams.++| Family | Objective identity | Exact preset names |+|---|---|---|+| Flowchart operations | Process, subprocess, alternate process, preparation, manual operation, and delay symbols. | `flowChartProcess`, `flowChartPredefinedProcess`, `flowChartAlternateProcess`, `flowChartPreparation`, `flowChartManualOperation`, `flowChartDelay` |+| Flowchart decisions and routing | Decision, continuation, junction, collation, sorting, extraction, and merge symbols. | `flowChartDecision`, `flowChartConnector`, `flowChartOffpageConnector`, `flowChartSummingJunction`, `flowChartOr`, `flowChartCollate`, `flowChartSort`, `flowChartExtract`, `flowChartMerge` |+| Flowchart input and output | General, manual, historical punched-media, and display input/output symbols. | `flowChartInputOutput`, `flowChartManualInput`, `flowChartPunchedCard`, `flowChartPunchedTape`, `flowChartDisplay` |+| Flowchart documents | Single-document and multidocument symbols. | `flowChartDocument`, `flowChartMultidocument` |+| Flowchart storage | Internal, offline, online, tape, disk, and drum storage symbols. | `flowChartInternalStorage`, `flowChartOfflineStorage`, `flowChartOnlineStorage`, `flowChartMagneticTape`, `flowChartMagneticDisk`, `flowChartMagneticDrum` |+| Flowchart terminator | Start/end terminal symbol. | `flowChartTerminator` |++## 7. Stars and Banners++Emblems, bursts, banners, scrolls, and wave contours.++| Family | Objective identity | Exact preset names |+|---|---|---|+| Stars | Four- through thirty-two-point star and burst contours. | `star4`, `star5`, `star6`, `star7`, `star8`, `star10`, `star12`, `star16`, `star24`, `star32` |+| Irregular seals and explosions | Two irregular burst contours with different edge density. | `irregularSeal1`, `irregularSeal2` |+| Straight ribbons | Raised, lowered, and outward-tailed straight banner contours. | `ribbon`, `ribbon2`, `leftRightRibbon` |+| Curved ribbons | Upward- and downward-arcing ribbon contours. | `ellipseRibbon`, `ellipseRibbon2` |+| Scrolls | Vertical and horizontal rolled-document contours. | `verticalScroll`, `horizontalScroll` |+| Waves | Single and double undulating bands. | `wave`, `doubleWave` |++## 8. Callouts++Annotation bodies and leaders that point to another object or region.++| Family | Objective identity | Exact preset names |+|---|---|---|+| Leader-line callouts | Unbordered, accent-bar, bordered, and accent-bordered bodies with straight, one-bend, or two-bend leaders. | `callout1`, `callout2`, `callout3`, `accentCallout1`, `accentCallout2`, `accentCallout3`, `borderCallout1`, `borderCallout2`, `borderCallout3`, `accentBorderCallout1`, `accentBorderCallout2`, `accentBorderCallout3` |+| Wedge and thought callouts | Rectangular, rounded, oval, and cloud annotation bodies with wedge or thought tails. | `wedgeRectCallout`, `wedgeRoundRectCallout`, `wedgeEllipseCallout`, `cloudCallout` |++## 9. Action Buttons++Visual navigation-control shapes whose behavior must be assigned separately.++| Family | Objective identity | Exact preset names |+|---|---|---|+| Action-button controls | Blank, home, help, information, directional, boundary, return, document, sound, and movie button faces. | `actionButtonBlank`, `actionButtonHome`, `actionButtonHelp`, `actionButtonInformation`, `actionButtonForwardNext`, `actionButtonBackPrevious`, `actionButtonEnd`, `actionButtonBeginning`, `actionButtonReturn`, `actionButtonDocument`, `actionButtonSound`, `actionButtonMovie` |diff --git a/skills/ppt-master/scripts/docs/prompt_audit.md b/skills/ppt-master/scripts/docs/prompt_audit.mdindex 66ba9125..0ac384b2 100644--- a/skills/ppt-master/scripts/docs/prompt_audit.md+++ b/skills/ppt-master/scripts/docs/prompt_audit.md@@ -24,7 +24,7 @@ Exit code `1` on any deterministic error. An unaccepted exact duplicate or schem| Corpus and hot-file token ceilings | error on budget overflow || Declared load sets (route/stage scenarios) | error on budget overflow, unknown files, selector/registry drift || Load coverage | error when a corpus file is in no load set and has no `coverage.exempt` entry |-| Registry claims (layout patterns, modes, styles, renderings, types, charts) | error on ID/count/index drift |+| Registry claims and declared vocabulary projections | error on ID/count/index/projection drift || Markdown references and declared authority edges | error on broken links or unreferenced edges || Cross-file exact duplicates | warning until adjudicated via `duplicates.accepted` || Cross-file near duplicates | informational candidates in the report; no finding |@@ -38,6 +38,7 @@ The manifest is audit-only (`audit_only: true`, `runtime_consumed: false`); it i- **New corpus file** → when no existing category exemption matches it, the audit fails with `LOAD_COVERAGE_GAP` until you add it to the load sets that read it or exempt it with a one-line reason. Exempt only material that never enters role context (for example, a legacy tombstone, generated maintenance asset, maintainer-only doc, or license notice); represent conditional runtime reads as incremental load sets.- **Intentional exact duplicate** → run `--json`, copy the candidate's `kind`, `fingerprint`, and `paths` into `duplicates.accepted` with a reason. The acceptance identity is all three values, so separate path pairs with identical prose remain independently reviewable. Editing either reported raw block changes its fingerprint; stale acceptance fails with `DUPLICATE_ACCEPTED_STALE`.- **Near duplicate** → inspect `duplicates.near` as heuristic maintenance information. It produces no warning. A maintainer may still record a stable intentional pair in `duplicates.accepted`; `--skip-near-duplicates` deliberately leaves accepted near pairs unchecked because that scan did not run.+- **Registry projection** → declare `projection.source` plus an `entry_pattern` with a named `id` group on the canonical registry entry. The audit requires the projected ids to match the registry exactly and rejects duplicates, missing ids, and extra ids.- **Schema owner** → every configured field must have a field-local definition signal in its declared owner. Split fields into separate owner entries when they belong to different artifacts. Generic `key` / `value` prose elsewhere on a long line is not a grammar signal; explicit assignments, field-local grammar/format language, and forms such as `field ... one of ...` are.- **Intentional schema projection** → run `--json`, then copy the field's `owner_fingerprint` and each reviewed projection's `path` / `fingerprint` into that `schema_grammars[]` entry. Classify every projection as `producer`, `consumer`, `reference`, or `compatibility`, and record a one-line reason:diff --git a/skills/ppt-master/scripts/prompt_audit.py b/skills/ppt-master/scripts/prompt_audit.pyindex 94b53786..a6fcb394 100644--- a/skills/ppt-master/scripts/prompt_audit.py+++ b/skills/ppt-master/scripts/prompt_audit.py@@ -1173,9 +1173,63 @@ def _registry_ids(return set(range(len(value))), source, [], Noneraise AuditError(f"Registry key {key} in {source} is not a collection")+ if kind == "line_collection":+ values = [+ line.strip()+ for line in _read_utf8(root / source).splitlines()+ if line.strip()+ ]+ duplicates = sorted(+ item for item, count in Counter(values).items() if count > 1+ )+ return set(values), source, duplicates, values+raise AuditError(f"Unsupported registry kind: {kind}")+def _registry_projection_ids(+ root: Path,+ registry_name: str,+ config: dict[str, Any],+) -> tuple[set[str], str, list[str]] | None:+ """Extract one declared Markdown projection of canonical registry ids."""+ projection = config.get("projection")+ if projection is None:+ return None+ if not isinstance(projection, dict):+ raise AuditError(+ f"Registry {registry_name} projection must be an object"+ )+ source = projection.get("source")+ if not isinstance(source, str) or not (root / source).is_file():+ raise AuditError(+ f"Registry {registry_name} projection has missing source: {source}"+ )+ pattern = projection.get("entry_pattern")+ if not isinstance(pattern, str):+ raise AuditError(+ f"Registry {registry_name} projection needs entry_pattern"+ )+ try:+ regex = re.compile(pattern, re.MULTILINE)+ except re.error as exc:+ raise AuditError(+ f"Invalid registry projection entry_pattern: {exc}"+ ) from exc+ if "id" not in regex.groupindex:+ raise AuditError(+ f"Registry {registry_name} projection entry_pattern needs an id group"+ )+ matched_ids = [+ match.group("id")+ for match in regex.finditer(_read_utf8(root / source))+ ]+ duplicates = sorted(+ item for item, count in Counter(matched_ids).items() if count > 1+ )+ return set(matched_ids), source, duplicates++def _registry_count_claims(paragraph: Paragraph, nouns: list[str]) -> list[int]:noun_pattern = "|".join(re.escape(noun) for noun in nouns)patterns = (@@ -1218,6 +1272,38 @@ def audit_registries(path=source,))+ projection = _registry_projection_ids(root, name, config)+ projection_source: str | None = None+ projection_ids: set[str] | None = None+ projection_duplicates: list[str] = []+ if projection is not None:+ projection_ids, projection_source, projection_duplicates = projection+ for duplicate_id in projection_duplicates:+ findings.append(+ Finding(+ severity="error",+ code="REGISTRY_PROJECTION_ID_DUPLICATE",+ message=(+ f"{name} projection repeats id {duplicate_id!r}"+ ),+ path=projection_source,+ )+ )+ canonical_ids = {str(item) for item in ids}+ missing_ids = sorted(canonical_ids - projection_ids)+ extra_ids = sorted(projection_ids - canonical_ids)+ if missing_ids or extra_ids:+ findings.append(+ Finding(+ severity="error",+ code="REGISTRY_PROJECTION_MISMATCH",+ message=(+ f"{name} projection differs from its registry; "+ f"missing={missing_ids}, extra={extra_ids}"+ ),+ path=projection_source,+ )+ )expected_order: list[str] | None = Noneexpected_ids: set[str] | None = Noneif config.get("kind") == "structured_markdown":@@ -1446,6 +1532,15 @@ def audit_registries("expected_entries": len(expected_ids) if expected_ids is not None else None,"index_labels": index_labels,"index_targets": index_targets,+ "projection": (+ {+ "source": projection_source,+ "entries": len(projection_ids),+ "duplicate_ids": projection_duplicates,+ }+ if projection_ids is not None+ else None+ ),"claims": sorted(claims, key=lambda item: (item["path"], item["line"])),})diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex ce6978d2..ceab9604 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -32,11 +32,13 @@"skills/ppt-master/references/svg-effects.md": 15000,"skills/ppt-master/references/native-data-interface.md": 6750,"skills/ppt-master/references/pptx-structure-interface.md": 4750,+ "skills/ppt-master/references/preset-shape-vocabulary.md": 2750,"skills/ppt-master/references/strategist.md": 18000,"skills/ppt-master/references/strategist-image.md": 3250,"skills/ppt-master/references/strategist-template.md": 3000,"skills/ppt-master/templates/design_spec_reference.md": 3750,"skills/ppt-master/templates/spec_lock_reference.md": 2750,+ "skills/ppt-master/templates/charts/chart-vocabulary.md": 1250,"skills/ppt-master/workflows/generate-pptx.md": 18000,"skills/ppt-master/workflows/stages/apply-template-workspace.md": 3500},@@ -154,7 +156,7 @@"max_tokens": 14000},"route.generate.planning": {- "description": "Generate-PPTX planning through Strategist, including the fixed capability-decision batch, complete compact Chart/Table registries, and a conservative audit envelope for only the exact custom bases selected afterward; schemas and optional scaffolds are tool-consumed. Ceiling raised after BUDGET_LOAD_SET reported 116384 tokens.",+ "description": "Generate-PPTX planning through Strategist, including the fixed capability-decision batch, complete Chart expression vocabulary and Table registry, and a conservative audit envelope for only the exact custom bases selected afterward; schemas and optional scaffolds are tool-consumed. Ceiling raised after BUDGET_LOAD_SET reported 116384 tokens.","scope": "cumulative","include": ["bootstrap.routing"@@ -174,7 +176,7 @@"skills/ppt-master/references/image-renderings/_index.md","skills/ppt-master/scripts/docs/confirm_ui.md","skills/ppt-master/templates/icons/README.md",- "skills/ppt-master/templates/charts/charts_index.json",+ "skills/ppt-master/templates/charts/chart-vocabulary.md","skills/ppt-master/templates/tables/tables_index.json",{"glob": "skills/ppt-master/references/modes/*.md",@@ -218,6 +220,7 @@"skills/ppt-master/references/shared-standards-core.md","skills/ppt-master/references/svg-effects.md","skills/ppt-master/references/native-shape-authoring.md",+ "skills/ppt-master/references/preset-shape-vocabulary.md","skills/ppt-master/references/semantic-svg.md","skills/ppt-master/references/executor-structure.md","skills/ppt-master/references/canvas-formats.md",@@ -227,7 +230,7 @@"skills/ppt-master/references/visual-styles/_index.md","skills/ppt-master/references/image-renderings/_index.md","skills/ppt-master/templates/icons/README.md",- "skills/ppt-master/templates/charts/charts_index.json",+ "skills/ppt-master/templates/charts/chart-vocabulary.md","skills/ppt-master/templates/tables/tables_index.json",{"glob": "skills/ppt-master/references/modes/*.md",@@ -444,7 +447,7 @@"max_tokens": 7500},"stage.generate.template.style": {- "description": "Conditional roster-free Style workspace application.",+ "description": "Conditional roster-free Style workspace application. Ceiling raised after BUDGET_LOAD_SET reported 9019 tokens.","scope": "incremental","include": ["stage.generate.apply-template-workspace"@@ -457,7 +460,7 @@"load_event": "template-application"}],- "max_tokens": 9000+ "max_tokens": 10000},"stage.generate.template.layout": {"description": "Conditional Layout workspace application with one selected Layout spec.",@@ -727,6 +730,7 @@"skills/ppt-master/references/shared-standards-core.md","skills/ppt-master/references/svg-effects.md","skills/ppt-master/references/native-shape-authoring.md",+ "skills/ppt-master/references/preset-shape-vocabulary.md","skills/ppt-master/references/semantic-svg.md","skills/ppt-master/references/executor-structure.md",{@@ -976,12 +980,13 @@"max_tokens": 1000},"stage.create-template.authored-preset": {- "description": "Conditional native preset and Boolean shape authoring reference for Create Layout/Create Deck. Ceiling raised after BUDGET_LOAD_SET reported 6618 tokens.",+ "description": "Conditional complete preset vocabulary plus native preset and Boolean shape authoring authority for Create Layout/Create Deck. Ceiling raised after BUDGET_LOAD_SET reported 9139 tokens.","scope": "incremental","files": [- "skills/ppt-master/references/native-shape-authoring.md"+ "skills/ppt-master/references/native-shape-authoring.md",+ "skills/ppt-master/references/preset-shape-vocabulary.md"],- "max_tokens": 7500+ "max_tokens": 10000},"route.generate.planning-template": {"description": "Generate-PPTX planning context after an explicit template workspace is installed. Ceiling raised after BUDGET_LOAD_SET reported 119170 tokens.",@@ -1090,12 +1095,13 @@"max_tokens": 1000},"stage.generate.executor.native-shape": {- "description": "Stock PowerPoint shape selection and Boolean materialization authority, always included in Generate Executor contexts. Ceiling raised after BUDGET_LOAD_SET reported 6618 tokens.",+ "description": "Complete stock PowerPoint shape vocabulary, selection, and Boolean materialization authority, always included in Generate Executor contexts. Ceiling raised after BUDGET_LOAD_SET reported 9139 tokens.","scope": "incremental","files": [- "skills/ppt-master/references/native-shape-authoring.md"+ "skills/ppt-master/references/native-shape-authoring.md",+ "skills/ppt-master/references/preset-shape-vocabulary.md"],- "max_tokens": 7500+ "max_tokens": 10000},"stage.shared.svg-effects": {"description": "Advanced SVG paint, effects, transforms, and geometry authority, always included in Generate Executor contexts and conditionally loaded by other SVG-authoring routes.",@@ -1617,6 +1623,10 @@"kind": "json_collection","source": "skills/ppt-master/templates/charts/charts_index.json","key": "charts",+ "projection": {+ "source": "skills/ppt-master/templates/charts/chart-vocabulary.md",+ "entry_pattern": "^\\|\\s*`chart/(?P<id>[a-z0-9_]+)`\\s*\\|"+ },"reference_terms": ["charts_index.json","chart catalog",@@ -1633,6 +1643,28 @@"types"]},+ {+ "name": "preset-shape-vocabulary",+ "kind": "line_collection",+ "source": "skills/ppt-master/scripts/pptx_shapes/data/shape_type_values.txt",+ "projection": {+ "source": "skills/ppt-master/references/preset-shape-vocabulary.md",+ "entry_pattern": "(?:\\|\\s|,\\s)`(?P<id>[A-Za-z][A-Za-z0-9]*)`(?=[^\\n]*\\|\\s*$)"+ },+ "reference_terms": [+ "preset-shape-vocabulary.md",+ "preset shape vocabulary",+ "native preset shape vocabulary"+ ],+ "claim_nouns": [+ "preset",+ "presets",+ "shape",+ "shapes",+ "name",+ "names"+ ]+ },{"name": "table-templates","kind": "json_collection",@@ -2069,6 +2101,10 @@"glob": "skills/ppt-master/scripts/docs/image.md","reason": "Standalone image-tool command reference; generation roles load the owning image contracts directly, and its formula renderer section is legacy-only."},+ {+ "glob": "skills/ppt-master/templates/charts/charts_index.json",+ "reason": "Machine registry consumed by visualization validation and optional recall; planning roles load chart-vocabulary.md instead."+ },{"glob": "skills/ppt-master/scripts/docs/mask-gradient-smoke.md","reason": "Maintainer-only executable smoke; never loaded by generation roles."diff --git a/skills/ppt-master/templates/charts/chart-vocabulary.md b/skills/ppt-master/templates/charts/chart-vocabulary.mdnew file mode 100644index 00000000..f7a8a4aa--- /dev/null+++ b/skills/ppt-master/templates/charts/chart-vocabulary.md@@ -0,0 +1,75 @@+# Chart Expression Vocabulary++This is the complete planning-side map of the 33 canonical Chart references.+Choose from the page's actual information relationship, then retain the exact+`chart/<key>` identifier. This file deliberately contains no SVG construction,+data-binding, coordinate, label-placement, styling, or export instructions;+those decisions belong to Executor after selection.++**Reference — not a constraint**: each description states what the visual+encoding represents. It is not a ranking, recommendation, threshold, quota, or+substitute for judgment from the current data and communication goal. Zero+Chart selections remains valid.++## 1. Change over time++| Canonical reference | Encoded relationship |+|---|---|+| `chart/line_chart` | Values positioned along a continuous axis, with connected marks showing change or direction. |+| `chart/area_chart` | A continuous series whose filled area emphasizes magnitude across the axis. |+| `chart/stacked_area_chart` | Multiple filled series whose layers encode both total magnitude and changing composition. |+| `chart/dual_axis_line_chart` | Two continuous series measured on separate value scales. |+| `chart/stock_chart` | Open, high, low, and close values across ordered dates. |+| `chart/waterfall_chart` | Sequential positive and negative contributions connecting a starting value to an ending value. |++## 2. Category comparison and rank++| Canonical reference | Encoded relationship |+|---|---|+| `chart/column_chart` | Category values encoded by vertical length from a shared baseline. |+| `chart/horizontal_bar_chart` | Category values encoded by horizontal length from a shared baseline. |+| `chart/grouped_bar_chart` | Multiple series placed side by side within shared categories. |+| `chart/stacked_bar_chart` | Category totals divided into value-driven component lengths. |+| `chart/butterfly_chart` | Two datasets mirrored around one shared category axis. |+| `chart/dumbbell_chart` | Two values per item joined to expose their gap and direction. |+| `chart/pareto_chart` | Descending category contributions paired with their cumulative share. |++## 3. Target and progress++| Canonical reference | Encoded relationship |+|---|---|+| `chart/bullet_chart` | Actual values, targets, and optional performance bands on compact linear scales. |+| `chart/progress_bar_chart` | Bounded completion values encoded as filled portions of linear tracks. |+| `chart/gauge_chart` | One bounded value positioned against a circular or semicircular domain and reference marks. |++## 4. Distribution and multivariable relationship++| Canonical reference | Encoded relationship |+|---|---|+| `chart/histogram_chart` | Observation frequency encoded across contiguous numeric bins. |+| `chart/box_plot_chart` | Median, quartiles, spread, and outliers summarized for one or more groups. |+| `chart/scatter_chart` | Two numeric variables encoded by x/y position. |+| `chart/bubble_chart` | Two variables encoded by x/y position and a third by mark size. |+| `chart/heatmap_chart` | Values at row-column intersections encoded by color intensity. |+| `chart/radar_chart` | Multiple measures positioned on radial axes for one or more entities. |+| `chart/matrix_2x2` | Items positioned by two numeric dimensions, with optional magnitude encoded by radius. |++## 5. Part-to-whole and hierarchy++| Canonical reference | Encoded relationship |+|---|---|+| `chart/pie_chart` | Flat parts of one whole encoded by sector angle and area. |+| `chart/donut_chart` | Flat parts of one whole encoded around an open center. |+| `chart/pie_of_pie_chart` | One composition with selected parts expanded into a secondary pie. |+| `chart/bar_of_pie_chart` | One composition with selected parts expanded into a secondary stacked bar. |+| `chart/treemap_chart` | Hierarchical or grouped parts encoded as nested rectangular areas. |+| `chart/sunburst_chart` | Hierarchical parts encoded as concentric radial levels and angular spans. |++## 6. Flow, schedule, and weighted text++| Canonical reference | Encoded relationship |+|---|---|+| `chart/funnel_chart` | Ordered stage values encoded as changing widths through a conversion sequence. |+| `chart/sankey_chart` | Magnitude moving between nodes encoded by connection width. |+| `chart/gantt_chart` | Tasks positioned and sized by dates or durations along a time axis. |+| `chart/word_cloud` | Term weight or frequency encoded by type size. |