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.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",
Expand Down
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
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.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)

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** — 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.
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) | 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 |
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.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)

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** — 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.
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) | 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ę |
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.3.0
version: 6.4.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 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.
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). 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.

Expand Down
6 changes: 6 additions & 0 deletions examples/prompts/skill-promo-styles.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Loading
Loading