# Moodboard Builder > Assembles a curated moodboard of 8 to 16 images plus a 150-300 word art direction statement that argues for one visual direction. Use when someone asks "build a moodboard", "set the visual direction for this brand", "get the team aligned on look and feel before design starts", or is presenting art direction to a client. Do NOT use for sourcing and licensing individual production images - use visual-asset-curation or stock-photo-finder instead; for codifying an already-approved identity into usage rules, use brand-guidelines. - Skill: `skillmedev/moodboard-builder` (Agent Skill) - Install (CLI): `npx skillmds@latest add skillmedev/moodboard-builder` - Raw SKILL.md: https://api.skillmd.com/api/skills/skillmedev/moodboard-builder/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: SkillMedev (https://skillmd.com/u/skillmedev) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/skillmedev/moodboard-builder --- # Moodboard Builder A moodboard is not a Pinterest dump - it is a curated argument for one specific visual direction, made before pixels are pushed. The costly failure mode is a board of 40 nice-looking images that lets every stakeholder see whatever they want in it, so "alignment" evaporates the moment real design work appears. This procedure produces a tight board and a written statement that survive the client meeting. ## Operating procedure Order matters: the emotional target is the filter every image must pass through, so writing it after sourcing guarantees a board justified backwards. ### Step 1: Gather inputs Collect before sourcing anything. Where the user does not know, use the default and label the guess as a guess. - What the brand does and who the primary customer is (no default - ask). - Project stage: new brand, rebrand, or refresh (changes how far the board may stray from existing equity; default: new brand). - Where the direction will live first: web product, packaging, social, environments (default: web product). - Existing constraints: locked colors, existing logo, category conventions that cannot be broken (default: none). - Audience for the board itself: internal creative team or paying client (a client board needs more annotation; default: client). ### Step 2: Write the emotional target Before sourcing a single image, write two or three sentences on how the brand should make someone feel when they encounter it - not what the brand does, how it feels. Example: "Confident without arrogance. Warm like a trusted expert, not warm like a lifestyle brand. Technical precision expressed through simplicity." Every image is judged against this filter, and only this filter. ### Step 3: Source wide, then cut to 8-16 Gather 30-50 candidates fast, then cut ruthlessly to 8 to 16 images - never more. Each survivor must earn its place by contributing something no other image on the board does: a color mood, a texture, a compositional principle, a lighting style, a typographic reference, a photography approach. Cutting rules: - If two images say the same thing, keep the stronger one. No duplicates of a point. - Remove anything that is merely nice-looking but says nothing specific. - No more than 2 images from the same brand or campaign, or the board reads as "copy them". ### Step 4: Organize by visual dimension Structure the board so a viewer can read each of these five dimensions without explanation. Every dimension needs at least one image carrying it: 1. Color and tone - what hues and value ranges dominate. 2. Texture and material feel - smooth/rough, digital/analog, flat/tactile. 3. Light and shadow - harsh/soft, high-contrast/diffuse. 4. Composition and space - dense/airy, centered/dynamic, symmetrical/asymmetrical. 5. Human presence - if people appear: who they are and how they are portrayed. ### Step 5: Label inspiration vs. execution Tag every image as either directional inspiration (sets mood, will not be literally reproduced) or execution reference (close to what will actually be made). A fashion editorial might set the mood while the actual photography will be product-led; a vintage poster might establish texture while the brand uses a modern grid. Skipping this step causes clients to expect the literal references rather than the principles they embody. ### Step 6: Build the anti-board Add 3 to 4 images showing directions to avoid, each with a one-line reason. "Not this" is often clearer than "this", and it protects against the client instinct to request elements from the rejected category once design begins. ### Step 7: Write the art direction statement Accompany the board with a written statement of 150 to 300 words. It names the references, explains why they were chosen, and translates visual choices into verbal principles a photographer, illustrator, or motion designer can follow without seeing the board. It also gives stakeholders evaluation language: "does this feel more like Reference A or Reference B?" ## Template: art direction statement ``` ART DIRECTION - [FILL: brand name] Emotional target: [FILL: 2-3 sentences on how the brand should feel] Direction in one line: [FILL: e.g. "clinical warmth - lab precision softened by human light"] Color and tone: [FILL: dominant hues, value range, what is deliberately absent] Texture and material: [FILL] Light: [FILL] Composition: [FILL: grid behavior, density, whitespace stance] People: [FILL: who appears, how portrayed - or "no human presence, because ..."] Inspiration references (mood, not literal): [FILL: refs + one line each] Execution references (close to final output): [FILL: refs + one line each] Not this: [FILL: 3-4 rejected directions, one line each on why] Test for future work: "Does this feel more like [FILL: ref A] or [FILL: ref B]? It should always feel like [FILL: A or B]." ``` ## Deliverable Produce a moodboard of 8-16 images organized by the five visual dimensions, each image tagged inspiration or execution, a 3-4 image anti-board with reasons, and a completed 150-300 word art direction statement using the template above. ## Do NOT - Do not exceed 16 images. Above that, the board stops being an argument and becomes a survey; stakeholders each align to a different subset. - Do not source before the emotional target is written - images chosen first get a rationale invented afterwards. - Do not mix inspiration and execution without labels; this is the single most common cause of "this isn't what the moodboard promised" disputes. - Do not fill a dimension with a weak image just to check the box; state "texture is intentionally neutral" instead. - Do not present the board without the written statement - the board aligns eyes, the statement aligns decisions made weeks later without the board open. ## Quality bar Before presenting, verify: - Every image passes the emotional-target filter and contributes something unique. - All five dimensions are readable from the board without narration. - The statement is 150-300 words and usable by a photographer who never sees the board. - The anti-board exists and each rejection has a stated reason. - A stranger shown the board would describe the direction in words close to the emotional target. When the direction is approved and needs codifying into rules, hand off to brand-guidelines; for building the palette in detail, pair with color-palette-builder.