Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

51 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

header

πŸ’Ž Slide ProMax

The Next-Generation Agent-Agnostic Design & Protocol Engine

Agent-Agnostic Skills Compatible TypeScript Playwright Validation


Slide ProMax Engine Architecture

🌟 Overview

Say one sentence to your agent β€” Claude Code, Cursor, Codex, OpenClaw, Hermes all work.

3 to 30 minutes β€” you ship a product launch animation, a clickable App prototype, an editable PPT deck, or a print-grade infographic.

Slide ProMax Output Demo

Not "decent for AI" quality β€” it looks like a real design team made it. Give the skill your brand assets (logo, colors, UI screenshots) and it accurately reads your brand's voice; give it nothing and the built-in 20 design vocabularies still keep you totally out of AI slop territory.


πŸš€ Install

Recommended global install for Codex, Antigravity, Claude Code, Cursor, and the shared Agent Skills location:

npx github:DinhLucent/Slide_ProMax -- --global --agents codex,antigravity,claude-code,cursor,common

Project/workspace install:

npx github:DinhLucent/Slide_ProMax -- --project --agents codex,antigravity,claude-code,cursor,common

Install from a local clone:

npm run install:agents -- --global --agents all

Why not rely only on npx skills add? Some versions install only into .agents/skills, which misses native user/project folders used by several agents. Slide ProMax ships its own installer and writes to both the shared Agent Skills location and platform-native locations.

See references/install-targets.md for the target mapping and source notes.

Default global targets:

Agent Install targets
Shared Agent Skills ~/.agents/skills/slide-promax
Codex ~/.agents/skills/slide-promax + compatibility mirror ~/.codex/skills/slide-promax
Claude Code ~/.claude/skills/slide-promax
Cursor ~/.cursor/skills/slide-promax
Antigravity ~/.gemini/antigravity/skills/slide-promax + compatibility mirror ~/.antigravity/skills/slide-promax

Default project targets:

Agent Install targets
Shared Agent Skills / Codex .agents/skills/slide-promax
Claude Code .claude/skills/slide-promax
Cursor .cursor/skills/slide-promax
Antigravity .agents/skills/slide-promax + legacy .agent/skills/slide-promax + compatibility mirror .antigravity/skills/slide-promax

Useful installer flags:

node scripts/install.mjs --dry-run --global --project --agents all
node scripts/install.mjs --global --agents claude-code,cursor --no-compat
node scripts/install.mjs --project --agents antigravity --force

Then just talk to your agent:

"Make a keynote for AI psychology. Give me 3 style directions to pick from."
"Build an iOS prototype for a Pomodoro app β€” 4 screens, actually clickable."
"Turn this logic into a 60-second animation. Export MP4 and GIF."
"Run a 5-dimension expert review on this design."

No buttons, no panels, no Figma plugins. Agent-agnostic β€” drops into any markdown-skill-capable agent environment.


βš™οΈ What it does

Capability Deliverable Typical time
Interactive prototype (App / Web) Single-file HTML Β· real iPhone bezel Β· clickable Β· Playwright-verified ~10–15 min
Slide decks HTML deck (browser presentation) + editable PPTX (text frames preserved) ~15–25 min
Motion design MP4 (25fps / 60fps interpolation) + GIF (palette-optimized) + BGM ~8–12 min
Design variations 3+ side-by-side comps Β· Tweaks live params Β· cross-dimension exploration ~10 min
Infographic / data viz Print-quality typography Β· exports to vector PDF/PNG/SVG ~10 min
Design direction advisor 5 schools Γ— 20 philosophies Β· 3 directions recommended Β· Demos generated in parallel ~5 min
5-dimension expert critique Radar chart + Keep/Fix/Quick Wins Β· actionable punch list ~3 min

πŸ–ΌοΈ Demo Gallery

Design Direction Advisor

The fallback for vague briefs: pick 3 differentiated directions from 5 schools Γ— 20 philosophies, generate all 3 demos in parallel, let the user choose.

iOS App Prototype

Pixel-accurate iPhone 15 Pro body (Dynamic Island / status bar / Home Indicator) Β· state-driven multi-screen navigation Β· real images pulled from Wikimedia/Met/Unsplash Β· Playwright click tests before delivery.

Motion Design Engine

Stage + Sprite time-slice model Β· useTime / useSprite / interpolate / Easing β€” four APIs cover every animation need Β· one command exports MP4 / GIF / 60fps-interpolated / BGM-scored finals.

HTML Slides β†’ Editable PPTX

HTML decks for browser presentation Β· html2pptx.js reads DOM computed styles and translates each element into real PowerPoint objects Β· exports are actual text frames, not image-bed fakes.

Tweaks Β· Live Variation Switching

Colors / typography / information density parameterized Β· side panel toggle Β· pure-frontend + localStorage persistence Β· survives reload.

Infographic / Data Viz

Magazine-grade typography Β· precise CSS Grid columns Β· text-wrap: pretty typographic details Β· driven by real data Β· exports to vector PDF / 300dpi PNG / SVG.

5-Dimension Expert Critique

Philosophical coherence Β· visual hierarchy Β· execution craft Β· functionality Β· innovation β€” each scored 0–10 Β· radar-chart visualization Β· outputs Keep / Fix / Quick Wins punch list.

Junior Designer Workflow

No heroic one-shot attempts: start with assumptions + placeholders + reasoning, show it to the user early, then iterate. Fixing a misunderstanding early is 100Γ— cheaper than fixing it late.

Core Asset Protocol Β· 5-step hard process

Mandatory whenever the task involves a specific brand: ask β†’ search β†’ download (three fallback paths) β†’ verify + extract β†’ write brand-spec.md covering logo, product shots, UI screenshots, colors, fonts.


