From 3ba9321c2a3adb251ef9ede64077cb5b52759e8e Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 24 Sep 2026 15:06:32 +0000 Subject: [PATCH] =?UTF-8?q?feat(6.4.0):=20mockup=20dialects=2017=E2=80=932?= =?UTF-8?q?3=20with=20mockup=20craft=20rules,=20more=20promo=20prompts?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01VhzbuY17VENNVTgxod4KW3 --- .claude-plugin/plugin.json | 2 +- CHANGELOG.md | 8 +++ README.en.md | 6 +-- README.md | 6 +-- SKILL.md | 4 +- core.md | 2 +- examples/prompts/skill-promo-styles.txt | 6 +++ references/style-atlas-2026.md | 70 +++++++++++++++++++++++++ 8 files changed, 94 insertions(+), 10 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 9bed445..66c0967 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "meta-ads-designer", "description": "Design and generate posters, flyers, Meta/social ads and promo graphics that look art-directed instead of AI-generated.", - "version": "6.3.0", + "version": "6.4.0", "author": { "name": "AI Evolution Labs", "url": "https://github.com/aievolutionpl" }, "homepage": "https://github.com/aievolutionpl/meta-ads-designer", "license": "MIT", diff --git a/CHANGELOG.md b/CHANGELOG.md index 65b017e..c3c7888 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,14 @@ All notable changes to Meta Ads Designer. Versions follow [SemVer](https://semve --- +## [6.4.0] — 2026-09-24 + +### Added +- **Mockup dialects, styles 17–23** in `style-atlas-2026.md`: floating device stack, laptop/desktop hero, billboard in situ, printed piece, isometric feed grid, before/after phone pair, packaging/merch. They come with **mockup craft rules**: real inner content, one hero object, tilt plus one light plus a contact shadow, readable at thumbnail size, no device logos, headline outside the device. Integrity notes cover billboard visualisations and fair before/after comparisons. +- Three more skill-promo prompts (device stack, before/after, billboard) in `examples/prompts/skill-promo-styles.txt`. + +--- + ## [6.3.0] — 2026-09-24 ### Added diff --git a/README.en.md b/README.en.md index ae8781d..3a92dd2 100644 --- a/README.en.md +++ b/README.en.md @@ -6,7 +6,7 @@ An AI agent skill for choosing **composition, typography, colour and visual dire [Polski](README.md) · [Agent instructions](SKILL.md) · [Quick start](#quick-start) · [Examples](examples/README.md) -![Version](https://img.shields.io/badge/version-6.3.0-222222) +![Version](https://img.shields.io/badge/version-6.4.0-222222) ![License](https://img.shields.io/badge/license-MIT-222222) ![Model independent](https://img.shields.io/badge/prompts-model_independent-222222) @@ -50,7 +50,7 @@ The same concepts can also take a quieter editorial direction: The skill now knows what current Meta ads look like and why some structures persuade: -- **Style atlas 2026** — sixteen visual languages, from oversized type posters and direct-flash editorial to notes-app natives, performance stickers and tactile zines, each with its type, colour, signature device, a prompt fragment and the way it fails. +- **Style atlas 2026** — twenty-three visual languages, from oversized type posters and direct-flash editorial to notes-app natives, performance stickers and tactile zines, each with its type, colour, signature device, a prompt fragment and the way it fails. - **Static formats** — fifteen persuasion skeletons (stat drop, review stack, product + callouts, comparison, offer stack…), each available only when its proof exists. - **2026 platform facts** — Meta's unified Reels/Stories safe zone (14% top, 35% bottom), 4:5 export at 1440×1800, Advantage+ image expansion and generated backgrounds, "AI info" labels, and Andromeda's grouping of near-identical ads. - **Four new rules, R45–R48** — one visual language per ad, format follows proof, diversity is delivery, design for the 2026 placement system. @@ -114,7 +114,7 @@ The whole ad, text included, is generated by the AI model. The skill quotes exac | [Art direction](references/art-direction.md) | Marketing goal to composition and typography | | [Prompt craft](references/prompt-craft.md) | Writing and reviewing prompts | | [Discovery and research](references/discovery-and-research.md) | Research, pre-generation questions, decision note, result analysis | -| [Style atlas 2026](references/style-atlas-2026.md) | Sixteen visual languages, trend slop, reading reference boards | +| [Style atlas 2026](references/style-atlas-2026.md) | Twenty-three visual languages, trend slop, reading reference boards | | [Static ad formats](references/static-ad-formats.md) | Persuasion skeletons, proof, funnel and vertical fit | | [Worked prompts](examples/05-model-independent-directions.md) | Flyer, food and local service | | [2026 style directions](examples/07-2026-style-directions.md) | Format plus style briefs and an Andromeda-ready campaign set | diff --git a/README.md b/README.md index 95e658f..8d2a53b 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Skill dla agentów AI, który pomaga dobierać **kompozycję, typografię, kolor [English](README.en.md) · [Instrukcja skilla](SKILL.md) · [Szybki start](#szybki-start) · [Przykłady](examples/README.md) -![Version](https://img.shields.io/badge/version-6.3.0-222222) +![Version](https://img.shields.io/badge/version-6.4.0-222222) ![License](https://img.shields.io/badge/license-MIT-222222) ![Model independent](https://img.shields.io/badge/prompts-model_independent-222222) @@ -50,7 +50,7 @@ Ten sam zestaw pomysłów można rozwinąć w spokojniejszym kierunku editorial: Skill wie teraz, jak wyglądają aktualne reklamy Meta i dlaczego pewne struktury przekonują: -- **Atlas stylów 2026** — szesnaście języków wizualnych: od plakatu z wielką typografią i edytorialu z fleszem, przez natywne notatki, banery performance ze stickerem, po taktylny zin. Każdy ma typografię, kolor, sygnaturowy detal, fragment promptu i typowy błąd. +- **Atlas stylów 2026** — dwadzieścia trzy języki wizualnych: od plakatu z wielką typografią i edytorialu z fleszem, przez natywne notatki, banery performance ze stickerem, po taktylny zin. Każdy ma typografię, kolor, sygnaturowy detal, fragment promptu i typowy błąd. - **Formaty statyczne** — piętnaście szkieletów perswazji (stat drop, stos recenzji, produkt z calloutami, porównanie, offer stack…). Format jest dostępny tylko wtedy, gdy istnieje jego dowód. - **Fakty platformy 2026** — ujednolicona strefa bezpieczna Reels/Stories (14% góra, 35% dół), eksport 4:5 w 1440×1800, rozszerzanie obrazu i generowane tła w Advantage+, etykiety „AI info” oraz grupowanie niemal identycznych reklam przez Andromedę. - **Cztery nowe reguły, R45–R48** — jeden język wizualny na reklamę, format wynika z dowodu, różnorodność daje zasięg, projekt pod system placementów 2026. @@ -114,7 +114,7 @@ Cała reklama, łącznie z tekstem, powstaje w modelu AI. Skill pisze dokładne | [Art direction](references/art-direction.md) | Od celu marketingowego do kompozycji i typografii | | [Prompt craft](references/prompt-craft.md) | Pisanie i sprawdzanie promptów | | [Research i pytania](references/discovery-and-research.md) | Research, pytania przed generacją, notatka decyzyjna, analiza wyników | -| [Atlas stylów 2026](references/style-atlas-2026.md) | Szesnaście języków wizualnych, trend slop, czytanie plansz referencyjnych | +| [Atlas stylów 2026](references/style-atlas-2026.md) | Dwadzieścia trzy języki wizualnych, trend slop, czytanie plansz referencyjnych | | [Formaty statyczne](references/static-ad-formats.md) | Szkielety perswazji, dowód, lejek i dopasowanie do branży | | [Przykłady promptów](examples/05-model-independent-directions.md) | Flyer, gastronomia i usługa lokalna | | [Kierunki 2026](examples/07-2026-style-directions.md) | Briefy „format + styl” i zestaw kampanii pod Andromedę | diff --git a/SKILL.md b/SKILL.md index 066879c..a0b07a3 100644 --- a/SKILL.md +++ b/SKILL.md @@ -3,7 +3,7 @@ name: meta-ads-designer description: Research, question, art-direct and generate Meta/social ads, posters and flyers with AI image models (API, Codex or built-in tools), using strong prompts and post-generation analysis, when a user requests advertising visuals or less generic AI design. license: MIT metadata: - version: 6.3.0 + version: 6.4.0 author: AI Evolution Labs url: https://github.com/aievolutionpl/meta-ads-designer --- @@ -35,7 +35,7 @@ Read [art direction](references/art-direction.md) before drafting a new directio 1. Connect the message to something visible: “The viewer understands this benefit because they see this.” 2. For a static ad, choose the format, the persuasion skeleton, from the proof you actually have and the audience's stage. Read [static ad formats](references/static-ad-formats.md). No verified number, no stat drop; no real review, no review card. -3. Choose one visual language and commit to its type, colour, image treatment and signature device. For services, agencies, apps and courses, consider the social-service dialects 13–16 (3D clay post mockup, phone-in-hand with giant type, script accent, 3D service promo) and apply their trademark guardrails. Read [style atlas 2026](references/style-atlas-2026.md). Brand identity outranks trend; never mix two dialects in one frame. +3. Choose one visual language and commit to its type, colour, image treatment and signature device. For services, agencies, apps and courses, consider the social-service dialects 13–16 (3D clay post mockup, phone-in-hand with giant type, script accent, 3D service promo) and the mockup dialects 17–23 (device stack, laptop, billboard, print, isometric grid, before/after phones, packaging) and apply their trademark guardrails. Read [style atlas 2026](references/style-atlas-2026.md). Brand identity outranks trend; never mix two dialects in one frame. 4. Define dominant element, reading path, copy field, quiet area, brand anchor and edge treatment. 5. Choose type by role, width, weight, language and brand. Set exact copy and line breaks. Run the sell test (R52) on every string: the headline states a concrete benefit or result for this product, the support line proves it or gives a reason to act, the CTA names the action. No mood lines, no unproven superlatives. 6. Assign colour roles and, for photography, light and material treatment. diff --git a/core.md b/core.md index ae6bf5e..57a008b 100644 --- a/core.md +++ b/core.md @@ -194,7 +194,7 @@ If the user has results, read them before redesigning. Stop at the first broken - Bold statement · stat drop (verified number + source) · review card / review stack (real words only) · product + callouts (3–5, product stays dominant) · comparison / us vs them (fair, checkable) · before/after (real, category permitting) · numbered benefits · founder quote (real person) · offer stack (verified terms) · native interface (notes, chat, post) · problem → solution · checkerboard · in-use. - Cold audiences: bold statement, native interface, problem → solution. Warm: callouts, comparison, reviews. Retargeting: offer stack, review card. -**Then commit to one visual language** (full atlas: `references/style-atlas-2026.md`): oversized type poster · colour-block still life · direct-flash editorial · cinematic close-up with coloured light · quiet minimal · documentary phone-real · native interface · performance sticker banner · tactile zine · reality warp · seasonal world · device-in-hand proof · for services and agencies: 3D clay platform mockup · phone-in-hand + giant ghost type · script accent + frame shape · 3D service promo with benefit chips (official platform logos only, never implied endorsement, never fake tappable UI). Execute its full DNA: type class, colour roles, image treatment, one signature device. Never two dialects in one frame. Brand identity outranks the trend. +**Then commit to one visual language** (full atlas: `references/style-atlas-2026.md`): oversized type poster · colour-block still life · direct-flash editorial · cinematic close-up with coloured light · quiet minimal · documentary phone-real · native interface · performance sticker banner · tactile zine · reality warp · seasonal world · device-in-hand proof · for services and agencies: 3D clay platform mockup · phone-in-hand + giant ghost type · script accent + frame shape · 3D service promo with benefit chips (official platform logos only, never implied endorsement, never fake tappable UI) · mockups: floating device stack · laptop hero · billboard in situ · printed piece · isometric feed grid · before/after phone pair · packaging/merch. Mockup craft: real inner content as a reference, one hero object, slight tilt with one light and a contact shadow, readable at thumbnail size, no device logos, the headline outside the device. Execute its full DNA: type class, colour roles, image treatment, one signature device. Never two dialects in one frame. Brand identity outranks the trend. **Trend slop:** grain sprinkled on a sterile render · three stickers, five arrows · a Behance-style board of tilted ad cards shipped as one ad · plastic skin in a "documentary" ad · an invented app screen · a fake play button or notification badge on a still. diff --git a/examples/prompts/skill-promo-styles.txt b/examples/prompts/skill-promo-styles.txt index 2dd9f40..0a7e617 100644 --- a/examples/prompts/skill-promo-styles.txt +++ b/examples/prompts/skill-promo-styles.txt @@ -5,3 +5,9 @@ Vertical 4:5 ad promoting "META ADS DESIGNER". Style: phone-in-hand with giant t Vertical 4:5 ad promoting "META ADS DESIGNER". Style: script accent with a frame shape. Deep wine-to-black gradient background. A large rounded speech-bubble shape outlined in dark red frames a hand holding a phone (no brand logo) that shows a grid of nine colourful, well-designed ad thumbnails. Lower left, a heavy geometric sans headline in white on two lines, "REKLAMY" / "BEZ AI SLOPU", with the word "prawdziwe" written across it in a flowing red brush script. Small wordmark "AI EVOLUTION LABS" top left. Soft red rim light on the hand. No platform logos, no other text. Every word spelled exactly as quoted, including Polish diacritics. --- Vertical 4:5 service-promo ad for "META ADS DESIGNER" on a deep navy background with a soft blue glow and faint diagonal light streaks. Top row: small wordmark "AI EVOLUTION LABS" left, "aievolutionlabs.io" right. Centred headline: "Reklamy Meta" in white bold sans, then "w 10 minut" in large orange bold sans. Below, a navy pill: "Research · pytania · prompt · analiza". Three rounded outlined chips with orange ticks: "Research konkurencji", "Tekst, który sprzedaje", "Kontrola każdego słowa". Lower half: a smiling young person in casual clothes sits with a laptop on a large glossy blue 3D infinity symbol. Two glossy 3D spheres float left and right, one with a simple white thumbs-up icon and one with a simple white camera icon. Bottom pill: "Open source · za darmo". No platform logos, no other text. Every word spelled exactly as quoted, including Polish diacritics. +--- +Vertical 4:5 ad promoting "META ADS DESIGNER". Style: floating device stack. Three modern smartphones without brand logos float in a staggered diagonal fan on a flat lilac background, each tilted about 15°, soft drop shadows between them. Screens, sharp and legible: left, a documentary bakery ad with the headline "Croissant, który chrupie jeszcze ciepły."; middle, a tangerine ad with a sage-green steel bottle and "NALANA O 8:00."; right, a cobalt typographic poster "NOC BRZMI". Top left, heavy near-black grotesk headline: "Jeden brief." / "Trzy reklamy.". Bottom left, small sans: "Research · prompt · analiza · open source". Clean studio light, subtle glass reflections. No platform logos, no other text. Every word spelled exactly as quoted, including Polish diacritics. +--- +Vertical 4:5 ad promoting "META ADS DESIGNER". Style: before/after phone pair. Two identical modern smartphones without logos stand side by side on a pale grey surface, angled slightly toward each other. Left screen, slightly desaturated: a cluttered generic ad with a purple gradient, tiny icons and a stock smile, small label above it "PRZED". Right screen, vivid: a clean tangerine ad with a sage-green steel bottle, a heavy condensed headline and one yellow sticker, small label above it "PO". A small hand-drawn black arrow points from left to right. Top headline in heavy near-black grotesk: "Ten sam produkt." / "Inny agent.". Soft top light. No platform logos, no other text. Every word spelled exactly as quoted, including Polish diacritics. +--- +Vertical 4:5 ad promoting "META ADS DESIGNER". Style: billboard in situ, clearly a visualisation. Street-level photo at dusk on a Kraków street: a large bus-shelter light box glows with a cobalt typographic poster reading "NOC BRZMI", correct perspective and a slight glass reflection, warm streetlights and a few blurred passers-by. At the top, in white heavy grotesk on the dark sky: "Twoja reklama" / "gotowa na ulicę.". Bottom small white sans: "Wygenerowane przez AI · open source". Documentary realism, no other text, no logos. Every word spelled exactly as quoted, including Polish diacritics. diff --git a/references/style-atlas-2026.md b/references/style-atlas-2026.md index 846e17d..4d9d18c 100644 --- a/references/style-atlas-2026.md +++ b/references/style-atlas-2026.md @@ -37,6 +37,8 @@ Decide in this order and stop as soon as the choice is forced: | Culture, independent brands, community | 9 Tactile zine · 1 Oversized type | | Real estate, apps, digital products | 12 Device-in-hand · 14 Phone-in-hand + giant type · 5 Quiet minimal | | Agency, social media, course or SaaS service | 16 3D service promo · 13 3D clay platform mockup · 15 Script accent · 14 Phone-in-hand + giant type | +| Show the deliverable itself ("this is what you get") | 17 Device stack · 18 Laptop hero · 21 Isometric grid · 22 Before/after phones | +| Make a design or brand feel real | 19 Billboard in situ · 20 Printed piece · 23 Packaging / merch | ## 3 · The atlas @@ -201,6 +203,74 @@ Two common variants, one grammar: a person cut out or posed on a 3D object, a be - **The inner content is real:** the actual ad, listing, portfolio piece or photo of the client, supplied as a reference. Never invented screens (R18). - **People:** real team members or clearly generic models; avoid uncanny AI faces. Documentary skin texture (R40). +### Mockup dialects (17–23) + +A mockup shows the ad or product **inside a believable object or place**: a phone, a laptop, a billboard, a printed poster, a package. It answers the buyer's question "what will I get?" before they read a word. Mockups sell services (design, social media, apps, courses) and make a digital product feel physical. + +**Mockup craft, for all of 13–23:** +1. **Real inner content.** The screen, poster or package shows the actual ad, app or design, passed as a reference image and preserved. Never invented UI or gibberish text (R18). +2. **One hero object.** One device or surface dominates; a second or third only as a smaller supporting echo. +3. **Perspective sells realism.** A slight tilt (10–25°) or isometric view, one light source, a contact shadow, subtle screen reflection. Straight-on flat screens look like templates. +4. **Legible at thumbnail size.** The content on the screen must still read when the whole ad is 300 px wide. If it can't, crop closer. +5. **Neutral hardware.** No manufacturer logos on devices, no platform wordmarks unless official and justified (guardrails above). +6. **Headline outside the mockup.** The selling line (R52) sits on the background, not inside the device, where it would read as UI. + +### 17 · Floating device stack + +- **DNA.** Three phones floating in a staggered diagonal or fan, slightly rotated, each screen showing a different real ad from the same campaign, with soft shadows between them. Pastel or deep single-colour background, headline on one side. +- **Signature device.** A series shown at once; the campaign reads as a system. +- **Use for.** Campaign or content packages, social media retainers, app feature tours, carousel previews. +- **Prompt fragment.** "Three modern smartphones without brand logos float in a staggered diagonal fan on a flat [lilac] background, each tilted about 15°, soft drop shadows between them. Each screen shows a different ad from [the supplied set], sharp and legible. Clean studio light from the top left, subtle glass reflections." +- **Fails when.** More than three devices, identical screens, or screens too small to read. + +### 18 · Laptop / desktop hero + +- **DNA.** A laptop at three-quarter view on a real desk (wood, stone, a coffee cup at the edge, soft window light), the screen showing the dashboard, landing page or course. Warm, credible, "someone works here". +- **Signature device.** An environment that matches the buyer's working life. +- **Use for.** SaaS, online courses, B2B tools, web design, agencies. +- **Prompt fragment.** "A modern silver laptop without a logo at a three-quarter angle on a light oak desk, soft morning window light from the left, a ceramic coffee cup and a notebook at the edge of the frame, shallow depth of field. The screen shows [the supplied landing page], sharp and legible, with a faint natural reflection." +- **Fails when.** The desk is a stock cliché (glowing keyboard, neon), or the screen is unreadable. + +### 19 · Billboard / out-of-home in situ + +- **DNA.** The ad placed on a real city surface: a billboard above a street, a bus shelter light box, a metro wall poster. People and light make the location believable. Implies scale and ambition. +- **Signature device.** The context: "this brand is big enough for the street". +- **Use for.** Brand launches, portfolio promotion ("your ad could be here"), events, local businesses with an outdoor presence. +- **Prompt fragment.** "A street-level photo at dusk of a large bus-shelter light box on a Kraków street, warm streetlights and a few blurred passers-by. The light box displays [the supplied ad] evenly lit, correct perspective and slight glass reflection. Documentary photo realism." +- **Fails when.** It implies a real placement that did not happen. Label it as a visualisation when it is one. + +### 20 · Printed piece in the hand or on the wall + +- **DNA.** The ad as a physical print: a poster taped to a concrete wall, a flyer in a hand, a stack of printed cards on a table, with paper texture, slight curl and real shadows. +- **Signature device.** Tactility: the ad becomes an object you could keep. +- **Use for.** Events, print-and-digital services, cafés and shops, design studios, "Imperfect by design" brands. +- **Prompt fragment.** "A printed A3 poster showing [the supplied design] taped with two strips of masking tape to a rough pale concrete wall, the paper slightly curled at one corner, soft afternoon side light casting a gentle shadow of the curl." +- **Fails when.** The print looks digitally pasted: no curl, no shadow, no paper grain. + +### 21 · Isometric feed grid + +- **DNA.** A tilted, isometric 3×3 or 3×4 grid of the brand's posts floating in space with small gaps between tiles, sometimes one tile lifted forward. Clean single-colour background. +- **Signature device.** One tile popping out of the grid, which is the hero post or the offer. +- **Use for.** Social media management, content creators, brand refresh, "your feed after 30 days". +- **Prompt fragment.** "An isometric floating grid of nine square social posts from [the supplied brand feed], small gaps between tiles, on a flat [mint] background. The centre tile lifts forward toward the viewer with a soft shadow beneath it. Clean, bright studio light." +- **Fails when.** The tiles are random AI images with no shared brand look; the grid must prove consistency. + +### 22 · Before / after phone pair + +- **DNA.** Two phones side by side, slightly angled toward each other: the left screen a weak, cluttered "before" post (greyed or desaturated), the right a strong "after", with a small arrow or label between them. +- **Signature device.** Visible improvement in one glance. +- **Use for.** Redesign services, ad agencies, photo and retouch services, AI tools like this skill. +- **Prompt fragment.** "Two identical modern smartphones without logos stand side by side on a pale grey surface, angled slightly toward each other. The left screen shows [the real before ad], slightly desaturated. The right screen shows [the real after ad], vivid. A small hand-drawn arrow points from left to right. Soft top light, gentle reflections." +- **Integrity.** Both screens are real work. Never fake a bad "before" to exaggerate the improvement. + +### 23 · Packaging / merch mockup + +- **DNA.** The brand or design applied to physical goods: a coffee cup, a paper bag, a box, a T-shirt, a tote, in a styled flat lay or held in a hand. Colour-blocked or natural set. +- **Signature device.** The brand living in the real world. +- **Use for.** Branding studios, new brands, cafés, e-commerce launches, merch drops. +- **Prompt fragment.** "Flat lay from above on a warm beige paper background: a kraft takeaway cup, a paper bag and a small box, all printed with [the supplied logo] exactly as given, arranged with generous space, one sprig of eucalyptus, soft daylight with gentle shadows." +- **Fails when.** The logo is redrawn or warped by the model. Pass the official logo as a reference and inspect it at 100%. + ## 4 · Style is the skin, format is the skeleton A style says how the ad looks. A format in [static-ad-formats.md](static-ad-formats.md) says how it persuades: bold statement, stat drop, review card, callouts, comparison and so on. Choose both explicitly, and state them in one line of the working note: "Format: product + callouts. Style: colour-block still life."