moodboard-builder
Skill1 starsChanged 39 days agoMITView on GitHub
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.
In this repository7 other files it gives its agents.
- brand-guidelinesSkill
- brand-namingSkill
- color-palette-builderSkill
- icon-systemSkill
- logo-brief-writerSkill
- typography-systemSkill
- visual-hierarchySkill
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 12 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈12
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 34
If two images say the same thing, keep the stronger one.
- Distinctive: line 35
Remove anything that is merely nice-looking but says nothing specific.
- Distinctive: line 36
No more than 2 images from the same brand or campaign, or the board reads as "copy them".
- Distinctive: line 54
Add 3 to 4 images showing directions to avoid, each with a one-line reason.
- Distinctive: line 90
Do not exceed 16 images. Above that, the board stops being an argument and becomes a survey.
- Distinctive: line 91
Do not source before the emotional target is written - images chosen first get a rationale invented afterwards.
- Distinctive: line 92
Do not mix inspiration and execution without labels.
- Distinctive: line 93
Do not fill a dimension with a weak image just to check the box.
- Distinctive: line 94
Do not present the board without the written statement - the board aligns eyes, the statement aligns decisions made weeks later without the …
- Distinctive: line 100
Every image passes the emotional-target filter and contributes something unique.
- Distinctive: line 101
All five dimensions are readable from the board without narration.
- Distinctive: line 106
When the direction is approved and needs codifying into rules, hand off to brand-guidelines.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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:
- Color and tone - what hues and value ranges dominate.
- Texture and material feel - smooth/rough, digital/analog, flat/tactile.
- Light and shadow - harsh/soft, high-contrast/diffuse.
- Composition and space - dense/airy, centered/dynamic, symmetrical/asymmetrical.
- 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.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

