Guizang Social Cards

Guizang Social Card Skill

Create polished social card packages for Xiaohongshu/Rednote, WeChat Official Account, article covers, and platform thumbnails.

This skill is self-contained. It borrows visual principles from the Guizang PPT style system, but it must not edit the original PPT skill, its templates, or its references. If the original PPT skill is available, you may read it for reference only.

Generated work must live in a task folder, not in the skill root. Default to local-tests/<slug>/ inside this repository, or use the explicit output folder requested by the user. Do not create root-level task folders such as social-card-*, livephoto-*, wechat-*, output/, or loose rendered assets next to SKILL.md.

What To Produce

Use this skill for:

• Social card / carousel image sets: cover plus content pages, especially Xiaohongshu/Rednote 3:4.
• Short Live Photo motion cards when the user asks for Live Photo / 实况照片 and supplies video evidence or screen recordings.
• Material-first Live Photo puzzle layouts when the user has high-quality video assets and wants single-video, two-grid, three-grid, or four-grid motion cards with little or no added text.
• Triple Live Photo collages when the user has three short videos, three results, three viewpoints, or a high-information comparison that should stay inside one image-card unit.
• Long-video intake for Live Photo: diagnose whether to trim, speed up, split into a triple collage, or ask the user for a specific time range before rendering.
• WeChat Official Account cover pairs: one 21:9 main cover plus one 1:1 square cover, composed together in the same HTML for visual checking.
• Screenshot-heavy product posts, article covers, tutorial carousels, outdoor/lifestyle notes, AI/product update explainers.
• Social images that need Guizang-style Swiss or editorial magazine layouts.

Do not use this skill for:

• Full slide decks or horizontal PPT websites. Use the PPT skill for that.
• Long-form video generation. Use a video skill for that. This skill only supports short, layout-bound Live Photo cards that replace a still image slot with video.
• Pure image editing with no layout or article extraction requirement.

Rednote Category Capability (capability circle)

The 11 most-common Rednote (小红书) categories fall into three buckets. See references/category-cookbook.md for the recipe-by-recipe routing.

Strong end-to-end (text, structure, and image story all in scope):

• 旅行 (Travel), 职场 (Workplace), 推荐 (Recommended, after specifying a subtype).

Strong on text & structure; image needs to come from the user or a sourced library:

• 游戏 (Game), 影视 (Film/TV), 美食 食谱方向 (Food — recipes only), 彩妆 教程方向 (Makeup — tutorials only), 健身 (Fitness), 家居 (Home), 穿搭 精选方向 (Outfit — capsule/essay only).

Outside scope — push back honestly rather than promise a result:

• 美食 菜品大片摆盘 (food-photography showcase).
• 穿搭 日常 OOTD 全身 (daily OOTD body shots; we cannot generate or simulate).
• 情感 梦核 / 氛围感装饰风 (dreamcore / aesthetic-light styling — clashes with both Editorial and Swiss).
• Y2K / 千禧辣妹 / 哥特萝莉 / kawaii decorated aesthetics.
• Pure photography showcase posts where the image is the entire deliverable.

When a request falls in the third bucket, name what we cannot do at intake — do not silently retrofit a layout that misses the user's intent.

Core Principle

Expression comes first. The goal is not to squeeze text into posters; it is to turn the source into a clear visual argument.

For each page, decide:

• What should the viewer understand in one glance?
• What evidence, screenshot, or image supports it?
• Which words must be large, and which can become captions or metadata?
• What can be removed because it belongs in the post body, not the image?

Required References

Read these files as needed:

