@nguyenphp/antigravity-marketing 1.0.18 → 1.0.19

package/templates/.agent/skills/minimax-multimodal-toolkit/SKILL.md

@@ -0,0 +1,359 @@
+---
+name: mmx-cli
+description: Use mmx to generate text, images, video, speech, and music via the MiniMax AI platform. Use when the user wants to create media content, chat with MiniMax models, perform web search, or manage MiniMax API resources from the terminal.
+---
+
+# MiniMax CLI — Agent Skill Guide
+
+Use `mmx` to generate text, images, video, speech, music, and perform web search via the MiniMax AI platform.
+
+## Prerequisites
+
+```bash
+# Install
+npm install -g mmx-cli
+
+# Auth (persisted to ~/.mmx/credentials.json)
+mmx auth login --api-key sk-xxxxx
+
+# Or pass per-call
+mmx text chat --api-key sk-xxxxx --message "Hello"
+```
+
+Region is auto-detected. Override with `--region global` or `--region cn`.
+
+---
+
+## Agent Flags
+
+Always use these flags in non-interactive (agent/CI) contexts:
+
+| Flag | Purpose |
+|---|---|
+| `--non-interactive` | Fail fast on missing args instead of prompting |
+| `--quiet` | Suppress spinners/progress; stdout is pure data |
+| `--output json` | Machine-readable JSON output |
+| `--async` | Return task ID immediately (video generation) |
+| `--dry-run` | Preview the API request without executing |
+| `--yes` | Skip confirmation prompts |
+
+---
+
+## Commands
+
+### text chat
+
+Chat completion. Default model: `MiniMax-M2.7`.
+
+```bash
+mmx text chat --message <text> [flags]
+```
+
+| Flag | Type | Description |
+|---|---|---|
+| `--message <text>` | string, **required**, repeatable | Message text. Prefix with `role:` to set role (e.g. `"system:You are helpful"`, `"user:Hello"`) |
+| `--messages-file <path>` | string | JSON file with messages array. Use `-` for stdin |
+| `--system <text>` | string | System prompt |
+| `--model <model>` | string | Model ID (default: `MiniMax-M2.7`) |
+| `--max-tokens <n>` | number | Max tokens (default: 4096) |
+| `--temperature <n>` | number | Sampling temperature (0.0, 1.0] |
+| `--top-p <n>` | number | Nucleus sampling threshold |
+| `--stream` | boolean | Stream tokens (default: on in TTY) |
+| `--tool <json-or-path>` | string, repeatable | Tool definition JSON or file path |
+
+```bash
+# Single message
+mmx text chat --message "user:What is MiniMax?" --output json --quiet
+
+# Multi-turn
+mmx text chat \
+  --system "You are a coding assistant." \
+  --message "user:Write fizzbuzz in Python" \
+  --output json
+
+# From file
+cat conversation.json | mmx text chat --messages-file - --output json
+```
+
+**stdout**: response text (text mode) or full response object (json mode).
+
+---
+
+### image generate
+
+Generate images. Model: `image-01`.
+
+```bash
+mmx image generate --prompt <text> [flags]
+```
+
+| Flag | Type | Description |
+|---|---|---|
+| `--prompt <text>` | string, **required** | Image description |
+| `--aspect-ratio <ratio>` | string | e.g. `16:9`, `1:1` |
+| `--n <count>` | number | Number of images (default: 1) |
+| `--subject-ref <params>` | string | Subject reference: `type=character,image=path-or-url` |
+| `--out-dir <dir>` | string | Download images to directory |
+| `--out-prefix <prefix>` | string | Filename prefix (default: `image`) |
+
+```bash
+mmx image generate --prompt "A cat in a spacesuit" --output json --quiet
+# stdout: image URLs (one per line in quiet mode)
+
+mmx image generate --prompt "Logo" --n 3 --out-dir ./gen/ --quiet
+# stdout: saved file paths (one per line)
+```
+
+---
+
+### video generate
+
+Generate video. Default model: `MiniMax-Hailuo-2.3`. This is an async task — by default it polls until completion.
+
+```bash
+mmx video generate --prompt <text> [flags]
+```
+
+| Flag | Type | Description |
+|---|---|---|
+| `--prompt <text>` | string, **required** | Video description |
+| `--model <model>` | string | `MiniMax-Hailuo-2.3` (default) or `MiniMax-Hailuo-2.3-Fast` |
+| `--first-frame <path-or-url>` | string | First frame image |
+| `--callback-url <url>` | string | Webhook URL for completion |
+| `--download <path>` | string | Save video to specific file |
+| `--async` | boolean | Return task ID immediately |
+| `--no-wait` | boolean | Same as `--async` |
+| `--poll-interval <seconds>` | number | Polling interval (default: 5) |
+
+```bash
+# Non-blocking: get task ID
+mmx video generate --prompt "A robot." --async --quiet
+# stdout: {"taskId":"..."}
+
+# Blocking: wait and get file path
+mmx video generate --prompt "Ocean waves." --download ocean.mp4 --quiet
+# stdout: ocean.mp4
+```
+
+### video task get
+
+Query status of a video generation task.
+
+```bash
+mmx video task get --task-id <id> [--output json]
+```
+
+### video download
+
+Download a completed video by task ID.
+
+```bash
+mmx video download --file-id <id> [--out <path>]
+```
+
+---
+
+### speech synthesize
+
+Text-to-speech. Default model: `speech-2.8-hd`. Max 10k chars.
+
+```bash
+mmx speech synthesize --text <text> [flags]
+```
+
+| Flag | Type | Description |
+|---|---|---|
+| `--text <text>` | string | Text to synthesize |
+| `--text-file <path>` | string | Read text from file. Use `-` for stdin |
+| `--model <model>` | string | `speech-2.8-hd` (default), `speech-2.6`, `speech-02` |
+| `--voice <id>` | string | Voice ID (default: `English_expressive_narrator`) |
+| `--speed <n>` | number | Speed multiplier |
+| `--volume <n>` | number | Volume level |
+| `--pitch <n>` | number | Pitch adjustment |
+| `--format <fmt>` | string | Audio format (default: `mp3`) |
+| `--sample-rate <hz>` | number | Sample rate (default: 32000) |
+| `--bitrate <bps>` | number | Bitrate (default: 128000) |
+| `--channels <n>` | number | Audio channels (default: 1) |
+| `--language <code>` | string | Language boost |
+| `--subtitles` | boolean | Include subtitle timing data |
+| `--pronunciation <from/to>` | string, repeatable | Custom pronunciation |
+| `--sound-effect <effect>` | string | Add sound effect |
+| `--out <path>` | string | Save audio to file |
+| `--stream` | boolean | Stream raw audio to stdout |
+
+```bash
+mmx speech synthesize --text "Hello world" --out hello.mp3 --quiet
+# stdout: hello.mp3
+
+echo "Breaking news." | mmx speech synthesize --text-file - --out news.mp3
+```
+
+---
+
+### music generate
+
+Generate music. Model: `music-2.5`. Responds well to rich, structured descriptions.
+
+```bash
+mmx music generate --prompt <text> [--lyrics <text>] [flags]
+```
+
+| Flag | Type | Description |
+|---|---|---|
+| `--prompt <text>` | string | Music style description (can be detailed) |
+| `--lyrics <text>` | string | Song lyrics with structure tags. Use `"\u65e0\u6b4c\u8bcd"` for instrumental. Cannot be used with `--instrumental` |
+| `--lyrics-file <path>` | string | Read lyrics from file. Use `-` for stdin |
+| `--vocals <text>` | string | Vocal style, e.g. `"warm male baritone"`, `"bright female soprano"`, `"duet with harmonies"` |
+| `--genre <text>` | string | Music genre, e.g. folk, pop, jazz |
+| `--mood <text>` | string | Mood or emotion, e.g. warm, melancholic, uplifting |
+| `--instruments <text>` | string | Instruments to feature, e.g. `"acoustic guitar, piano"` |
+| `--tempo <text>` | string | Tempo description, e.g. fast, slow, moderate |
+| `--bpm <number>` | number | Exact tempo in beats per minute |
+| `--key <text>` | string | Musical key, e.g. C major, A minor, G sharp |
+| `--avoid <text>` | string | Elements to avoid in the generated music |
+| `--use-case <text>` | string | Use case context, e.g. `"background music for video"`, `"theme song"` |
+| `--structure <text>` | string | Song structure, e.g. `"verse-chorus-verse-bridge-chorus"` |
+| `--references <text>` | string | Reference tracks or artists, e.g. `"similar to Ed Sheeran"` |
+| `--extra <text>` | string | Additional fine-grained requirements |
+| `--instrumental` | boolean | Generate instrumental music (no vocals). Cannot be used with `--lyrics` or `--lyrics-file` |
+| `--aigc-watermark` | boolean | Embed AI-generated content watermark |
+| `--format <fmt>` | string | Audio format (default: `mp3`) |
+| `--sample-rate <hz>` | number | Sample rate (default: 44100) |
+| `--bitrate <bps>` | number | Bitrate (default: 256000) |
+| `--out <path>` | string | Save audio to file |
+| `--stream` | boolean | Stream raw audio to stdout |
+
+At least one of `--prompt` or `--lyrics` is required.
+
+```bash
+# Simple usage
+mmx music generate --prompt "Upbeat pop" --lyrics "La la la..." --out song.mp3 --quiet
+
+# Detailed prompt with vocal characteristics
+mmx music generate --prompt "Warm morning folk" \
+  --vocals "male and female duet, harmonies in chorus" \
+  --instruments "acoustic guitar, piano" \
+  --bpm 95 \
+  --lyrics-file song.txt \
+  --out duet.mp3
+
+# Instrumental (use --instrumental flag)
+mmx music generate --prompt "Cinematic orchestral, building tension" --instrumental --out bgm.mp3
+```
+
+---
+
+### vision describe
+
+Image understanding via VLM. Provide either `--image` or `--file-id`, not both.
+
+```bash
+mmx vision describe (--image <path-or-url> | --file-id <id>) [flags]
+```
+
+| Flag | Type | Description |
+|---|---|---|
+| `--image <path-or-url>` | string | Local path or URL (auto base64-encoded) |
+| `--file-id <id>` | string | Pre-uploaded file ID (skips base64) |
+| `--prompt <text>` | string | Question about the image (default: `"Describe the image."`) |
+
+```bash
+mmx vision describe --image photo.jpg --prompt "What breed?" --output json
+```
+
+**stdout**: description text (text mode) or full response (json mode).
+
+---
+
+### search query
+
+Web search via MiniMax.
+
+```bash
+mmx search query --q <query>
+```
+
+| Flag | Type | Description |
+|---|---|---|
+| `--q <query>` | string, **required** | Search query |
+
+```bash
+mmx search query --q "MiniMax AI" --output json --quiet
+```
+
+---
+
+### quota show
+
+Display Token Plan usage and remaining quotas.
+
+```bash
+mmx quota show [--output json]
+```
+
+---
+
+## Tool Schema Export
+
+Export all commands as Anthropic/OpenAI-compatible JSON tool schemas:
+
+```bash
+# All tool-worthy commands (excludes auth/config/update)
+mmx config export-schema
+
+# Single command
+mmx config export-schema --command "video generate"
+```
+
+Use this to dynamically register mmx commands as tools in your agent framework.
+
+---
+
+## Exit Codes
+
+| Code | Meaning |
+|---|---|
+| 0 | Success |
+| 1 | General error |
+| 2 | Usage error (bad flags, missing args) |
+| 3 | Authentication error |
+| 4 | Quota exceeded |
+| 5 | Timeout |
+| 10 | Content filter triggered |
+
+---
+
+## Piping Patterns
+
+```bash
+# stdout is always clean data — safe to pipe
+mmx text chat --message "Hi" --output json | jq '.content'
+
+# stderr has progress/spinners — discard if needed
+mmx video generate --prompt "Waves" 2>/dev/null
+
+# Chain: generate image → describe it
+URL=$(mmx image generate --prompt "A sunset" --quiet)
+mmx vision describe --image "$URL" --quiet
+
+# Async video workflow
+TASK=$(mmx video generate --prompt "A robot" --async --quiet | jq -r '.taskId')
+mmx video task get --task-id "$TASK" --output json
+mmx video download --task-id "$TASK" --out robot.mp4
+```
+
+---
+
+## Configuration Precedence
+
+CLI flags → environment variables → `~/.mmx/config.json` → defaults.
+
+```bash
+# Persistent config
+mmx config set --key region --value cn
+mmx config show
+
+# Environment
+export MINIMAX_API_KEY=sk-xxxxx
+export MINIMAX_REGION=cn
+```

package/templates/.agent/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