🧬 Core Mechanics

Core Asset Protocol

The hardest rule in the skill. When the task touches a specific brand, five steps are strictly enforced:

Step Action Purpose
1 Β· Ask Checklist of 6 asset types: logo, product shots, UI, color palette, fonts. Respect existing resources
2 Β· Search Target official channels: <brand>.com/press Β· brand.<brand>.com Find authoritative assets
3 Β· Download Logo (SVG / HTML tracing) Β· Product shots Β· UI app store extraction Execute three rigorous fallback paths per asset type
4 Β· Verify + Extract Check fidelity & resolution Β· grep hex codes from reality Never guess from memory
5 Β· Spec Lock Write brand-spec.md cementing all paths and CSS variables Un-frozen knowledge evaporates

A/B-tested logic reveals this mechanism reduces AI hallucination variance by 5Γ—.

Design Direction Advisor (Fallback)

Triggered when the brief is too vague to execute:

  • Doesn't run on generic intuition β€” enters a Fallback mode.
  • Recommends 3 differentiated directions from 5 schools Γ— 20 philosophies.
  • Each variation comes with flagship works, gestalt keywords, and aesthetic tones.
  • Generates 3 visual demos side-by-side, waits for user selection before locking main flow.

Junior Designer Workflow

The default working mode across every task:

  • Sends the full question set in one batch, wait for all answers before moving.
  • Embeds assumptions + placeholders + reasoning comments directly into the HTML tree.
  • Demonstrates explicitly to the user early (even if just rendering flat gray blocks).
  • Fills real content β†’ iterates variations β†’ toggles Tweaks sequentially.

Fact Verification First (Principle #0)

When the task mentions a specific product / technology / event (e.g., "DJI Pocket 4"), the first action must be WebSearch to confirm existence, release status, and specifications. No claims are ever generated solely from LLM training-corpus memory. Cost of a search: ~10 seconds. Cost of a wrong assumption: 1–2 hours of rework.

Anti AI-slop Rules

Rigorous avoidance of the visual common denominator of AI output (purple gradients / emoji bullet points / standard rounded corners + left border accents / drawn SVGs / Inter as a display font / CSS silhouettes standing in for real product shots). The engine heavily enforces text-wrap: pretty, CSS Grid logic, carefully chosen serif display faces, and Oklch color matching.


πŸ†š Slide ProMax vs. Browser Design Tools

Traditional browser graphic tools (like Figma or web-based AI design canvases) excel at GUI interaction. However, Slide ProMax is architected aggressively differently. Great hi-fi design doesn't start from a blank page; it grows from existing design context.

Feature Browser-Based AI Tools Slide ProMax
Form Factor Web product (used in browser) Pure Skill (Execution runs in terminal/code editor)
Deliverables Flat Canvas designs / Screenshots Functional HTML / MP4 / GIF / editable PPTX / PDF
Interaction GUI (click, drag, edit) Conversation (tell agent, wait)
Complex Animation Extremely Limited Stage + Sprite timeline Β· Native 60fps export tooling

While GUI tools act as an improved interface, Slide ProMax makes the graphics-tool layer disappear altogether.


⚠️ Limitations

  • No layer-editable PPTX-to-Figma round-trip. The output is native HTML β€” screenshottable, recordable, image-exportable. While PPT formats are exported, you cannot drag the resulting PPT strictly into Keynote/Figma with intact perfect web coordinates.
  • Physics and particle math out of scope. 3D simulations, real-world physics collision, and intensive particle structures exceed the boundaries of this specific design engine.
  • Brand-from-zero logic drops baseline quality. Requesting hi-fi architecture derived completely without existing product references forces the model to invent aesthetics blindly, typically yielding baseline 60–65 point frameworks. Constructing off zero assets is purely a last-resort function.

This is fundamentally a rigid 80-point systems skill, not a generalized 100-point product. For users unbothered by GUI navigation, this system acts decisively to save vast amounts of raw UI alignment time natively from your prompt.


πŸ“ Repository Structure

Slide_ProMax/
β”œβ”€β”€ SKILL.md                 # Main protocol (Agent instruction boundary)
β”œβ”€β”€ README.md                # English README operations (this file)
β”œβ”€β”€ assets/                  # Starter Component Frameworks
β”‚   β”œβ”€β”€ animations.jsx       # Stage + Sprite + Easing logic
β”‚   β”œβ”€β”€ ios_frame.jsx        # iPhone 15 Pro native bezel
β”‚   β”œβ”€β”€ deck_stage.js        # HTML deck compilation engine
β”‚   β”œβ”€β”€ design_canvas.jsx    # Side-by-side variation displays
β”‚   └── showcases/           # 24 prebuilt system bounds 
β”œβ”€β”€ references/              # System memory encyclopedias
β”‚   β”œβ”€β”€ animation-pitfalls.md# Hard animation bounds
β”‚   β”œβ”€β”€ design-styles.md     # 20 design philosophy constraints
β”‚   β”œβ”€β”€ slide-decks.md       # PPTX translation syntax
β”‚   └── ...
β”œβ”€β”€ scripts/                 # Export and compilation toolchain
β”‚   β”œβ”€β”€ render-video.js      # HTML β†’ MP4 processing
β”‚   β”œβ”€β”€ convert-formats.sh   # MP4 β†’ 60fps + GIF processing
β”‚   β”œβ”€β”€ export_deck_pptx.mjs # Local PPT execution bridge
β”‚   └── verify.py            # Local DOM bound verifications
└── demos/                   # Media bounds supporting document layouts

About

SHIELD_DESIGN is a system skill to help build a Presentation

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages