# Veed Fabric Skill

> Guide for creating AI talking head videos with VEED Fabric MCP tools. Use when the user wants to generate videos with AI avatars, browse characters or voices, or check video generation status and credits.

- Skill: `veedstudio/veed-fabric-skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add veedstudio/veed-fabric-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/veedstudio/veed-fabric-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Apache-2.0
- Author: veedstudio (https://skillmd.com/u/veedstudio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/veedstudio/veed-fabric-skill

---


# VEED Fabric Video Creation

VEED Fabric lets users generate professional talking head videos with AI avatars directly from a conversation. No camera or editing skills required.

## Prerequisites

This skill requires the [VEED Fabric MCP server](https://veedstudio.github.io/veed-fabric-mcp/) to be connected. It provides all the tools referenced below. See platform-specific setup:

- [Claude](https://veedstudio.github.io/veed-fabric-mcp/claude.html)
- [ChatGPT](https://veedstudio.github.io/veed-fabric-mcp/chatgpt.html)
- [Goose](https://veedstudio.github.io/veed-fabric-mcp/goose.html)

## Recommended Workflow

Follow this sequence for the best user experience:

1. **Browse characters** — Call `list_characters` to show the avatar carousel. Let the user pick.
2. **Browse voices** — Call `list_voices` with the appropriate locale. Let the user pick.
3. **Ask for a script** — If the user hasn't already provided one, ask what the avatar should say.
4. **Confirm before generating** — Call `confirm_fabric_video` to show cost estimate and parameters. Wait for user confirmation.
5. **Generate the video** — Call `create_fabric_video` only after confirmation.
6. **Check progress** — Call `get_generation_status` with the returned job ID. Videos typically take 1–2 minutes.

Always let the user make selections interactively rather than choosing defaults for them.

## Tool Usage Guide

### list_characters

- Returns AI avatar characters with thumbnails
- Optional `gender` filter: `"male"` or `"female"`
- Displays an interactive carousel widget — let users browse visually
- When the user says "show me characters", call this tool

### list_voices

- Requires `locale` parameter (e.g., `"en"`, `"fr"`, `"es"`, `"en-GB"`)
- Optional `gender` filter: `"Female"`, `"Male"`, or `"Neutral"`
- Displays a voice selector widget with audio previews
- Infer the locale from the user's script language or ask if unclear
- When the user provides a script in a specific language, filter voices to that language

### confirm_fabric_video

- Always call this before `create_fabric_video`
- Shows a confirmation dialog with: script text, selected character, selected voice, credit cost estimate
- Requires `script`, `voiceId`, and `characterId`
- Optional: `aspectRatio` (`"landscape"`, `"portrait"`, `"square"` — defaults to landscape)
- Optional: `workspaceId` (auto-selected if user has only one workspace)
- Do not skip this step — users should always see the cost before generating

### create_fabric_video

- Generates the actual video — consumes credits
- Same parameters as `confirm_fabric_video`
- Only call after the user has confirmed via `confirm_fabric_video`
- Returns a `jobId` for tracking progress

### get_generation_status

- Poll with the `jobId` from `create_fabric_video`
- Status values: `queued` → `processing` → `completed` or `error`
- When complete, displays an inline video player
- If the user asks "is my video ready?", call this tool

### get_credit_balance

- Shows available vs total AI Playground credits
- Optional `workspaceId` parameter
- Useful when the user asks about credits or before a long video

### list_workspaces

- Lists workspaces the user has access to
- No parameters required
- Only needed when the user has multiple workspaces and wants to choose one

## UI Widgets

VEED Fabric provides rich interactive widgets that display automatically when tools are called:

- **Characters Carousel** — visual browsing of avatars (from `list_characters`)
- **Voice Selection** — voice list with audio previews (from `list_voices`)
- **Video Confirmation** — cost breakdown and confirm button (from `confirm_fabric_video`)
- **Video Result** — progress indicator and video player (from `get_generation_status`)

These widgets give users a much better experience than plain text. Prefer calling the tools that trigger them.

## Common User Requests

| User says | What to do |
|-----------|------------|
| "Make me a video" / "Create a video about..." | Full workflow: characters → voices → confirm → create → status |
| "Show me characters" / "What avatars are available?" | Call `list_characters` |
| "What voices do you have?" | Ask for language preference, then call `list_voices` |
| "How many credits do I have?" | Call `get_credit_balance` |
| "Is my video ready?" / "Check my video" | Call `get_generation_status` with the job ID |
| "Make a video in French/Spanish/etc." | Use the same workflow but filter `list_voices` by the appropriate locale |

## Error Handling

- **Insufficient credits** — If `confirm_fabric_video` shows the user doesn't have enough credits, inform them and suggest a shorter script or checking their plan.
- **Generation fails** — If `get_generation_status` returns `error`, let the user know and offer to retry.
- **No voices for locale** — If `list_voices` returns empty, suggest trying a broader locale (e.g., `"en"` instead of `"en-AU"`).