
multimodal-orchestration
Coordinating text, image, voice, and tool-use modalities in a single interaction.
- Installs
- 289
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/owl-listener/ai-design-skills --skill multimodal-orchestration- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads multimodal-orchestration automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Multimodal Orchestration
AI interactions increasingly span multiple modalities — text, images, voice, code, tools, structured data. Designing how these modalities work together is orchestration. The risk on every team: switching modality because it's available, not because it serves the user.
The point of multimodal isn't to use every modality. It's to use the right one at the right moment, and to handle the seams.
Modality selection
Each modality has strengths:
- Text: precise, editable, referenceable. Best for instructions, explanations, and nuanced content.
- Image: spatial, holistic, immediate. Best for layouts, diagrams, and visual concepts.
- Voice: natural, hands-free, emotional. Best for conversational flow and accessibility.
- Code: executable, precise, verifiable. Best for technical specifications and automation.
- Structured data: tables, forms, JSON. Best for comparison, configuration, and data entry.
- Tool use: actions in external systems. Best for execution, not generation.
The designer decides which modality the AI uses for each part of a response — and which modality the user is invited to use for input.
Cross-modal transitions
When the interaction switches modalities, design the transition:
- Text → image: "Here's what that layout could look like." AI generates a visual from a text description.
- Image → text: User uploads a screenshot; the AI describes or critiques it.
- Text → tool: AI writes a plan, then executes it.
- Voice → text: Spoken conversation captured and summarised as structured notes.
Transitions should feel seamless. The user shouldn't have to manually switch modes.
Modality conflicts
Sometimes modalities compete:
- Text says one thing, the image shows another
- Voice tone contradicts text content
- Structured output doesn't match the conversational frame
Establish a primary modality per interaction context. Other modalities are supporting — they elaborate the primary, never override it.
Decision rules
- Pick the modality the user can act on, not the one the AI can produce. A chart impresses if the user wanted a chart; if they wanted a number, the chart is overhead.
- Always preserve a text trace. Voice and image outputs are inaccessible to screen readers, unsearchable, and lost on session end. Even when text isn't primary, it's the audit log.
- When modalities disagree, primary wins — and flag the conflict. "The diagram shows three steps; the text mentions four — let me reconcile."
- Modality switches need announcement OR trivial reversibility. Either the user knows the mode is changing ("Here's a chart of that"), or they can dismiss the new modality in one tap.
- Don't switch modalities mid-utterance. Voice → image → voice in one turn breaks the user's processing rhythm. Group modality outputs at turn boundaries.
- The input modality belongs to the user. Never force the user out of the modality they chose to start with — the AI can output multimodally, but the user dictates input.
Anti-patterns
- Modality showcase: switching to a flashy modality (chart, voice, generated UI) because the system can, not because the user needs. The user sees the trick, not the help.
- Lossy translation: converting between modalities loses information that mattered. Voice → text drops emphasis and pause; image → text drops spatial relationships. Capture what was lost or keep both.
- Modality lock-in: the AI replies in modality X and the user can only respond in modality X. A voice question demands a voice answer, even when the user is now in a meeting.
- Unannounced switch: modality changes mid-interaction without warning. Breaks accessibility, breaks user expectations, breaks screen-reader users completely.
- Crossed primaries: two modalities both present themselves as authoritative. The user doesn't know which to trust when they disagree.
- Modality theatre: structured output (JSON, table) used for content the user wanted as prose. Looks rigorous; reads worse.
When not to use this
- Single-modality products by design — search bars, code completers, transcription tools. Don't add modalities just because the model supports them.
- Constrained-input contexts (driving, medical-glove use, low-bandwidth) — pick the one modality that works in that context and commit; orchestration overhead is dead weight.
- Early prototypes — get one modality working well before adding seams. Most multimodal failures are unreadiness in the primary modality.
See also
generative-ui— when the supporting modality is generated UI, this skill defines when to switch andgenerative-uidefines what to switch to.conversation-patterns— modality transitions are repair sequences in disguise; design them as such.progressive-disclosure— secondary modalities are often advanced features — disclose deliberately.feedback-loops— track which modality switches the user reverses; that's the loudest implicit-feedback signal you'll get.
Design Artefacts
- Modality maps showing which modality is used at each interaction point
- Cross-modal transition specifications (trigger, content, fallback if modality unavailable)
- Input/output modality matrices per feature
- Fallback definitions when a modality is unavailable (slow connection, screen-reader, accessibility settings)
Worked example — modality matrix for a design-review feature:
| Stage | AI output (primary) | AI output (supporting) | User input | Why |
|---|---|---|---|---|
| Upload feedback | text confirmation | — | image (mockup) | User in image-thinking mode; AI confirms in text for a record. |
| Critique | text (numbered) | annotated image overlay | text | Numbered text is referenceable; the overlay locates each point. |
| Suggest fix | annotated image | text rationale | text or click on point | User picks: visual fix (one tap) or written justification. |
| Iterate | text | image diff | image (revised mockup) | Iteration cycle — text dominates because the user wants comparison, not impression. |
Note the pattern: the AI uses the modality that matches the user's input or the modality that's most actionable, with text as the backbone. Image is supporting most of the time, primary only at the precise moment a visual change is being agreed.
Adapted from work on multimodal interfaces and the principle that modalities should map to the user's representation of the task, not the system's capabilities (Maybury & Wahlster on intelligent multimedia interfaces).
FAQ
What does the multimodal-orchestration skill do?
Coordinating text, image, voice, and tool-use modalities in a single interaction.
How do I install multimodal-orchestration?
Run npx skills add https://github.com/owl-listener/ai-design-skills --skill multimodal-orchestration in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/multimodal-orchestration/ (personal) or .claude/skills/multimodal-orchestration/ (project).
Which AI agents can use multimodal-orchestration?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is multimodal-orchestration safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains multimodal-orchestration?
It is published by owl-listener in owl-listener/ai-design-skills. It has 289 recorded installs.
More from owl-listener/ai-design-skills
system-prompt-structure
owl-listener/ai-design-skills
Anatomy of effective system prompts — role, context, constraints, format.
guardrail-design
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
constraint-specification
owl-listener/ai-design-skills
Defining output format, length, tone, and content boundaries within prompts.
generative-ui
owl-listener/ai-design-skills
Designing interfaces where AI generates UI components dynamically.
conversation-patterns
owl-listener/ai-design-skills
Turn-taking, repair sequences, grounding, and dialogue structure for human-AI interaction.
progressive-disclosure
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image