Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/nphu0811/pmg-skills --skill pmg-choreographyAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
PMG Choreography & Transition Suite (pmg-choreography)
Responsibility and dependencies
High-level direction: what moves, why and when. Own motion selection, narrative coordination, scene transitions and timing. Reuse cinematic_builder presets and invoke the shared Morph/camera/pmg.animations implementations; never implement duplicate XML compilers.
Dependencies: pmg-engine; pmg-morph; pmg-camera-parallax; pmg.animations; cinematic_builder. All generated candidates must pass PMGOrchestrator before delivery; direct save/COM snippets below are lower-level composition examples, not independent production entrypoints.
Motion design in PowerPoint transcends static slide-flipping. By combining Hardware-Accelerated Morph, UI App Shell Unlocks, Viewfinder Reticle Targeting, Radial Blooming Petals, and Focal Transitions, presentations feel like an interactive software application or high-end motion graphics film.
1. Iconic Choreography Patterns (from DataPowerPoint)
Pattern A: The Spotify UI Shell & Radial Morph Unlock (from MAC-LENIN.pptx)
Used in product launches, tech keynotes, music, SaaS dashboards, and modern portfolios:
+-------------------------------------------------------------------------------+
| SLIDE 1: THE BRAND / TOPIC MONOLITH |
| - Giant radial ambient orb in background (Oval: w: 17.9", h: 10.9"). |
| - Hero Brand Emblem / Icon centered (w: 1.67", h: 1.66"). |
| - Text (Title, Subtitle, Badges) staged OFF-SCREEN (x >= 14.5" & x <= -2.5").|
| |
| SLIDE 2: CONVERGENCE & TITLE LOCKUP (Morph 2.0s) |
| - Ambient orb contracts & docks into top-left corner (w: 6.2"). |
| - Secondary accent orb docks into bottom-right corner. |
| - Title & Subtitle credits swoop in laterally from off-screen margin. |
| - Floating pill badges glide into place from opposite edges. |
| |
| SLIDE 3: THE APP SHELL / DASHBOARD UNLOCK (Morph 2.0s) |
| - Morph unlocks the full interactive Application Frame: |
| * Left Sidebar Navigation Bar (w: 3.29", h: 7.50") with macOS 3-dots. |
| * Navigation Rail items with active category highlight. |
| * Top Navigation Header (History controls, Upgrade pill, User avatar). |
| * Main Viewport Stage ready for presentation content. |
| |
| SLIDE 4+: IN-FRAME VIEWPORT STREAM (Morph 1.5s - 2.0s) |
| - The App Shell remains permanently pinned in place. |
| - Content cards smoothly stream, transform, and scroll inside viewport. |
| - Team member cards or project stats expand across the canvas. |
+-------------------------------------------------------------------------------+Pattern B: The Earth & Space Reticle Viewfinder & 4-Quadrant Sequence (from EARTH AND SPACE.pptx Slides 1-21)
Used for space exploration, technology architectures, defense/aerospace, and industrial deep dives:
- Slide 1 (Establishing Shot): Giant celestial globe enters from the bottom edge (
!!Space_Globe), with cosmic particle dust nodes. - Slide 2 (Planetary Pan): Globe shifts to the top-left flank as the camera tracks right; moon/satellite enters orbit; targeting reticle corner brackets (
!!Reticle_TL,!!Reticle_TR,!!Reticle_BL,!!Reticle_BR) wait off-screen (x=17.0", y=12.0"). - Slide 3 (Viewfinder Target Lock): Reticle brackets converge and clamp onto the subject (
center_x=9.5", center_y=3.5"), forming a dynamic targeting square[ ]. Title updates to "TARGET COORDINATES LOCKED". - Slide 4 (Reticle Expansion to 3 Framed Cards): The reticle brackets expand outwards, morphing into 3 distinct framed callout cards (
Landmark,Innovation,Community). - Slide 5 (Centered Focal Transition - "BUT SOMETHING IS MISSING"): Macro zoom into a central mystery card; high-contrast dramatic question triggers narrative pivot.
- Slide 6 (4-Quadrant Rotating Segmented Radar Wheel): A segmented circular radar wheel partitioned into 4 quadrants (
Q1: 0°,Q2: 90°,Q3: 180°,Q4: 270°). As slides advance, the wheel rotates $90^\circ$ per slide, shifting the active highlight from quadrant to quadrant.
Pattern C: University Concentric Rings Blooming into 8-Petal Mục Lục (from PROMPT.pdf)
Used for academic defenses, thesis presentations, environmental research, and corporate annual reports:
- Slide 1 (Cover / Concentric Anchor): Three concentric hairline rings (
r=1.2", 2.2", 3.2") frame the cover topic card with institutional headers and student/advisor credits. - Slide 2 (Radial Bloom into 8 Petals): The concentric rings bloom outwards into 8 distinct radial petals (
!!Petal_0through!!Petal_7) distributed at $45^\circ$ angles around a glowing center node. - Slide 3 (Two-Column Mục Lục / Table of Contents): The 8 petals morph into an elegant two-column 8-row agenda list (Items 1-4 on the left column, Items 5-8 on the right column).
- Slide 4+ (Active Section Deep Dive): The active section card enlarges while non-active items dock into a compact progress tracker rail.
2. Universal Topic Adaptability Directive
[!IMPORTANT] Never force a single rigid layout or topic. PMG choreography patterns are universal structural primitives, not single-topic templates. - Do NOT follow a single row of cards if the content calls for a grid, concentric circles, 4 quadrants, or an app shell. - Theme Flexibility: Every pattern can be rendered in Bright Modern Light (LIGHT_ACADEMIC_CYAN,LIGHT_MODERN_STUDIO,LIGHT_ECO_EMERALD) or Deep Obsidian (SPOTIFY_CYBER,COSMOS_DEEP). - Adapt titles, icons, metrics, and card counts dynamically to the user's domain (Healthcare, Agriculture, FinTech, Academic Research, or Art).
3. The Native Transition Palette
Select transitions strictly based on narrative psychology:
| Transition | Compiler operation | When to Use | Emotional Impact |
|---|---|---|---|
| Morph | apply_transition(..., "morph") | 3D rotations, camera dolly zoom, UI shell unlocks, reticle targeting, radial blooms | Seamless, fluid, 60 FPS continuity |
| Circle Wipe | apply_transition(..., "circle") | Climax spotlight, iris focus, grand ending punch | Focused, memorable resolution |
| Split Curtain | apply_transition(..., "split") | Title reveal, keynote stage opening | Grand theatrical unveiling |
| Fade | apply_transition(..., "fade") | Tone shift, moving from problem to solution | Reflective, soft dissolve |
| Push | apply_transition(..., "push") | Vertical timeline advancement, feed scrolling | Dynamic stream |
4. Thematic Traveling Entity ("Vật Thể Bay Xuyên Slide")
A persistent traveling entity must match the specific topic of the presentation:
| Topic / Domain | Thematic Traveling Entity |
|---|---|
| Space & Astronomy | 3D Rotating Planet, Satellite Probe, Rocket, Lunar Rover |
| Music & Entertainment | Glowing Vinyl Disc, Soundwave Pulse, 3D Floating Earbud |
| Tech & Software / AI | Cyber Core, Neural Data Orb, Glowing Cursor / Pointer |
| Ecology & Environment | Floating Green Leaf, Pure Water Droplet, Sprout, Golden Bee |
| Business & Finance | 3D Growth Arrow, Golden Token, Metric Compass Pin |
| Medical & Science | DNA Helix, Molecular Sphere, Heartbeat Pulse |
| Education & Thesis | Concentric Ring Node, Academic Quill, Ribbon Pin |
Coordinates & Motion Arc
- Entry: Starts off-screen ($X \le -2.0"$ or $X \ge 13.5"$).
- Midpoint Traversal: Glides across center stage ($X: 5.5" - 7.5"$, $Y: 1.5" - 2.5"$) with dynamic tilt (
rot). - Docking / Exit: Hovers adjacent to callout cards or departs gracefully into the margin.
5. Python API Usage
from pmg.cinematic_showcase import (
SpotifyAppShellBuilder,
EarthSpaceMotionBuilder,
UniversityBloomBuilder,
)
# 1. Spotify App Shell UI
builder = SpotifyAppShellBuilder(
topic_title="AI AUDIO WORKBENCH",
topic_subtitle="REAL-TIME NEURAL SYNTHESIS",
author_name="Audio Intelligence Lab",
)
builder.build_deck("output_spotify.pptx", num_slides=4)
# 2. Earth & Space Viewfinder / Targeting Reticle Sequence
earth_builder = EarthSpaceMotionBuilder(
topic_title="DEEP SPACE OBSERVATORY",
topic_subtitle="EXOPLANET ATMOSPHERIC ANALYSIS",
)
earth_builder.build_deck("output_space.pptx", num_slides=6)
# 3. University Concentric Bloom & 8-Petal Mục Lục
bloom_builder = UniversityBloomBuilder(
presentation_title="NGHIÊN CỨU PHÂN LOẠI RÁC THẢI TẠI NGUỒN",
subtitle="ĐỀ TÀI TỐT NGHIỆP THẠC SĨ",
student_name="Nguyễn Văn A",
)
bloom_builder.build_deck("output_university.pptx")Autonomous Motion Director 2.0 & Creative Intelligence (v2.0.1)
In v2.0.1, pmg-choreography integrates with pmg.creative_director.CreativeDirector:
- Composable Motion Grammar: Coordinates multi-phase intra-slide choreography, independent simultaneous paths, orbital assembly, scale pulsing, perspective tilt, and synchronized typography.
- Continuous One-Shot Direction (20–30s Scenes): Long continuous single-slide scenes coordinating starfields, celestial rotations, traveling hero trajectories, and camera-follow simulation (
build_v2_0_oneshot_space_scene). - Multi-Candidate Creative Comparison: Generates 3 distinct concepts from one prompt, scored across 6 quantitative axes (
clarity,originality,visual_hierarchy,cinematic_coherence,rhythm_and_pacing,native_editability). - Bounded Pre-Compilation Critique: Evaluates narrative rhythm, transition variety, and camera progression; applies refinements prior to OpenXML compilation.
- Native Editability & OPC Invariant: All animations compile to native
<p:timing>Animation Pane trees with zero repair warnings under PowerPoint Desktop COM.