• references/platform-specs.md for exact ratios, output sizes, and naming.
• references/style-system.md for Guizang editorial and Swiss visual rules.
• references/theme-presets.md when choosing electronic-magazine palettes or Swiss accent palettes.
• references/layout-recipes.md when selecting carousel/social-card/WeChat page structures.
• references/components.md for the shared component spec: font stacks, type scale, minimum readable sizes, Chinese title length bands, Swiss card-fill mutual-exclusion rule, image-container ratio classes, spacing tokens, and Lucide icon rules.
• references/background-systems.md when building electronic-magazine WebGL/ink/paper backgrounds.
• references/portrait-fill.md when adapting layouts to 3:4 and avoiding under-filled vertical space.
• references/content-planning.md for cover hooks, page breakdown, and copy compression.
• references/production-workflow.md for HTML/CSS rendering and image handling.
• references/live-photo-production.md when the user asks for Live Photo / 实况照片 / 三连实况拼图, supplies video assets for a social card, or wants Xiaohongshu / WeChat motion-card delivery. It covers information budget, single vs triple Live Photo, long-video intake, and platform publishing reminders.
• references/image-overlay.md whenever text sits on top of a photo: photo qualification, localized tint fallback, and face / subject avoidance via multimodal subject mapping.
• references/screenshot-treatment.md when the user supplies an app / web / code / dashboard screenshot — picks .frame-shot over .frame-img, sets corners/shadow/bg/inset, decides on .device-browser or .device-phone chrome.
• references/map-component.md when the content has spatial relationships (travel route, store locations, walking tour) — real routes default to Mapbox Static or OSM static tiles; schematic SVG is only for conceptual / illustrative maps. Pins are HTML overlays; never use live JS maps.
• references/title-shortener.md when the task is a WeChat 21:9+1:1 cover pair, or any cross-platform reuse — derives the 1:1 short title from the long one (5-step extraction, 4 patterns, anti-patterns, sizing on .poster.square).
• references/category-cookbook.md to route a user-named Rednote category (旅行 / 职场 / 游戏 / 影视 / 彩妆 / 美食 / 穿搭 / 家居 / 健身 / 情感 / 推荐) to applicable recipes and to confirm scope.
• references/qa-checklist.md before delivering final images.

Workflow

1. Intake

Gather only the missing information that changes the output:

• Target platforms and ratios.

• Source text, subtitles, article, or title.

• Rednote category — if the user names one of the 11 common types (旅行 / 职场 / 游戏 / 影视 / 美食 / 彩妆 / 穿搭 / 家居 / 健身 / 情感 / 推荐), route via references/category-cookbook.md to find the right recipes and to confirm the request is inside the capability circle (see "Rednote Category Capability" above). If a request lands in the outside-scope bucket, surface that to the user before designing, do not silently retrofit.

• Supplied images/screenshots and where each should appear. For News / Tutorial / Data / Review content, actively prompt for screenshots or photos — they are the evidence layer. A poster with no real artifact tends to read as filler.

• Supplied video assets, if the user asks for Live Photo. Treat user-provided video as the normal path; web-sourced free video is only for demo/promo cases or when the user explicitly asks for sourced material. Confirm the target platform because duration differs: Xiaohongshu supports 5s; WeChat Official Account Live Photo should stay at 3s and must be uploaded from iPhone. Before cutting, read references/live-photo-production.md and classify the request as single Live Photo, triple collage, or long-video intake. If the source is too long or contains multiple usable moments, do a low-cost diagnosis first, then ask once whether to trim, speed up, split into multiple wells, or use a user-specified time range. If the source is shorter than the target duration, ask whether to provide a longer clip, accept a shorter Live Photo, or explicitly allow a hold/slowdown. If the important focus is ambiguous, suggest possible crop/enlarge options but let the user decide before executing.

• If the user supplies only text (no images at all), ask once before designing:

  这篇我需要 1-2 张图。三种走法：
  A. 你自己有照片 / 截图，传给我（推荐——最不"AI 感"）
  B. 我去 Pexels / Unsplash / Flickr 帮你找
  C. 用 AI 生成

  Recommend A in one line — your own photo is what makes a poster not look AI-generated. Accept whatever the user picks (including "都行你看着办") and proceed. Do not re-prompt later, do not keep nudging toward A across multiple turns. This question is one-shot.

• Preferred style if specified: Swiss Style, magazine/editorial, tech, outdoor, etc.

• Hard constraints: title text, no image on 1:1 cover, must include a hardware photo, keep screenshot readable, and so on.

If the user has already supplied enough context, proceed with reasonable assumptions.

If the content involves current product releases, policies, prices, claims, or news, verify unstable facts with browsing and cite sources in the final response.

2. Extract The Story

Turn the source into a page plan before designing.

For Rednote:

