agentleFS
sanky369sanky369/vibe-building-skills/skills/creative/social-graphics/SKILL.md

social-graphics

Skill30 starsChanged 5 months agoMITView on GitHub

Produce platform-correct social media graphics: pick the right dimensions and layout per platform, write the headline/body/CTA copy, build the generation prompt, and generate the image via the repo's FAL.ai pipeline. Use whenever the user wants a social post visual, Instagram post/story/carousel, LinkedIn graphic, Twitter/X image, TikTok thumbnail, Pinterest pin, launch announcement graphic, or 'something to post about X' — even if they never name a platform. Also use to adapt one design across several platforms. Produces a Social Graphic Spec per asset (platform, dimensions, layout, copy, full generation prompt) plus generated images when FAL_API_KEY is available.

  • Reads credentials

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 5 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use for platform-bound static visuals: feed posts, stories, pins, link-preview images, announcement graphics, quote cards, carousels.

    line 12
  2. Very specific:

    No brand style yet and the user wants a consistent look → run skills/creative/creative-strategist first.

    line 16
  3. Very specific:

    If the visual language itself feels generic and needs an original identity → skills/creative/original-design first.

    line 17
  4. Distinctive:

    Ask in one tight batch, only what's missing:

    line 21
  5. Distinctive:

    If the copy can't fit these limits, the post is carrying more than one message — split it into a carousel or multiple posts and tell the …

    line 57
  6. Distinctive:

    Always reserve explicit "clean negative space at [position] for text overlay" in the prompt — nano-banana-pro renders text imperfectly, so …

    line 73
  7. Very specific:

    If FAL_API_KEY (or FAL_KEY) is set, run the repo CLI (docs/fal_api.py under the hood, model fal-ai/nano-banana-pro):

    line 77
  8. Distinctive:

    No invented engagement statistics.

    line 130

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Social Graphics

Turn a message and a platform into ready-to-post graphics. For each asset you produce a Social Graphic Spec — platform, exact dimensions, layout, overlay copy, and a complete generation prompt — then generate the image through the repo pipeline (docs/creative_cli.py, model fal-ai/nano-banana-pro). The governing principle: a social graphic is read for under two seconds — one message, one focal point, one CTA; if a viewer can't get the point from a thumbnail-sized glance, the design fails regardless of how good it looks full-size.

When to use / when not to

  • Use for platform-bound static visuals: feed posts, stories, pins, link-preview images, announcement graphics, quote cards, carousels.
  • Logos, icons, patterns, brand marks → skills/creative/brand-asset.
  • Standalone product hero shots (no platform framing, no overlay copy) → skills/creative/product-photography.
  • Motion content → skills/creative/product-video (product-led) or skills/creative/talking-head (person-led).
  • No brand style yet and the user wants a consistent look → run skills/creative/creative-strategist first; its style guide feeds this skill.
  • If the visual language itself feels generic and needs an original identity → skills/creative/original-design first.

Intake

Ask in one tight batch, only what's missing:

  1. Message — what is this post saying, in one sentence? What should the viewer do (CTA)?
  2. Platform(s) and format — Instagram feed/story/carousel, LinkedIn, Twitter/X, TikTok, Pinterest? One platform or a multi-platform set?
  3. Brand constraints — style guide from skills/creative/creative-strategist, brand colors/fonts, product imagery to feature?
  4. Tone — professional, trendy, minimalist, playful?

Infer instead of asking: tone from the platform (LinkedIn → professional; TikTok → energetic), colors from any brand materials in the project. Don't stall: with a clear message and platform, state assumptions for the rest and proceed.

Platform specifications (source of truth for dimensions)

PlatformFormatPixelsCLI aspect-ratioDesign posture
InstagramFeed post1080×10801:1vibrant, high contrast, trending aesthetic
InstagramStory / Reel cover1080×19209:16full-bleed vertical, text in safe zone
InstagramCarousel1080×13504:5one idea per card, visual continuity across cards
LinkedInFeed post1200×62716:9*professional, credible, value-led copy
LinkedInDocument page1200×15004:5clean, readable, business imagery
Twitter/XPost image1200×67516:9bold, simple, instant visual impact
TikTokThumbnail/graphic1080×19209:16bold text overlays, energetic, authentic feel
PinterestStandard pin1000×15002:3vertical, inspiring, high-quality imagery

*Closest supported ratio; the CLI supports 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 — always pick the nearest and note any crop.

Workflow

