How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/nphu0811/pmg-skills --skill pmg-storyboardBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
PMG Storyboard Intelligence Engine
pmg-storyboard plans presentation narratives, scene diversity, camera movements, and motion strategies before individual slides are constructed. Integrated via pmg.storyboard.StoryboardEngine and consumed by pmg.motion_director.MotionDirector.
Core Responsibilities & Invariants
- Anti-Repetition & Scene Diversity:
- Rejects monotonous, repetitive two-card layouts across presentations.
- Intentionally selects composition archetypes based on narrative purpose:
cinematic_hero: Grand keynote opening and hero focus.editorial_layout: Clean asymmetrical editorial multi-column structure.radial_infographic: Coordinated orbiting nodes, HUD wheels, and concentric rings.layered_cutaway: Multi-plane technical exploded views and annotations.photo_carousel: Dynamic photo gallery transformations via Morph.continuous_one_shot: Extended intra-slide continuous animation sequence.
- Camera & Pacing Direction:
- Assigns narrative-driven virtual camera intentions (
wide_establishing,push_in_zoom,tracking_pan,macro_detail,pull_out). - Pairs camera intentions with native transition psychology (Morph, Circle Wipe, Split Curtain, Fade).
- Asset & Motion Intent Allocation:
- Outlines visual asset requirements per scene for
pmg-visual-assets. - Flags decomposition candidates for
pmg-image-decomposer. - Provides high-level motion guidance to the AI Motion Director.
- Boundaries:
- Produces structured
StoryboardPlanandStoryboardSceneobjects. - Does not implement OpenXML or compile animations directly.
Python API Usage
from pmg.storyboard import StoryboardEngine
from pmg.motion_director import MotionDirector
# 1. Generate diverse presentation storyboard
engine = StoryboardEngine()
plan = engine.plan_presentation(
topic="Autonomous Space Systems",
num_slides=5,
audience="technical_keynote",
tone="modern_cinematic",
)
# 2. Hand off plan to MotionDirector
director = MotionDirector()
output_pptx = director.compile_plan_to_deck(plan, "output/space_mission.pptx")
# 3. Creative Intelligence & Multi-Concept Evaluation (v2.0.1)
from pmg.creative_director import CreativeDirector
creative = CreativeDirector()
concepts = creative.generate_creative_concepts("Autonomous Space Systems", num_concepts=3)
winner, matrix = creative.evaluate_and_select_concept(concepts)
refined_plan, critiques = creative.critique_and_refine(winner, plan)