• Page 1 is the cover hook.
• Pages 2-N each carry one idea only.
• Use 5-9 pages for most posts. Compress or combine pages when lower areas become empty.
• Keep the post body for nuance; images should carry hooks, comparisons, checklists, and sharp takeaways.

For WeChat:

• Always produce a paired system: 21:9 main cover and 1:1 square cover.
• Build both covers in the same HTML file and add a combined preview section so their visual relationship can be checked together.
• 21:9 keeps the full or near-full title, subtitle, and one strong visual relation.
• 1:1 uses a simplified short title derived from the long title: big centered type, no image by default, no cramped subtitles.

3. Choose Style Mode

Pick one mode per package. The two systems are not bound to specific content types — what changes is the visual stance, not which topic you can talk about. A workplace essay can be Editorial; a travel ledger can be Swiss. Pick by the feeling you want, not by category lookup.

Editorial Magazine x E-ink brings:

• Serif/Songti display + quiet sans body, paper + ink palette.
• Atmosphere layer (paper grain / ink wash / WebGL canvas) over a warm paper base.
• Ledger rows, marginalia, pull quotes, large photo wells — magazine-feature feel.
• Best when you want the page to feel slow, considered, hand-set.

Swiss International brings:

• Inter / Helvetica feel, very light display at large sizes, mono labels at small.
• Strict left-aligned grid, hairline rules, one high-saturation accent.
• Card-fill matrices, KPI towers, h-bar charts, numbered statements — system / data feel.
• Best when you want the page to feel engineered, quantified, decisive.

If both feel viable for a piece of content, the question becomes editorial intent: "is this a feature story or a release note?" That decides the mode, not the topic itself.

Do not mix the two visual systems inside the same image set unless the user explicitly asks for a hybrid.

Then pick one theme:

• Editorial Magazine x E-ink uses one of 6 magazine palettes: Ink Classic, Indigo Porcelain, Forest Ink, Kraft Paper, Dune, or Midnight Ink (the only dark variant; reserved for game key art / night photography / cinematic covers).
• Swiss International uses one of 4 accent palettes: IKB Blue, Lemon Yellow, Lemon Green, or Safety Orange.

Read references/theme-presets.md for exact CSS tokens. Do not invent arbitrary colors unless the user has a strict brand requirement.

4. Plan Pages

Create a concise internal plan:

Page 01 / cover / hook / image source / layout intent
Page 02 / point / key copy / visual evidence / layout intent
...

When the user asks for approval, show this plan before rendering. Otherwise use it internally and proceed.

Use references/layout-recipes.md to choose page structures. Avoid making every page a repeated title-plus-card layout.

For 3:4 images, check references/portrait-fill.md before coding. A short table or ledger must be expanded into a full portrait composition with a quote column, image evidence, marginalia, larger rows, or a background hero zone.

Audience-facing copy must describe the user's actual scene, not the production method. Internal terms such as 3s, 5s, Live Photo, triple collage, information budget, long-video intake, speed-up, highlight detection, one action point, or layout template may guide planning, filenames, QA notes, and delivery summaries, but they must not become the H1, hook, or main body copy unless the user is explicitly making an instructional post about those concepts. Before rendering, read every visible headline once as a real viewer: if it sounds like a task requirement, replace it with scene-specific copy.

Do not add non-template ornaments just to satisfy an automated density warning. Extra rulers, side bars, pseudo time axes, decorative labels, or invented badges must come from an existing layout recipe or a user request. If a density warning appears, fix it by choosing a better recipe, resizing real content, or accepting the advisory warning with a visual rationale; do not put meaningless UI on the card.

For Live Photo cards, plan them as normal social cards first, then decide the motion role: one action point, one small process, a before/after change, three parallel results, or ambience/evidence. The only structural change is that one or more image wells become video wells. Keep the same ratio, crop, safe-area, typography, and style mode rules; apply the still-image crop logic to the video stream. The first frame must pass the same checks as a static image: no excessive crop, key UI/content remains readable, and the card still follows the chosen layout recipe. Read references/live-photo-production.md before rendering.