1. Resolve platform and format

If the user named a platform, use the table above. If not, decide: B2B/professional audience → LinkedIn; consumer/lifestyle → Instagram; discovery/how-to/aspirational → Pinterest; announcement to an existing following → the platform where they have one (ask only if truly unknown). Multi-platform request → design the master for the most constrained format first (usually 1:1 or 9:16), then adapt per platform; never stretch one image across all.

2. Write the copy before the visual

  • Headline: ≤10 words, the message itself, not a teaser.
  • Body (optional): ≤2 short lines supporting the headline.
  • CTA: 2–4 words, action verb ("Shop now", "Get the guide", "Link in bio").

If the copy can't fit these limits, the post is carrying more than one message — split it into a carousel or multiple posts and tell the user why.

3. Design the layout

Pick one focal point (product shot, illustration, bold typography) and place copy against the quietest area. Decision rules: photo-led → headline top or bottom third over a darkened/blurred band; typography-led → headline IS the focal point, minimal imagery; carousel → identical layout grid on every card, only content changes. Rule of thirds, generous negative space, max 2–3 font roles (headline / body / CTA).

4. Build the generation prompt

Formula — every prompt contains all six parts, in order:

[Platform + format] graphic, [subject/focal point], [color palette from brand or chosen],
[composition: focal point + where copy space is reserved], [tone/mood words],
[dimensions], professional design, high contrast, eye-catching

Always reserve explicit "clean negative space at [position] for text overlay" in the prompt — nano-banana-pro renders text imperfectly, so plan to overlay final copy in a design tool rather than trusting generated text for anything longer than 2–3 words.

5. Generate

If FAL_API_KEY (or FAL_KEY) is set, run the repo CLI (docs/fal_api.py under the hood, model fal-ai/nano-banana-pro):

python docs/creative_cli.py social \
  --platform instagram --topic "Product Launch" \
  --prompt "<full prompt>" --aspect-ratio 1:1 --resolution 2K

--platform accepts instagram|linkedin|twitter|tiktok|pinterest. Generate --num-images 2 when the user is choosing between directions. If no key is set, deliver the spec with ready-to-run commands instead.

6. Self-check against the quality bar, deliver the spec + images.

Required output format

One block per asset; a multi-platform set is the master followed by adaptation blocks:

# Social Graphic Spec — [Campaign/Message]

## Asset 1 — [Platform · Format]
- **Dimensions:** 1080×1080 (aspect `1:1`) · **Role:** master | adaptation
- **Message:** [one sentence]

### Copy
- Headline: "..." (≤10 words)
- Body: "..." (≤2 lines, or —)
- CTA: "..."

### Layout
- Focal point: ... · Copy placement: ... · Palette: [colors + source: brand guide / chosen]

### Generation prompt
> [full prompt, all six parts]

`python docs/creative_cli.py social --platform [x] --topic "[x]" --prompt "..." --aspect-ratio [x] --resolution 2K`

### Result
- [generated file path(s), or "pending — FAL_API_KEY not set"]
- Post-gen step: overlay final copy in design tool: [yes/no + what]

## Asset 2 — [Platform · Format]
(same structure; for adaptations, note only what changes from the master)

Quality bar (check before delivering)

  • Dimensions match the platform table exactly; aspect ratio is a supported CLI value.
  • Headline ≤10 words; total text ≤3 elements (headline, body, CTA); one message per asset.
  • Copy placement sits over reserved negative space, not over the focal point.
  • Text-background contrast is explicitly handled (band, shadow, or blur called out in layout).
  • Palette and tone match the brand style guide when one exists; deviations flagged to the user.
  • Prompt contains all six formula parts, including reserved copy space.
  • Multi-platform sets: adapted per format, never one image stretched; carousel cards share one grid.
  • No invented engagement statistics; "best practice" guidance here is heuristic — label it if asked.

Integration

  • skills/creative/creative-strategist → feeds in: the style guide (palette, typography, mood) every spec must obey.
  • skills/creative/original-design → feeds in: a design-language brief when the user wants an original visual world; every graphic becomes an artifact of it.
  • skills/creative/product-photography → feeds in: product shots reused as focal-point imagery.
  • skills/creative/product-video → feeds in: hero keyframes reused as post visuals; consumes: nothing.
  • skills/creative/brand-asset → feeds in: logos/marks to place; consumes: nothing.
  • skills/creative/orchestrator → routes multi-asset campaigns through this skill per platform.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.