Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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.4.0",
"version": "6.5.0",
"author": { "name": "AI Evolution Labs", "url": "https://github.com/aievolutionpl" },
"homepage": "https://github.com/aievolutionpl/meta-ads-designer",
"license": "MIT",
Expand Down
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,17 @@ All notable changes to Meta Ads Designer. Versions follow [SemVer](https://semve

---

## [6.5.0] — 2026-09-24

### Added
- **Styles 24–26:**
- geometric promo banner, the classic retail/real-estate template done well: one offer, one CTA pill, no placeholder text, the product breaking out of its colour block;
- tonal product launch, with everything tuned to the product's colour, two product views and ghost model letters, plus reseller trademark guardrails;
- screen spill, a carousel or lookbook unfolding out of an isometric phone.
- Brief-need rows for sales, launches and carousels.

---

## [6.4.0] — 2026-09-24

### Added
Expand Down
6 changes: 3 additions & 3 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.4.0-222222)
![Version](https://img.shields.io/badge/version-6.5.0-222222)
![License](https://img.shields.io/badge/license-MIT-222222)
![Model independent](https://img.shields.io/badge/prompts-model_independent-222222)

Expand Down Expand Up @@ -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** — 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.
- **Style atlas 2026** — twenty-six 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.
Expand Down Expand Up @@ -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) | Twenty-three visual languages, trend slop, reading reference boards |
| [Style atlas 2026](references/style-atlas-2026.md) | Twenty-six 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 |
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.4.0-222222)
![Version](https://img.shields.io/badge/version-6.5.0-222222)
![License](https://img.shields.io/badge/license-MIT-222222)
![Model independent](https://img.shields.io/badge/prompts-model_independent-222222)

Expand Down Expand Up @@ -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** — 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.
- **Atlas stylów 2026** — dwadzieścia sześć 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.
- **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.
Expand Down Expand Up @@ -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) | Dwadzieścia trzy języki wizualnych, trend slop, czytanie plansz referencyjnych |
| [Atlas stylów 2026](references/style-atlas-2026.md) | Dwadzieścia sześć języków 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ę |
Expand Down
4 changes: 2 additions & 2 deletions SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.4.0
version: 6.5.0
author: AI Evolution Labs
url: https://github.com/aievolutionpl/meta-ads-designer
---
Expand Down Expand Up @@ -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 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.
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), plus 24–26 for retail sales, tonal launches and carousel screen spills 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.
Expand Down
2 changes: 1 addition & 1 deletion core.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) · 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.
**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 · geometric promo banner (one offer, one CTA pill, no placeholder text) · tonal product launch (everything in the product's colour) · screen spill (carousel unfolding out of the phone). 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.

Expand Down
34 changes: 34 additions & 0 deletions references/style-atlas-2026.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,9 @@ Decide in this order and stop as soon as the choice is forced:
| 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 |
| Sale, drop or listing for the mass market | 24 Geometric promo banner · 8 Performance sticker |
| Launch a product with a signature colour | 25 Tonal product launch · 2 Colour-block still life |
| Carousel, lookbook or campaign case study | 26 Screen spill · 17 Device stack |

## 3 · The atlas

Expand Down Expand Up @@ -271,6 +274,37 @@ A mockup shows the ad or product **inside a believable object or place**: a phon
- **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%.

### Retail and launch dialects (24–26)

### 24 · Geometric promo banner (done well)

The classic e-commerce and real-estate "template" banner: diagonal colour blocks, a cut-out product crossing the shapes, a big offer, a CTA pill. It is everywhere because it reads fast. It is slop when it carries lorem ipsum, three offers, four fonts and a stock face. Done well, it converts.

- **DNA.** One saturated brand colour and one contrast colour cut into two or three **large diagonal or curved blocks**. The product is cut out cleanly, **crossing a block edge**, with a real shadow. A two-level headline: a small script or light word ("Stylish Shoe") over a heavy bold offer ("BIG SALE"). One offer number large ("−50%", "od 7 000 000 zł"). **One** CTA pill ("Kup teraz"). For real estate: a photo inside a rounded or angled frame, 3–4 features as a tidy two-column list with small dots.
- **Signature device.** The product breaking out of its colour block.
- **Use for.** E-commerce sales, product drops, real-estate listings, gadgets, local retail, and markets where this direct style is the norm.
- **Avoid for.** Premium, fashion-forward or minimalist brands.
- **Prompt fragment.** "Square 1:1 retail ad. A magenta background with a large white curved block sweeping across the lower-left third. The supplied sneaker, cut out cleanly with a soft contact shadow, crosses the edge between the two colours at a dynamic angle. Top left: small white script word "[Stylish Shoe]" above a heavy yellow bold "[BIG SALE]". Right side: "[do −50%]" in large white bold. One white rounded pill bottom right: "[Kup teraz]". Small brand wordmark top right. No other text, no lorem ipsum, no icons."
- **Rules that separate good from template.** Real copy only, never placeholder text; one offer, one CTA, at most two typefaces plus one script word; every block edge leads the eye to the product or the offer; contact rows only if real.
- **Fails when.** It has placeholder text, a fake "Click here" plus a "Shop now" plus a phone number, clip-art triangles scattered around, or a brand logo that isn't the advertiser's.

### 25 · Tonal product launch

- **DNA.** The whole ad is tuned to **the product's own colour** (sierra blue, sage, graphite): background, headline, even the shadows are tints of one hue. The product is huge, cropped by the frame, shown in two views (back plus front) overlapping. Giant ghost letters of the model name are faintly visible behind it. A rounded or extended geometric sans headline centred at the top, with a two-line support line beneath. A thin top bar with contact or social handles.
- **Signature device.** Monochrome harmony: the product looks like it grew out of the background.
- **Use for.** Launches of phones, gadgets, cosmetics, drinks, cars, any product with a signature colour; retailer and reseller ads.
- **Prompt fragment.** "Vertical 4:5 launch ad in soft tonal blues. Pale periwinkle background with the letters "[MODEL]" extremely large and faint behind. The supplied smartphone shown twice, back with the camera module on the left and front screen on the right, overlapping, large and cropped by the bottom edge, soft studio reflections. Top centre: a rounded geometric sans headline in deep blue on two lines, "[Headline line 1]" / "[line 2]", with a two-line support line below in regular weight. A thin top row: "[website]" left, "[phone]" right."
- **Guardrails.** Only resellers or owners authorised to advertise a branded product may name it or show its logo. The product must match the real model exactly (R03), and headlines must not promise specs the product lacks. "Speed reimagined. Power refined." is copy slop under R52; state a real spec or benefit instead.
- **Fails when.** Invented device details (extra cameras, wrong notch), or the tonal palette hides the product's edges.

### 26 · Screen spill (content breaking out of the device)

- **DNA.** A phone lies flat at an isometric angle on a plain warm-grey surface. Its content, a carousel, a lookbook or a campaign, **unfolds beyond the screen edges** like a printed strip or a folded leaflet: panels extend left and right, bending in 3D, with real shadows on the surface. Minimal editorial type on the screen itself (collection name, one line).
- **Signature device.** The feed escaping the phone: the carousel made physical.
- **Use for.** Carousel ads, fashion lookbooks, campaign case studies, content packages, agencies showing work.
- **Prompt fragment.** "Isometric top-down view of a white smartphone without a logo lying on a plain warm light-grey surface. The screen shows an editorial page with the title "[SS26]" and a subtitle "[collection name]". The screen's photo content extends beyond the phone on both sides as a long printed strip of [three supplied campaign photos], gently folded and curling off the surface, casting soft realistic shadows. Clean diffuse light, lots of empty space around."
- **Fails when.** The strip's photos are invented rather than the real campaign, or the fold geometry breaks (panels floating without shadow).

## 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."
Expand Down
Loading