For material-first Live Photo puzzle cards, let the video assets lead. Use little or no copy: one short headline is enough for a single-video cover, and two-grid / three-grid / four-grid versions should usually have no added text. When a single-video cover adds text on top of the footage, use the M16 Image-Led Cover / text-on-image rules: subject map first, safe quiet zone, Editorial serif/Songti title at regular-medium weight, paper-cream text, and no default full-canvas mask. Do not invent extra kicker, meta, hairlines, labels, rulers, badges, subtitles, or explanatory production terms just to make the overlay feel designed. If only one headline is available, make the typography carry the layout: phrase-aware line break, restrained size, tracking, alignment, and placement. Treat source-embedded text as part of the footage; only avoid adding new text unless the user asks.

4.5. Copy The Seed Template

Do not write HTML from scratch. Pick one seed template based on the style mode chosen in Step 3:

• Editorial Magazine × E-ink → copy assets/template-editorial-card.html into the task folder as index.html.
• Swiss International → copy assets/template-swiss-card.html into the task folder as index.html.

The seed already wires up: font loading, theme tokens, all three poster sizes (.poster.xhs / .poster.square / .poster.wide), the pair-preview frame, grain/background layers, and all class definitions referenced by the layout recipes.

Set the theme/accent on the <html> element:

• Editorial: <html data-theme="ink-classic | indigo-porcelain | forest-ink | kraft-paper | dune | midnight-ink">.
• Swiss: <html data-accent="ikb | lemon-yellow | lemon-green | safety-orange">.

Replace the single placeholder poster after <!-- POSTERS_HERE --> with one <section class="poster ..."> block per page, each carrying the HTML skeleton from a chosen Layout Recipe (M01-M16 for Editorial, S01-S12 for Swiss). Never load the wrong template's class system: Editorial recipes assume serif display + ledger/marginalia/pipeline-v; Swiss recipes assume Inter + card-fills + matrix/h-bar/kpi-tower. Mixing them silently breaks the layout.

5. Build And Render

Default implementation pattern:

• Create a task folder under local-tests/<slug>/ by default, or inside the user-requested output folder. Never put generated task folders, rendered images, MOV files, .pvt packages, or downloaded sources in the skill root next to SKILL.md.
• Put source images in assets/.
• Start from the seed template copied in Step 4.5, not a blank file. Prefer changing only the <!-- POSTERS_HERE --> region page-to-page. If a task needs custom layout CSS, add one clearly named task-scoped block in the copied file and keep semantic defaults reset (figure { margin:0; }, no browser-default spacing surprises).
• Use Playwright or a browser screenshot tool to export each .poster or .cover node.
• Save rendered images in output/.
• Verify dimensions and inspect the rendered PNGs.
• Keep node validate-social-deck.mjs <task-dir> available for auto-check passes. It checks overflow (R1), footer collision (R2), Swiss bold display (R3), minimum font size (R4), 4-band density (R5), .h-xl line caps (R6), browser-default figure margin drift (R7), visual bounds / bottom whitespace (R8), and title-to-content gaps (R9). Exit code 1 on any FAIL — fix before final delivery when auto-check is requested. WARN is advisory but read it.

Live Photo branch:

• Decide the information budget before rendering: 3s fits one action point; 5s fits one small process; triple collage fits three parallel clips but not a complex story; long videos require diagnosis before editing.
• For long sources, avoid claiming precise automatic highlight detection. Probe duration/resolution, make a sparse contact sheet, and choose between trim, speed-up, split/triple collage, or asking the user for a time range.
• Extract a first frame from each video well, place it in the final static card layout, and show/inspect that preview before making .pvt. This catches crop and hierarchy issues with much lower token and render cost.
• Render the paired MOV at the platform duration: 5s for Xiaohongshu, 3s for WeChat Official Account.
• Extract the key JPG from a readable representative frame.
• Package JPG + MOV into .pvt with makelive; AirDrop the .pvt as one item for iPhone tests.
• Validate dimensions, duration, frame count, package contents, and motion quality. Prefer a contact-sheet frame strip for visual checks so only the final tiled image needs human/model inspection. Use references/live-photo-production.md for exact commands and failure-mode checks.

Do not place visible instructions, keyboard shortcuts, or usage explanations inside the images.

For Editorial Magazine x E-ink, use a layered background system. Prefer a subtle WebGL ink-flow canvas or a frozen procedural canvas plus paper grain. Read references/background-systems.md; do not rely on a flat beige background, and do not add page-wide grid/dot backgrounds.