@nguyenphp/antigravity-marketing 1.0.18 → 1.0.19

package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/xl/styles.xml

@@ -0,0 +1,160 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<!--
+  styles.xml — The complete style system for this workbook.
+
+  Style index (cellXfs) lookup table:
+  ┌───────┬─────────────────────────────────┬────────────────┬───────────────────┐
+  │ Index │ Semantic Role                   │ Font Color     │ Number Format     │
+  ├───────┼─────────────────────────────────┼────────────────┼───────────────────┤
+  │   0   │ Default                         │ Theme (black)  │ General           │
+  │   1   │ Input / Assumption              │ Blue 000000FF  │ General           │
+  │   2   │ Formula / Computed result       │ Black 00000000 │ General           │
+  │   3   │ Cross-sheet reference           │ Green 00008000 │ General           │
+  │   4   │ Header (bold)                   │ Black bold     │ General           │
+  │   5   │ Currency input                  │ Blue 000000FF  │ $#,##0 (id=164)   │
+  │   6   │ Currency formula                │ Black          │ $#,##0 (id=164)   │
+  │   7   │ Percentage input                │ Blue 000000FF  │ 0.0% (id=165)     │
+  │   8   │ Percentage formula              │ Black          │ 0.0% (id=165)     │
+  │   9   │ Integer with commas input       │ Blue 000000FF  │ #,##0 (id=167)    │
+  │  10   │ Integer with commas formula     │ Black          │ #,##0 (id=167)    │
+  │  11   │ Year (no comma) — input         │ Blue 000000FF  │ 0 (id=1)          │
+  │  12   │ Key assumption (yellow bg)      │ Blue 000000FF  │ General + yellow  │
+  └───────┴─────────────────────────────────┴────────────────┴───────────────────┘
+
+  To add a new style:
+  1. If needed, add a <numFmt> to <numFmts> with a new numFmtId >= 164 (increment max)
+  2. If needed, add a <font> to <fonts>
+  3. If needed, add a <fill> to <fills>
+  4. Append a new <xf> to <cellXfs>, combining fontId + fillId + numFmtId
+  5. Update the count attributes on <numFmts>, <fonts>, <fills>, <cellXfs>
+  6. The new xf's index = (old cellXfs count) — use this as the s attribute on cells
+
+  CRITICAL RULES:
+  - fills[0] and fills[1] are REQUIRED BY SPEC — never remove them
+  - Do NOT modify existing <xf> entries — only append new ones
+  - AARRGGBB color format: first 2 hex digits = Alpha (00 = opaque)
+-->
+<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">
+
+  <!-- ── Number Formats ─────────────────────────────────────────────────── -->
+  <!-- Built-in IDs 0-163 need NOT be declared here. Custom formats: 164+  -->
+  <numFmts count="4">
+    <!-- 164: Standard currency — positive $1,234 / negative ($1,234) / zero - -->
+    <numFmt numFmtId="164" formatCode="$#,##0;($#,##0);&quot;-&quot;"/>
+    <!-- 165: Percentage with 1 decimal place -->
+    <numFmt numFmtId="165" formatCode="0.0%"/>
+    <!-- 166: Multiplier / ratio (e.g. 8.5x for EV/EBITDA) -->
+    <numFmt numFmtId="166" formatCode="0.0x"/>
+    <!-- 167: Integer with thousands separator, no decimals -->
+    <numFmt numFmtId="167" formatCode="#,##0"/>
+  </numFmts>
+
+  <!-- ── Fonts ──────────────────────────────────────────────────────────── -->
+  <fonts count="5">
+    <!-- 0: Default (theme color, no explicit color) -->
+    <font>
+      <sz val="11"/>
+      <name val="Calibri"/>
+    </font>
+    <!-- 1: Input / Assumption — Blue -->
+    <font>
+      <sz val="11"/>
+      <name val="Calibri"/>
+      <color rgb="000000FF"/>
+    </font>
+    <!-- 2: Formula / Computed result — Black (explicit) -->
+    <font>
+      <sz val="11"/>
+      <name val="Calibri"/>
+      <color rgb="00000000"/>
+    </font>
+    <!-- 3: Cross-sheet reference — Green -->
+    <font>
+      <sz val="11"/>
+      <name val="Calibri"/>
+      <color rgb="00008000"/>
+    </font>
+    <!-- 4: Header — Bold Black -->
+    <font>
+      <b/>
+      <sz val="11"/>
+      <name val="Calibri"/>
+      <color rgb="00000000"/>
+    </font>
+  </fonts>
+
+  <!-- ── Fills ──────────────────────────────────────────────────────────── -->
+  <!-- fills[0] and fills[1] are REQUIRED by OOXML spec — DO NOT REMOVE -->
+  <fills count="3">
+    <fill><patternFill patternType="none"/></fill>
+    <fill><patternFill patternType="gray125"/></fill>
+    <!-- 2: Yellow highlight for key assumptions requiring review -->
+    <fill>
+      <patternFill patternType="solid">
+        <fgColor rgb="00FFFF00"/>
+        <bgColor indexed="64"/>
+      </patternFill>
+    </fill>
+  </fills>
+
+  <!-- ── Borders ────────────────────────────────────────────────────────── -->
+  <borders count="1">
+    <!-- 0: No borders (default) -->
+    <border>
+      <left/>
+      <right/>
+      <top/>
+      <bottom/>
+      <diagonal/>
+    </border>
+  </borders>
+
+  <!-- ── Cell Style Xfs (base styles) ──────────────────────────────────── -->
+  <cellStyleXfs count="1">
+    <xf numFmtId="0" fontId="0" fillId="0" borderId="0"/>
+  </cellStyleXfs>
+
+  <!-- ── Cell Xfs (the actual style slots referenced by <c s="N">) ──────── -->
+  <cellXfs count="13">
+    <!--  0: Default -->
+    <xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>
+    <!--  1: Input / Assumption (blue, general format) -->
+    <xf numFmtId="0" fontId="1" fillId="0" borderId="0" xfId="0" applyFont="1"/>
+    <!--  2: Formula / Computed (black, general format) -->
+    <xf numFmtId="0" fontId="2" fillId="0" borderId="0" xfId="0" applyFont="1"/>
+    <!--  3: Cross-sheet reference (green, general format) -->
+    <xf numFmtId="0" fontId="3" fillId="0" borderId="0" xfId="0" applyFont="1"/>
+    <!--  4: Header (bold black) -->
+    <xf numFmtId="0" fontId="4" fillId="0" borderId="0" xfId="0" applyFont="1"/>
+    <!--  5: Currency input (blue + $#,##0) -->
+    <xf numFmtId="164" fontId="1" fillId="0" borderId="0" xfId="0"
+        applyFont="1" applyNumberFormat="1"/>
+    <!--  6: Currency formula (black + $#,##0) -->
+    <xf numFmtId="164" fontId="2" fillId="0" borderId="0" xfId="0"
+        applyFont="1" applyNumberFormat="1"/>
+    <!--  7: Percentage input (blue + 0.0%) -->
+    <xf numFmtId="165" fontId="1" fillId="0" borderId="0" xfId="0"
+        applyFont="1" applyNumberFormat="1"/>
+    <!--  8: Percentage formula (black + 0.0%) -->
+    <xf numFmtId="165" fontId="2" fillId="0" borderId="0" xfId="0"
+        applyFont="1" applyNumberFormat="1"/>
+    <!--  9: Integer-with-commas input (blue + #,##0) -->
+    <xf numFmtId="167" fontId="1" fillId="0" borderId="0" xfId="0"
+        applyFont="1" applyNumberFormat="1"/>
+    <!-- 10: Integer-with-commas formula (black + #,##0) -->
+    <xf numFmtId="167" fontId="2" fillId="0" borderId="0" xfId="0"
+        applyFont="1" applyNumberFormat="1"/>
+    <!-- 11: Year column input (blue + plain integer "0", no comma) -->
+    <xf numFmtId="1" fontId="1" fillId="0" borderId="0" xfId="0"
+        applyFont="1" applyNumberFormat="1"/>
+    <!-- 12: Key assumption highlight (blue on yellow — needs human review) -->
+    <xf numFmtId="0" fontId="1" fillId="2" borderId="0" xfId="0"
+        applyFont="1" applyFill="1"/>
+  </cellXfs>
+
+  <!-- ── Named Cell Styles ─────────────────────────────────────────────── -->
+  <cellStyles count="1">
+    <cellStyle name="Normal" xfId="0" builtinId="0"/>
+  </cellStyles>
+
+</styleSheet>

package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/xl/workbook.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<!--
+  workbook.xml — Defines the list of sheets.
+
+  To add a new sheet:
+    1. Add a <sheet> element below with a unique sheetId and r:id
+    2. Add a matching <Relationship> in xl/_rels/workbook.xml.rels
+    3. Add an <Override> in [Content_Types].xml
+    4. Create the xl/worksheets/sheetN.xml file
+
+  Sheet name rules:
+    - Max 31 characters
+    - Cannot contain: / \ ? * [ ] :
+    - Ampersand must be escaped as &amp; in XML
+-->
+<workbook
+  xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main"
+  xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">
+  <fileVersion appName="xl" lastEdited="7" lowestEdited="7"/>
+  <workbookPr defaultThemeVersion="166925"/>
+  <bookViews>
+    <workbookView xWindow="0" yWindow="0" windowWidth="20140" windowHeight="10960"/>
+  </bookViews>
+  <sheets>
+    <!-- Add more <sheet> elements here for multi-sheet workbooks -->
+    <sheet name="Sheet1" sheetId="1" r:id="rId1"/>
+  </sheets>
+  <!-- calcId ensures Excel recalculates formulas on open -->
+  <calcPr calcId="191029"/>
+</workbook>

package/templates/.agent/skills/minimax-xlsx/templates/minimal_xlsx/xl/worksheets/sheet1.xml

@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<!--
+  sheet1.xml — Worksheet data.
+
+  Cell anatomy:
+    <c r="A1" t="s" s="4"><v>0</v></c>
+          ↑      ↑   ↑    ↑
+      address  type  style  value (sharedStrings index for t="s")
+
+  Type values (t attribute):
+    s          = shared string (text) — <v> contains index into sharedStrings.xml
+    inlineStr  = inline string — use <is><t>text</t></is> instead of <v>
+    n (or omit)= number — <v> contains the raw number
+    b          = boolean — <v> is 1 (TRUE) or 0 (FALSE)
+    e          = error — <v> contains error string like #REF!
+    (no t)     = formula cell — <f> contains formula (NO leading =), <v> is cache
+
+  Formula cells:
+    <c r="B5" s="2"><f>SUM(B2:B4)</f><v></v></c>
+    Cross-sheet: <c r="C1" s="3"><f>Assumptions!B2</f><v></v></c>
+    With spaces:  <c r="C1" s="3"><f>'Q1 Data'!B2</f><v></v></c>
+
+  Style index (s attribute) — pre-built in styles.xml:
+    0 = default
+    1 = input/assumption (blue font)
+    2 = formula/computed (black font)
+    3 = cross-sheet reference (green font)
+    4 = header bold
+    5 = currency input (blue + $#,##0 format)
+    See styles.xml for the full list and how to add more.
+
+  Row r attribute must be 1-based integer.
+  Column letters: A=1, Z=26, AA=27, AZ=52, BA=53, BZ=78, etc.
+-->
+<worksheet
+  xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main"
+  xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">
+  <sheetViews>
+    <sheetView tabSelected="1" workbookViewId="0">
+      <!-- Freeze top row as header: -->
+      <!-- <pane ySplit="1" topLeftCell="A2" activePane="bottomLeft" state="frozen"/> -->
+    </sheetView>
+  </sheetViews>
+  <sheetFormatPr defaultRowHeight="15" x14ac:dyDescent="0.25"
+    xmlns:x14ac="http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac"/>
+  <!-- Column widths — uncomment and adjust as needed:
+  <cols>
+    <col min="1" max="1" width="24" customWidth="1"/>
+    <col min="2" max="10" width="14" customWidth="1"/>
+  </cols>
+  -->
+  <sheetData>
+    <!-- Replace this placeholder with actual data rows.
+         Example:
+    <row r="1">
+      <c r="A1" t="s" s="4"><v>0</v></c>
+      <c r="B1" t="s" s="4"><v>1</v></c>
+    </row>
+    <row r="2">
+      <c r="A2" t="s" s="1"><v>2</v></c>
+      <c r="B2" s="1"><v>1000</v></c>
+    </row>
+    <row r="3">
+      <c r="A3" t="s" s="2"><v>3</v></c>
+      <c r="B3" s="2"><f>B2*1.1</f><v></v></c>
+    </row>
+    -->
+  </sheetData>
+  <pageMargins left="0.7" right="0.7" top="0.75" bottom="0.75" header="0.3" footer="0.3"/>
+</worksheet>

package/templates/.agent/skills/pptx-generator/SKILL.md

@@ -0,0 +1,249 @@
+---
+name: pptx-generator
+description: "Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML workflows, or extract text with markitdown. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides."
+license: MIT
+metadata:
+  version: "1.0"
+  category: productivity
+  sources:
+    - https://gitbrent.github.io/PptxGenJS/
+    - https://github.com/microsoft/markitdown
+---
+
+# PPTX Generator & Editor
+
+## Overview
+
+This skill handles all PowerPoint tasks: reading/analyzing existing presentations, editing template-based decks via XML manipulation, and creating presentations from scratch using PptxGenJS. It includes a complete design system (color palettes, fonts, style recipes) and detailed guidance for every slide type.
+
+## Quick Reference
+
+| Task | Approach |
+|------|----------|
+| Read/analyze content | `python -m markitdown presentation.pptx` |
+| Edit or create from template | See [Editing Presentations](references/editing.md) |
+| Create from scratch | See [Creating from Scratch](#creating-from-scratch-workflow) below |
+
+| Item | Value |
+|------|-------|
+| **Dimensions** | 10" x 5.625" (LAYOUT_16x9) |
+| **Colors** | 6-char hex without # (e.g., `"FF0000"`) |
+| **English font** | Arial (default), or approved alternatives |
+| **Chinese font** | Microsoft YaHei |
+| **Page badge position** | x: 9.3", y: 5.1" |
+| **Theme keys** | `primary`, `secondary`, `accent`, `light`, `bg` |
+| **Shapes** | RECTANGLE, OVAL, LINE, ROUNDED_RECTANGLE |
+| **Charts** | BAR, LINE, PIE, DOUGHNUT, SCATTER, BUBBLE, RADAR |
+
+## Reference Files
+
+| File | Contents |
+|------|----------|
+| [slide-types.md](references/slide-types.md) | 5 slide page types (Cover, TOC, Section Divider, Content, Summary) + additional layout patterns |
+| [design-system.md](references/design-system.md) | Color palettes, font reference, style recipes (Sharp/Soft/Rounded/Pill), typography & spacing |
+| [editing.md](references/editing.md) | Template-based editing workflow, XML manipulation, formatting rules, common pitfalls |
+| [pitfalls.md](references/pitfalls.md) | QA process, common mistakes, critical PptxGenJS pitfalls |
+| [pptxgenjs.md](references/pptxgenjs.md) | Complete PptxGenJS API reference |
+
+---
+
+## Reading Content
+
+```bash
+# Text extraction
+python -m markitdown presentation.pptx
+```
+
+---
+
+## Creating from Scratch — Workflow
+
+**Use when no template or reference presentation is available.**
+
+### Step 1: Research & Requirements
+
+Search to understand user requirements — topic, audience, purpose, tone, content depth.
+
+### Step 2: Select Color Palette & Fonts
+
+Use the [Color Palette Reference](references/design-system.md#color-palette-reference) to select a palette matching the topic and audience. Use the [Font Reference](references/design-system.md#font-reference) to choose a font pairing.
+
+### Step 3: Select Design Style
+
+Use the [Style Recipes](references/design-system.md#style-recipes) to choose a visual style (Sharp, Soft, Rounded, or Pill) matching the presentation tone.
+
+### Step 4: Plan Slide Outline
+
+Classify **every slide** as exactly one of the [5 page types](references/slide-types.md). Plan the content and layout for each slide. Ensure visual variety — do NOT repeat the same layout across slides.
+
+### Step 5: Generate Slide JS Files
+
+Create one JS file per slide in `slides/` directory. Each file must export a synchronous `createSlide(pres, theme)` function. Follow the [Slide Output Format](#slide-output-format) and the type-specific guidance in [slide-types.md](references/slide-types.md). Generate up to 5 slides concurrently using subagents if available.
+
+**Tell each subagent:**
+1. File naming: `slides/slide-01.js`, `slides/slide-02.js`, etc.
+2. Images go in: `slides/imgs/`
+3. Final PPTX goes in: `slides/output/`
+4. Dimensions: 10" x 5.625" (LAYOUT_16x9)
+5. Fonts: Chinese = Microsoft YaHei, English = Arial (or approved alternative)
+6. Colors: 6-char hex without # (e.g. `"FF0000"`)
+7. Must use the theme object contract (see [Theme Object Contract](#theme-object-contract))
+8. Must follow the [PptxGenJS API reference](references/pptxgenjs.md)
+
+### Step 6: Compile into Final PPTX
+
+Create `slides/compile.js` to combine all slide modules:
+
+```javascript
+// slides/compile.js
+const pptxgen = require('pptxgenjs');
+const pres = new pptxgen();
+pres.layout = 'LAYOUT_16x9';
+
+const theme = {
+  primary: "22223b",    // dark color for backgrounds/text
+  secondary: "4a4e69",  // secondary accent
+  accent: "9a8c98",     // highlight color
+  light: "c9ada7",      // light accent
+  bg: "f2e9e4"          // background color
+};
+
+for (let i = 1; i <= 12; i++) {  // adjust count as needed
+  const num = String(i).padStart(2, '0');
+  const slideModule = require(`./slide-${num}.js`);
+  slideModule.createSlide(pres, theme);
+}
+
+pres.writeFile({ fileName: './output/presentation.pptx' });
+```
+
+Run with: `cd slides && node compile.js`
+
+### Step 7: QA (Required)
+
+See [QA Process](references/pitfalls.md#qa-process).
+
+### Output Structure
+
+```
+slides/
+├── slide-01.js          # Slide modules
+├── slide-02.js
+├── ...
+├── imgs/                # Images used in slides
+└── output/              # Final artifacts
+    └── presentation.pptx
+```
+
+---
+
+## Slide Output Format
+
+Each slide is a **complete, runnable JS file**:
+
+```javascript
+// slide-01.js
+const pptxgen = require("pptxgenjs");
+
+const slideConfig = {
+  type: 'cover',
+  index: 1,
+  title: 'Presentation Title'
+};
+
+// MUST be synchronous (not async)
+function createSlide(pres, theme) {
+  const slide = pres.addSlide();
+  slide.background = { color: theme.bg };
+
+  slide.addText(slideConfig.title, {
+    x: 0.5, y: 2, w: 9, h: 1.2,
+    fontSize: 48, fontFace: "Arial",
+    color: theme.primary, bold: true, align: "center"
+  });
+
+  return slide;
+}
+
+// Standalone preview - use slide-specific filename
+if (require.main === module) {
+  const pres = new pptxgen();
+  pres.layout = 'LAYOUT_16x9';
+  const theme = {
+    primary: "22223b",
+    secondary: "4a4e69",
+    accent: "9a8c98",
+    light: "c9ada7",
+    bg: "f2e9e4"
+  };
+  createSlide(pres, theme);
+  pres.writeFile({ fileName: "slide-01-preview.pptx" });
+}
+
+module.exports = { createSlide, slideConfig };
+```
+
+---
+
+## Theme Object Contract (MANDATORY)
+
+The compile script passes a theme object with these **exact keys**:
+
+| Key | Purpose | Example |
+|-----|---------|---------|
+| `theme.primary` | Darkest color, titles | `"22223b"` |
+| `theme.secondary` | Dark accent, body text | `"4a4e69"` |
+| `theme.accent` | Mid-tone accent | `"9a8c98"` |
+| `theme.light` | Light accent | `"c9ada7"` |
+| `theme.bg` | Background color | `"f2e9e4"` |
+
+**NEVER use other key names** like `background`, `text`, `muted`, `darkest`, `lightest`.
+
+---
+
+## Page Number Badge (REQUIRED)
+
+All slides **except Cover Page** MUST include a page number badge in the bottom-right corner.
+
+- **Position**: x: 9.3", y: 5.1"
+- Show current number only (e.g. `3` or `03`), NOT "3/12"
+- Use palette colors, keep subtle
+
+### Circle Badge (Default)
+
+```javascript
+slide.addShape(pres.shapes.OVAL, {
+  x: 9.3, y: 5.1, w: 0.4, h: 0.4,
+  fill: { color: theme.accent }
+});
+slide.addText("3", {
+  x: 9.3, y: 5.1, w: 0.4, h: 0.4,
+  fontSize: 12, fontFace: "Arial",
+  color: "FFFFFF", bold: true,
+  align: "center", valign: "middle"
+});
+```
+
+### Pill Badge
+
+```javascript
+slide.addShape(pres.shapes.ROUNDED_RECTANGLE, {
+  x: 9.1, y: 5.15, w: 0.6, h: 0.35,
+  fill: { color: theme.accent },
+  rectRadius: 0.15
+});
+slide.addText("03", {
+  x: 9.1, y: 5.15, w: 0.6, h: 0.35,
+  fontSize: 11, fontFace: "Arial",
+  color: "FFFFFF", bold: true,
+  align: "center", valign: "middle"
+});
+```
+
+---
+
+## Dependencies
+
+- `pip install "markitdown[pptx]"` — text extraction
+- `npm install -g pptxgenjs` — creating from scratch
+- `npm install -g react-icons react react-dom sharp` — icons (optional)