digitalsamba/claude-code-video-toolkit / .claude/skills/video-design
video-design
VerifiedVisual design for videos - colour by act, type scale, chart and layout rules for 16:9 and 9:16 scenes, a design.md handoff that any design skill can fill, and a contact-sheet critique of the render. Use when designing or refining how a video looks (title cards, data scenes, slides, a whole video's palette), when a scene looks generic or busy, when choosing colours for a video, or when /design or /scene-review asks for visual work. Works on its own with a brand, or takes direction from a design source such as taste-skill, Anthropic's frontend-design, or the user's own design skill.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.4 KB |
| critique.md | markdown | 4.4 KB |
| handoff.md | markdown | 3.8 KB |
| idents.md | markdown | 5.4 KB |
| palettes.md | markdown | 3.4 KB |
| sources.md | markdown | 6.7 KB |
sources.md
View on GitHub# Design sources
**Plug in your own design skill, or use ours.** A design source is any skill, guide or person that decides
how something should look: the palette, the type, the idea. The toolkit depends on none of them. Its own
source, **ours**, is `video-design` itself (the act palettes in `palettes.md` with the project's brand), and
any installed design skill can take its place, because everything goes through the handoff (`design.md`).
## Choosing one for a project
1. If `project.json` has `design.source`, use it.
2. Otherwise offer, in this order:
- **ours** (the toolkit's own, nothing to install);
- each source in the registry's `designSources` that is installed in this session, the recommended one
marked. A plugin skill shows up with its plugin's prefix, so match the registry's `skill` with or without
it (`frontend-design` is installed as `example-skills:frontend-design` from Anthropic's plugin);
- "another design skill": the user names one.
Don't offer every skill whose description mentions design or brand. That sweeps in skills that aren't design
sources, such as a brand-guidelines skill that applies another company's colours.
3. Record the choice in `project.json`:
```json
{ "design": { "source": "taste-skill", "file": "design.md" } }
```
`source` is the registry key for a listed source (`ours`, `taste-skill`, `frontend-design`), so every session
saves the same value for the same choice; for an unlisted skill it is the skill's name as invoked (e.g.
`acme:house-style`). `"source": "ours"` means the toolkit's own: `video-design` picks an act palette from
`palettes.md` and fills it with `brands/<name>/`.
Whatever the source, its output goes into `design.md` (`handoff.md`) before anything is built, and the
rules in `SKILL.md` still apply on top. When a source contradicts one (a gradient, a glow, a third
field colour), the video rule wins unless the brand requires it; write the exception under "Rules
turned off".
## Known sources
These are listed in the registry (`_internal/toolkit-registry.json`, `designSources`).
| Source | What it's good for | Install |
| --- | --- | --- |
| **taste-skill** (recommended plug-in) | Dealt directions and palettes from 247 studied sites, measured house rules, a juror's critique with caps. Its colour chapters, one-accent rule and critique translate well to video. MIT. | `/plugin marketplace add Leonxlnx/taste-skill` then `/plugin install taste-skill@taste-skill` ([repo](https://github.com/Leonxlnx/taste-skill)) |
| **frontend-design** (Anthropic) | General visual direction for interfaces: a bold aesthetic stance, type pairing. Written for web pages, so expect to turn down its effects (gradient meshes, glows) for video. | Anthropic's skills repo: [anthropics/skills](https://github.com/anthropics/skills) |
| **Ours** (the toolkit's own, the default) | `video-design`'s act palettes and rules, filled with `brands/<name>/brand.json`. | Nothing to install |
| **Your own** | A team design system, an agency's house style, a skill you wrote. | See below |
"Recommended" means it's the one we currently find gives the best results on video, not that the
toolkit needs it. It changes when something better turns up.
## Bringing your own
Any skill works if it can tell `video-design` five things, which is what `design.md` asks for: the
grounds (one per act, two or three), the ink on each, the one accent, the type family and weights, and
the rules it wants off. It doesn't need to know about Remotion, frames or narration.
To list a design source for other users, open an issue with:
- a link and a one-line description;
- its licence (it must allow use in videos people publish);
- the `design.md` it produced for `examples/data-chart-stars`, and that example's contact sheet
rendered with it (`uv run tools/contact_sheet.py out/data-chart-stars.mp4`), so sources can be
compared on the same video.
Listed sources go in the README's "Design sources" table and the registry. They are not copied into
the toolkit; users install them from their own repos.
## Credit
Parts of `video-design` are adapted from taste-skill (https://github.com/Leonxlnx/taste-skill),
Copyright (c) 2026 Leonxlnx, MIT License: the colour-fields-as-chapters idea, lightness between
neighbouring fields, the one-accent rule, the two-line headline and five-size limits, and the critique's
weighted score and caps. The palettes in `palettes.md` marked "taste" are from its library. The rest is
the toolkit's own, from making these videos.
## How the toolkit splits design
How a video looks is split in two. A **design source** gives the direction (palette, type, an idea): any design
skill the user trusts (plug in your own), or ours. **`video-design`** (`.claude/skills/video-design/`) is the toolkit's
own video layer: it turns that direction into scenes and critiques the render. The project records its source in
`project.json` (`design.source`) and the decisions in `design.md` (format in `video-design/handoff.md`), so a
different source changes the file, not the code. Known sources are in the registry's `designSources`; taste-skill
is the recommended external one today, Anthropic's frontend-design is another, and "ours" (video-design's act
palettes with the brand) is the default that needs nothing installed. Plug in your own design skill, or use ours.
**Turning a scene in place:** `PageTurns` (`lib/components/PageTurns.tsx`) turns one scene into new pages, each on
its narration cue: a hard edge sweeps across with the next page behind it, and nothing fades. Use it when the same
thing is shown again in a new way and the change is the point (one chart in three design sources, a screen before
and after a fix). Between scenes, use `wipe()` from `@remotion/transitions`: a hard-edged cut is the default for an
act change in `video-design`, and the effect transitions below are for when the brand calls for them. Sources are installed by the user and never copied into the toolkit.
**Marks and idents:** judge a logo small before building on it. `uv run tools/mark_sheet.py --svg mark.svg --brand
<name>` draws it at 512 to 16 px, on the brand's grounds, in a circle and as a watermark, and warns about contrast
under 3:1, a part the circle cuts and a part lost at 16 px. An ident is one mark, one move and one sound; the bar
and the method for both are in `.claude/skills/video-design/idents.md`. A 3D ident is a Blender `logo` prop
(optional); the toolkit's own mark is in `brands/video-toolkit/assets/` and its idents in `brands/video-toolkit/ident/`.
## Usage
- **During scene review** (`/scene-review`): choose "Refine"
- **Focused sessions** (`/design`): `/design title`, `/design cta`
- **Whole video:** `uv run tools/contact_sheet.py out/video.mp4` tiles one settled frame per scene for the
critique in `video-design/critique.md`
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |