@rosetears/aili-pi 0.1.0

package/skills/minimax-pdf/README.md

@@ -0,0 +1,222 @@
+# minimax-pdf
+
+A Claude skill for creating and editing visually polished PDFs.
+Three routes. One design system. Tokens flow from content analysis through every renderer.
+
+## Quick start
+
+```bash
+bash scripts/make.sh check   # verify deps
+bash scripts/make.sh fix     # auto-install missing deps
+bash scripts/make.sh demo    # → demo.pdf
+```
+
+---
+
+## Route A: CREATE — generate a new PDF
+
+```bash
+bash scripts/make.sh run \
+  --title   "Q3 Strategy Review" \
+  --type    "proposal" \
+  --author  "Strategy Team" \
+  --date    "October 2025" \
+  --content content.json \
+  --out     report.pdf
+```
+
+**`--type` options:**
+
+| Type | Palette | Cover pattern | Google Fonts (cover) |
+|---|---|---|---|
+| `report` | Deep ink, teal accent | `fullbleed` | Playfair Display / IBM Plex Sans |
+| `proposal` | Near-black, amber accent | `split` | Syne / Nunito Sans |
+| `resume` | White, navy accent | `typographic` | DM Serif Display / DM Sans |
+| `portfolio` | Deep violet, coral accent | `atmospheric` | Fraunces / Inter |
+| `academic` | Warm white, navy accent | `typographic` | EB Garamond / Source Sans 3 |
+| `general` | Dark slate, blue accent | `fullbleed` | Outfit / Outfit |
+| `minimal` | Near-white, red accent | `minimal` | Cormorant Garamond / Jost |
+| `stripe` | Dark navy, amber accent | `stripe` | Barlow Condensed / Barlow |
+| `diagonal` | Dark blue, teal accent | `diagonal` | Montserrat / Montserrat |
+| `frame` | Warm cream, brown accent | `frame` | Cormorant / Crimson Pro |
+| `editorial` | White, red accent | `editorial` | Bebas Neue / Libre Franklin |
+| `magazine` | Warm linen, deep navy accent | `magazine` | Playfair Display / EB Garamond |
+| `darkroom` | Deep navy, steel blue accent | `darkroom` | Playfair Display / EB Garamond |
+| `terminal` | Near-black, neon green accent | `terminal` | Space Mono |
+| `poster` | White, near-black accent | `poster` | Barlow Condensed / Courier Prime |
+
+**content.json block types:**
+
+```json
+[
+  {"type": "h1",      "text": "Section Title"},
+  {"type": "h2",      "text": "Subsection"},
+  {"type": "h3",      "text": "Sub-subsection"},
+  {"type": "body",    "text": "Paragraph. Supports <b>bold</b> and <i>italic</i>."},
+  {"type": "bullet",  "text": "Unordered list item"},
+  {"type": "numbered","text": "Ordered list item — counter auto-resets between lists"},
+  {"type": "callout", "text": "Key insight or highlighted finding"},
+  {"type": "table",
+    "headers": ["Col A", "Col B"],
+    "rows":    [["a", "b"], ["c", "d"]]
+  },
+  {"type": "image",   "path": "chart.png", "caption": "Figure 1: optional caption"},
+  {"type": "code",    "text": "def hello():\n    print('world')"},
+  {"type": "math",    "text": "\\int_0^\\infty e^{-x^2} dx = \\frac{\\sqrt{\\pi}}{2}", "label": "(1)"},
+  {"type": "divider"},
+  {"type": "caption", "text": "Table 1: standalone caption label"},
+  {"type": "pagebreak"},
+  {"type": "spacer",  "pt": 16}
+]
+```
+
+---
+
+## Route B: FILL — fill form fields in an existing PDF
+
+```bash
+# See what fields the PDF has
+bash scripts/make.sh fill --input form.pdf --inspect
+
+# Fill fields
+bash scripts/make.sh fill \
+  --input  form.pdf \
+  --out    filled.pdf \
+  --values '{"FirstName": "Jane", "Agree": "true", "Country": "US"}'
+
+# Or from a JSON file
+bash scripts/make.sh fill --input form.pdf --out filled.pdf --data values.json
+```
+
+Field value rules:
+- `text` → any string
+- `checkbox` → `"true"` or `"false"`
+- `dropdown` → must match a choice value shown by `--inspect`
+- `radio` → must match a radio value shown by `--inspect`
+
+---
+
+## Route C: REFORMAT — apply design to an existing document
+
+```bash
+bash scripts/make.sh reformat \
+  --input  source.md \
+  --title  "Annual Report" \
+  --type   "report" \
+  --author "Research Team" \
+  --out    output.pdf
+```
+
+Supported input: `.md` `.txt` `.pdf` `.json`
+
+---
+
+## Architecture
+
+```
+SKILL.md                      ← Claude entry point, route table
+design/design.md              ← Aesthetic system (read before CREATE/REFORMAT)
+scripts/
+  make.sh                     ← Unified CLI
+  palette.py                  ← metadata → tokens.json       [CREATE, REFORMAT]
+  cover.py                    ← tokens.json → cover.html     [CREATE, REFORMAT]
+  render_cover.js             ← cover.html → cover.pdf       [CREATE, REFORMAT]
+  render_body.py              ← tokens + content → body.pdf  [CREATE, REFORMAT]
+  merge.py                    ← cover + body → final.pdf     [CREATE, REFORMAT]
+  fill_inspect.py             ← PDF → field list             [FILL]
+  fill_write.py               ← PDF + values → filled PDF    [FILL]
+  reformat_parse.py           ← doc → content.json           [REFORMAT]
+```
+
+Design tokens (`tokens.json`) flow from `palette.py` to every renderer — cover and body are always visually consistent.
+
+## Dependencies
+
+| Tool | Used by | Install |
+|---|---|---|
+| Python 3.9+ | all `.py` scripts | system |
+| `reportlab` | `render_body.py` | `pip install reportlab` |
+| `pypdf` | fill, merge, reformat | `pip install pypdf` |
+| Node.js 18+ | `render_cover.js` | system |
+| `playwright` + Chromium | `render_cover.js` | `npm install -g playwright && npx playwright install chromium` |
+
+## License
+
+MIT
+
+## Document types
+
+| `--type` | Mood | Cover pattern | Cover fonts |
+|---|---|---|---|
+| `report` | Authoritative | `fullbleed` | Playfair Display / IBM Plex Sans |
+| `proposal` | Confident | `split` | Syne / Nunito Sans |
+| `resume` | Clean | `typographic` | DM Serif Display / DM Sans |
+| `portfolio` | Expressive | `atmospheric` | Fraunces / Inter |
+| `academic` | Scholarly | `typographic` | EB Garamond / Source Sans 3 |
+| `general` | Neutral | `fullbleed` | Outfit |
+| `minimal` | Restrained | `minimal` | Cormorant Garamond / Jost |
+| `stripe` | Bold | `stripe` | Barlow Condensed / Barlow |
+| `diagonal` | Dynamic | `diagonal` | Montserrat |
+| `frame` | Classical | `frame` | Cormorant / Crimson Pro |
+| `editorial` | Editorial | `editorial` | Bebas Neue / Libre Franklin |
+
+Cover fonts load via Google Fonts `@import` at render time — no local caching.
+Body pages always use system fonts (Times / Helvetica) via ReportLab.
+
+## content.json schema
+
+```json
+[
+  {"type": "h1",      "text": "Section Title"},
+  {"type": "h2",      "text": "Subsection"},
+  {"type": "h3",      "text": "Sub-subsection"},
+  {"type": "body",    "text": "Paragraph text. Supports <b>bold</b> and <i>italic</i>."},
+  {"type": "bullet",  "text": "Unordered list item"},
+  {"type": "numbered","text": "Ordered list item — auto-numbered, counter resets between lists"},
+  {"type": "callout", "text": "Highlighted insight or key finding"},
+  {"type": "table",
+    "headers": ["Column A", "Column B", "Column C"],
+    "rows":    [["row1a", "row1b", "row1c"], ["row2a", "row2b", "row2c"]]
+  },
+  {"type": "image",   "path": "chart.png", "caption": "Figure 1: Sales by quarter"},
+  {"type": "code",    "text": "SELECT * FROM users\nWHERE active = 1;"},
+  {"type": "math",    "text": "\\sigma = \\sqrt{\\frac{1}{N}\\sum_{i=1}^N (x_i - \\mu)^2}", "label": "(2)"},
+  {"type": "divider"},
+  {"type": "caption", "text": "Table 2: standalone label"},
+  {"type": "pagebreak"},
+  {"type": "spacer",  "pt": 16}
+]
+```
+
+## Architecture
+
+```
+SKILL.md                  ← Claude entry point, routing only
+design/design.md          ← Aesthetic system (read before any script)
+scripts/
+  make.sh                 ← Unified CLI: check / fix / run / demo
+  palette.py              ← content metadata → tokens.json
+  cover.py                ← tokens.json → cover.html
+  render_cover.js         ← cover.html → cover.pdf  (Playwright)
+  render_body.py          ← tokens.json + content.json → body.pdf  (ReportLab)
+  merge.py                ← cover.pdf + body.pdf → final.pdf + QA report
+```
+
+Design tokens (color, typography, spacing) are written once by `palette.py` and consumed by every downstream script. This guarantees visual consistency between cover and body without any manual coordination.
+
+## Dependencies
+
+| Tool | Purpose | Install |
+|---|---|---|
+| Python 3.9+ | palette, cover, render_body, merge | system |
+| `reportlab` | Body page rendering | `pip install reportlab` |
+| `pypdf` | Merging PDFs | `pip install pypdf` |
+| Node.js 18+ | Cover rendering | system |
+| `playwright` | Headless Chromium for cover | `npm install -g playwright && npx playwright install chromium` |
+
+Run `bash scripts/make.sh check` to verify everything at once.
+Run `bash scripts/make.sh fix` to auto-install what is missing.
+
+## License
+
+MIT

