nphu0811/pmg-skills

pmg-storyboard

Storyboard intelligence and narrative presentation planner for PMG.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/nphu0811/pmg-skills --skill pmg-storyboard

Before 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.
Original skill document

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

  1. 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.
  1. 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).
  1. 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.
  1. Boundaries:
  • Produces structured StoryboardPlan and StoryboardScene objects.
  • Does not implement OpenXML or compile animations directly.

Python API Usage

python
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)
from this repository

More skills

All skills