package/skills/minimax-pdf/SKILL.md

@@ -0,0 +1,218 @@
+---
+name: minimax-pdf
+description: >
+  Create, fill, or reformat print-ready PDFs with strong visual page fidelity.
+---
+
+# minimax-pdf
+
+Three tasks. One skill.
+
+## Routing Boundary
+
+Use this skill for PDF output, final non-editable deliverables, PDF form filling, print-ready documents, or tasks where visual page fidelity is the deliverable. Use `minimax-docx` when the user needs editable Word/DOCX output, `minimax-xlsx` for spreadsheets/formulas/workbooks, and `pptx-generator` for slides.
+
+| Trigger | Use this skill? | Why |
+|---|---:|---|
+| "Make a polished client-ready PDF" | Yes | Final PDF/page design |
+| "Fill this PDF form" | Yes | PDF field workflow |
+| "Create an editable Word contract" | No | Route to `minimax-docx` |
+| "Format an Excel workbook" | No | Route to `minimax-xlsx` |
+
+## Read `design/design.md` before any CREATE or REFORMAT work.
+
+---
+
+## Route table
+
+| User intent | Route | Scripts used |
+|---|---|---|
+| Generate a new PDF from scratch | **CREATE** | `palette.py` → `cover.py` → `render_cover.js` → `render_body.py` → `merge.py` |
+| Fill / complete form fields in an existing PDF | **FILL** | `fill_inspect.py` → `fill_write.py` |
+| Reformat / re-style an existing document | **REFORMAT** | `reformat_parse.py` → then full CREATE pipeline |
+
+**Rule:** when in doubt between CREATE and REFORMAT, ask whether the user has an existing document to start from. If yes → REFORMAT. If no → CREATE.
+
+## Route validation gates
+
+1. **Classify the route:** choose CREATE, FILL, or REFORMAT from the table above before running scripts.
+2. **Validate inputs:** confirm source files exist, output path is writable, and route-specific required values are present.
+3. **Run the route pipeline:** use only the scripts for the selected route; do not mix FILL with CREATE/REFORMAT unless the user explicitly asks for both.
+4. **Verify route evidence:** inspect script output and the resulting PDF before claiming success.
+
+🔴 CHECKPOINT / 🛑 STOP: If the task may alter an existing PDF's visual layout, field positions, page count, signatures, or print-readiness, pause and confirm whether fidelity or content transformation is the priority.
+
+## Failure recovery
+
+| Trigger condition | First response | If still failing |
+|---|---|---|
+| Route is ambiguous | Ask whether there is an existing source document or fillable PDF | Stop; do not invent a route |
+| `make.sh check` reports missing tools | Run the documented `make.sh fix` only with explicit user approval and only if allowed in the environment | Report missing dependency and exact failing tool |
+| CREATE output has overflow, clipped text, or broken charts | Adjust content blocks, page breaks, or chart/table sizing and rebuild | Report affected pages/blocks; do not claim print-ready |
+| FILL field name/value is rejected | Re-run `fill_inspect.py` and use exact field names/choices | Ask for corrected values; do not guess field mappings |
+| REFORMAT loses structure or images | Prefer a simpler `content.json` mapping and preserve essential order | Ask whether to prioritize visual match or semantic cleanup |
+
+## Do not do this
+
+- Do not recreate a fillable PDF from scratch when the user asked to fill fields; preserve the original layout.
+- Do not change page size, margins, fonts, form field positions, or signatures during FILL.
+- Do not claim visual fidelity from script success alone; inspect the rendered PDF.
+- Do not use vivid default colors or decorative effects that conflict with the document's audience.
+- Do not overwrite the user's source PDF; always write to a separate output path.
+
+---
+
+## Route A: CREATE
+
+Full pipeline — content → design tokens → cover → body → merged PDF.
+
+```bash
+bash scripts/make.sh run \
+  --title "Q3 Strategy Review" --type proposal \
+  --author "Strategy Team" --date "October 2025" \
+  --accent "#2D5F8A" \
+  --content content.json --out report.pdf
+```
+
+**Doc types:** `report` · `proposal` · `resume` · `portfolio` · `academic` · `general` · `minimal` · `stripe` · `diagonal` · `frame` · `editorial` · `magazine` · `darkroom` · `terminal` · `poster`
+
+| Type | Cover pattern | Visual identity |
+|---|---|---|
+| `report` | `fullbleed` | Dark bg, dot grid, Playfair Display |
+| `proposal` | `split` | Left panel + right geometric, Syne |
+| `resume` | `typographic` | Oversized first-word, DM Serif Display |
+| `portfolio` | `atmospheric` | Near-black, radial glow, Fraunces |
+| `academic` | `typographic` | Light bg, classical serif, EB Garamond |
+| `general` | `fullbleed` | Dark slate, Outfit |
+| `minimal` | `minimal` | White + single 8px accent bar, Cormorant Garamond |
+| `stripe` | `stripe` | 3 bold horizontal color bands, Barlow Condensed |
+| `diagonal` | `diagonal` | SVG angled cut, dark/light halves, Montserrat |
+| `frame` | `frame` | Inset border, corner ornaments, Cormorant |
+| `editorial` | `editorial` | Ghost letter, all-caps title, Bebas Neue |
+| `magazine` | `magazine` | Warm cream bg, centered stack, hero image, Playfair Display |
+| `darkroom` | `darkroom` | Navy bg, centered stack, grayscale image, Playfair Display |
+| `terminal` | `terminal` | Near-black, grid lines, monospace, neon green |
+| `poster` | `poster` | White bg, thick sidebar, oversized title, Barlow Condensed |
+
+Cover extras (inject into tokens via `--abstract`, `--cover-image`):
+- `--abstract "text"` — abstract text block on the cover (magazine/darkroom)
+- `--cover-image "url"` — hero image URL/path (magazine, darkroom, poster)
+
+**Color overrides — always choose these based on document content:**
+- `--accent "#HEX"` — override the accent color; `accent_lt` is auto-derived by lightening toward white
+- `--cover-bg "#HEX"` — override the cover background color
+
+**Accent color selection guidance:**
+
+You have creative authority over the accent color. Pick it from the document's semantic context — title, industry, purpose, audience — not from generic "safe" choices. The accent appears on section rules, callout bars, table headers, and the cover: it carries the document's visual identity.
+
+| Context | Suggested accent range |
+|---|---|
+| Legal / compliance / finance | Deep navy `#1C3A5E`, charcoal `#2E3440`, slate `#3D4C5E` |
+| Healthcare / medical | Teal-green `#2A6B5A`, cool green `#3A7D6A` |
+| Technology / engineering | Steel blue `#2D5F8A`, indigo `#3D4F8A` |
+| Environmental / sustainability | Forest `#2E5E3A`, olive `#4A5E2A` |
+| Creative / arts / culture | Burgundy `#6B2A35`, plum `#5A2A6B`, terracotta `#8A3A2A` |
+| Academic / research | Deep teal `#2A5A6B`, library blue `#2A4A6B` |
+| Corporate / neutral | Slate `#3D4A5A`, graphite `#444C56` |
+| Luxury / premium | Warm black `#1A1208`, deep bronze `#4A3820` |
+
+**Rule:** choose a color that a thoughtful designer would select for this specific document — not the type's default. Muted, desaturated tones work best; avoid vivid primaries. When in doubt, go darker and more neutral.
+
+**content.json block types:**
+
+| Block | Usage | Key fields |
+|---|---|---|
+| `h1` | Section heading + accent rule | `text` |
+| `h2` | Subsection heading | `text` |
+| `h3` | Sub-subsection (bold) | `text` |
+| `body` | Justified paragraph; supports `<b>` `<i>` markup | `text` |
+| `bullet` | Unordered list item (• prefix) | `text` |
+| `numbered` | Ordered list item — counter auto-resets on non-numbered blocks | `text` |
+| `callout` | Highlighted insight box with accent left bar | `text` |
+| `table` | Data table — accent header, alternating row tints | `headers`, `rows`, `col_widths`?, `caption`? |
+| `image` | Embedded image scaled to column width | `path`/`src`, `caption`? |
+| `figure` | Image with auto-numbered "Figure N:" caption | `path`/`src`, `caption`? |
+| `code` | Monospace code block with accent left border | `text`, `language`? |
+| `math` | Display math — LaTeX syntax via matplotlib mathtext | `text`, `label`?, `caption`? |
+| `chart` | Bar / line / pie chart rendered with matplotlib | `chart_type`, `labels`, `datasets`, `title`?, `x_label`?, `y_label`?, `caption`?, `figure`? |
+| `flowchart` | Process diagram with nodes + edges via matplotlib | `nodes`, `edges`, `caption`?, `figure`? |
+| `bibliography` | Numbered reference list with hanging indent | `items` [{id, text}], `title`? |
+| `divider` | Accent-colored full-width rule | — |
+| `caption` | Small muted label | `text` |
+| `pagebreak` | Force a new page | — |
+| `spacer` | Vertical whitespace | `pt` (default 12) |
+
+**chart / flowchart schemas:**
+```json
+{"type":"chart","chart_type":"bar","labels":["Q1","Q2","Q3","Q4"],
+ "datasets":[{"label":"Revenue","values":[120,145,132,178]}],"caption":"Q results"}
+
+{"type":"flowchart",
+ "nodes":[{"id":"s","label":"Start","shape":"oval"},
+          {"id":"p","label":"Process","shape":"rect"},
+          {"id":"d","label":"Valid?","shape":"diamond"},
+          {"id":"e","label":"End","shape":"oval"}],
+ "edges":[{"from":"s","to":"p"},{"from":"p","to":"d"},
+          {"from":"d","to":"e","label":"Yes"},{"from":"d","to":"p","label":"No"}]}
+
+{"type":"bibliography","items":[
+  {"id":"1","text":"Author (Year). Title. Publisher."}]}
+```
+
+---
+
+## Route B: FILL
+
+Fill form fields in an existing PDF without altering layout or design.
+
+```bash
+# Step 1: inspect
+python3 scripts/fill_inspect.py --input form.pdf
+
+# Step 2: fill
+python3 scripts/fill_write.py --input form.pdf --out filled.pdf \
+  --values '{"FirstName": "Jane", "Agree": "true", "Country": "US"}'
+```
+
+| Field type | Value format |
+|---|---|
+| `text` | Any string |
+| `checkbox` | `"true"` or `"false"` |
+| `dropdown` | Must match a choice value from inspect output |
+| `radio` | Must match a radio value (often starts with `/`) |
+
+Always run `fill_inspect.py` first to get exact field names.
+
+---
+
+## Route C: REFORMAT
+
+Parse an existing document → content.json → CREATE pipeline.
+
+```bash
+bash scripts/make.sh reformat \
+  --input source.md --title "My Report" --type report --out output.pdf
+```
+
+**Supported input formats:** `.md` `.txt` `.pdf` `.json`
+
+---
+
+## Environment
+
+```bash
+bash scripts/make.sh check   # verify all deps
+bash scripts/make.sh fix     # auto-install missing deps
+bash scripts/make.sh demo    # build a sample PDF
+```
+
+| Tool | Used by | Install |
+|---|---|---|
+| Python 3.9+ | all `.py` scripts | system |
+| `reportlab` | `render_body.py` | `pip install reportlab` |
+| `pypdf` | fill, merge, reformat | `pip install pypdf` |
+| Node.js 18+ | `render_cover.js` | system |
+| `playwright` + Chromium | `render_cover.js` | `npm install -g playwright && npx playwright install chromium` |
+
+Before claiming the PDF complete, fixed, passing, or verified, follow the canonical lifecycle/ordinary-task verification owner and cite the fresh build/form/visual evidence selected for that claim.