Punk Cover

SkillDocs & knowledge

Lets your agent design cover images for articles and social posts by picking a style and writing ready-to-use image prompts.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Punk Cover skill

About this capability

Generate localized cover images and reusable image prompts from the shared Punk style library for articles, Xiaohongshu notes, WeChat public account posts, X posts, Instagram, Facebook, LinkedIn, YouTube, TikTok, Pinterest, Snapchat, Reddit, Threads, Bluesky, Medium, topic drafts, and requests for c

What this skill tells your AI

The instructions your AI receives, as published by adrianpunk/punk-skill in skills/punk-cover/SKILL.md and read by ahel’s review.

Core Rule

punk-cover is a cover-generation workflow, not a style owner. Select exactly one reusable style from the repository-level styles/ library, then compile that style atom into the cover shape.

The workflow is localized. Detect the host system language/locale before presenting choices: use Chinese mode for zh, zh-CN, zh-TW, or another Chinese locale; use English mode for other locales. The user may explicitly override this with 中文, English, or 中英双语. In the selected mode, localize platform labels, style names, questions, notices, and generated supporting text. The source title and any user-provided proper nouns remain unchanged unless the user asks for translation.

The final image prompt is not a loose concatenation of "cover instructions + style instructions". It must be one integrated, cover-specific prompt that applies the selected style to the cover format.

Use three inputs:

  1. punk-cover task fields: platform, requested aspect ratio, resolved generation ratio, language mode, optional output dimensions and output mode, title clarity, article summarization, cover communication goals, and universal output constraints.
  2. The selected style's META.md metadata and STYLE.md reusable visual style atom.
  3. references/cover-prompt-blueprint.md, which defines the full cover prompt shape.

The style file defines the reusable visual language. The cover blueprint defines the output form. The final prompt must fuse them into one complete cover-generation prompt.

Resources

  • Read references/style-catalog.md to list or choose cover styles.
  • Read references/platform-catalog.md before presenting platform choices or resolving an aspect ratio.
  • Read references/cover-prompt-blueprint.md before composing the final prompt.
  • For the selected style, read both:
    • ../../styles/{style-id}/META.md
    • ../../styles/{style-id}/STYLE.md
  • Only expose styles whose META.md metadata has outputs containing cover or poster.
  • Do not expose photo, avatar, portrait, pet-only, polaroid-only, or image-remix styles in the punk-cover menu unless their metadata explicitly includes cover or poster.
  • Do not use legacy cover templates. Use only the selected style's META.md, STYLE.md, and references/cover-prompt-blueprint.md.

Workflow

  1. Analyze the source material:

    • Extract the core visual subject.
    • Preserve the complete user title or topic when one exists, but do not copy the full article body into any output field.
    • Draft an optional subtitle when the selected style has a subtitle field.
    • Summarize context, audience, mood, metaphor, and banned elements.
    • Convert long source material into concise derived fields: title/topic, 1-3 sentence context summary, visual subject, audience, mood, metaphor, and banned elements.
  2. Confirm platform and aspect ratio before generating any prompt:

    • Resolve the language mode from the host system before presenting this localized menu.
    • Use references/platform-catalog.md for the localized platform menu and the complete platform-to-ratio mapping.
    • Keep both the user's requested ratio and the resolved generation ratio in the task fields.
    • For an unsupported requested ratio, automatically resolve to the numerically closest supported generation ratio. State in the active language mode that only the closest ratio can be generated, then use that resolved ratio directly; do not ask the user to choose another ratio.
    • The X request 5:2 resolves to 21:9.
    • The WeChat public account request 2.35:1 resolves to 21:9.
    • Custom supported ratios are preserved; custom unsupported ratios use the same nearest-ratio rule.
    • If the user only provides source content, ask which platform they want to publish to. Do not generate the prompt yet.
    • If the user provides a custom ratio, resolve it as above and do not ask for platform unless the platform matters for wording.
    • If the user provides exact width × height without a ratio, derive and preserve that ratio. If explicit dimensions and an explicit ratio conflict, ask which one should control before generating.
    • Default to a single image. If the user explicitly requests a multi-size suite, preserve every requested ratio or output dimension and require at least two targets before generation.
    • Never satisfy a multi-size request by cropping, stretching, padding, or placing multiple ratios in one grid; compile one independently composed prompt per target ratio.
    • Only skip this question when the user has already provided a platform, a ratio, or explicitly says to decide everything automatically.
  3. Confirm style before generating any prompt:

    • Use the language mode already resolved from the host system language/locale; accept an explicit user override.
    • When presenting style choices, show only the localized Style name and Best for content for the active mode. Do not show Chinese and English menu copies together unless the user selects bilingual mode or asks for both.
    • In Chinese mode, use the Chinese style names and explanations from references/style-catalog.md; in English mode, use the English equivalents. The style ID remains unchanged in both modes.
    • Accept a style ID or either localized display name as an unambiguous style selection.
    • The language mode controls the prompt, title/subtitle treatment, labels, questions, and supporting text. It does not translate user text without permission.
    • If the user specifies one catalog style, use it.
    • If the user supplies a complete visual direction that matches a catalog style, including the 复古时代错位编辑封面 brief, a “复古未来主义 × 模拟基础设施 × 巨型系统流动 × 复古印刷质感” brief, a “超大标题 × 中央视觉主体 × 图文穿插” brief, a “真实纸雕层叠 × 极简留白 × 柔和光影 × 准确隐喻” brief, a “真实纸张质感 × 击凸压凹 × 文字构图 × 克制视觉隐喻” brief, an “抽象概念 → 具体场景 → 游戏机制 → 像素视觉隐喻” brief, an “OSB 木板 × 工业蓝标识字 × 极简线条隐喻” brief, or a “黑白复古蚀刻版画 × 排线交叉排线 × 单一超现实隐喻” brief, or a “极简轻科技 × 纯白留白 × 单一渐变锚点 × 现代黑体标题” brief, treat that style as specified and use the matching META.md and STYLE.md without asking the user to repeat the style.
    • If no style is specified, recommend exactly three eligible catalog styles based on the content and give a one-sentence reason for each, then ask the user to choose one or provide a custom style direction.
    • Do not show all eligible styles by default unless the user asks for the full menu.
    • Only auto-select one style when the user explicitly says to decide everything automatically, not merely because they provided an article.
  4. Use this confirmation gate:

    • When platform/ratio or style is missing, stop after asking the question. Do not fill a style file, save prompt files, or generate an image.
    • The first response for article-only input should contain the platform question and three recommended styles.
    • If both platform/ratio and style are known, continue without asking.
  5. Compile the final image prompt:

    • Use references/cover-prompt-blueprint.md as the required structure for prompts/cover.md.
    • Read exactly one selected style visual atom from ../../styles/{style-id}/STYLE.md.
    • Read the selected style metadata from ../../styles/{style-id}/META.md, including style_anchors, cover_shape_adaptation, must_preserve, and avoid_when_applying_to_cover when present.
    • Extract the selected style's non-negotiable visual anchors: materials, spatial logic, title treatment, typography behavior, texture, color system, and style-specific negative constraints.
    • Fuse the cover task fields and style anchors into one full cover prompt. The final prompt should read like a complete cover-generation brief, similar to the legacy complete prompts in exports/, not like two unrelated prompt fragments pasted together.
    • Include cover-shape sections for role/task, input fields, content understanding, title hierarchy, cover composition, style application, image-text relationship, typography, color/material/texture, negative constraints, and final standard.
    • Every cover decision must be expressed through the selected style. For example, if the style is torn collage, the title, subject, support text, background, and metaphor must be implemented as torn paper, old newspaper, tape, grain, halftone, and paper layers; not as a generic cover with collage words appended.
    • Do not append the raw STYLE.md content as a standalone second section. Rewrite and adapt its style atoms into the cover blueprint.
    • Do not combine multiple styles or add a second custom style section.
    • Replace or resolve all explicit placeholders such as {{主题词}}, {{副标题,可留空}}, {{画幅比例...}}, {{请求比例...}}, {{生成比例...}}, {{语言...}}, {{用途...}}, {{补充背景,可留空}}, {{情绪倾向...}}, {{不想出现的元素,可留空}}, and any other {{...}} fields.
    • If a needed detail has no matching placeholder, merge it into the nearest cover section such as 补充语境, 风格落地方式, or 禁用元素.
    • For long articles, fill title/topic fields with concise derived titles or title layers, not the article text.
    • Put only summarized context into the prompt; do not paste the original article body into the final prompt.
    • Leave optional fields blank only when the prompt says they can be blank.
    • Do not output analysis inside the final prompt.
    • For a multi-size suite, compile the blueprint separately for each target ratio or dimension. Keep the content, metaphor, style identity, material, and palette consistent, but rewrite composition, scale, typography, whitespace, reading direction, and spatial behavior for each target.
  6. Save files before image generation:

    • For a single image, create punk-assets/punk-cover/{slug}/prompts/cover.md with the complete filled prompt.
    • For an explicitly requested multi-size suite, instead create one file per target as punk-assets/punk-cover/{slug}/prompts/cover-{ratio-or-size}.md, using filesystem-safe ratio or size labels.
    • For a single image, if image generation returns an explicit local file path, downloadable URL, or image bytes for the current run, save that artifact as punk-assets/punk-cover/{slug}/cover.png.
    • Do not infer the correct artifact by scanning broad generated-image directories, because those directories may contain unrelated images from other runs.
    • If the image-generation tool only returns an inline preview with no explicit retrievable artifact for the current run, do not create a fake cover.png.
    • For a multi-size suite, save each explicitly retrievable artifact as punk-assets/punk-cover/{slug}/cover-{ratio-or-size}.png; never combine the suite into a contact sheet unless the user separately requests one.
  7. Generate an image by default after saving the prompt when a usable image-generation tool is available, such as image_gen. Generate one independent image per target when the user explicitly requests a multi-size suite; otherwise generate one image. Treat inline preview generation as successful image generation, but treat local image saving as successful only when the tool explicitly exposes a current-run artifact. Skip image generation only when the user explicitly asks for prompt-only output or the current environment has no image-generation tool. If image generation is unavailable, return the prompt file path and the full prompt content.

First Response Format

For article-only input with no platform and no style, ask concisely in the active language mode:

  1. Which platform/aspect ratio should this cover target?
    • Show the localized platform menu from references/platform-catalog.md.
    • Make clear that unsupported requests such as X 5:2 and WeChat 2.35:1 can only use the closest supported ratio (21:9), which will be applied automatically.
  2. Recommended styles:
    • Style A: reason tied to the article.
    • Style B: reason tied to the article.
    • Style C: reason tied to the article.

End by asking the user to choose a platform and one style, or to say auto if they want the skill to decide everything. They may also choose 中文, English, or 中英双语 as the language mode.

Style Selection Heuristics

  • Use styles whose outputs metadata contains cover or poster.
  • Use OSB 工业蓝线条隐喻 when the visual direction requires a full-bleed authentic OSB board, upper-left matte industrial-blue signage, one lower-right continuous-line metaphor, and more negative space than text and graphics combined.
  • Use Godot 2D 像素隐喻海报 when a theme should become one playable-feeling pixel-art level, one game mechanic, one character action, and one symbolic goal or obstacle rather than a literal illustration or pixel-filtered image.
  • Use 立体纸雕概念海报 when one relationship, tension, or transformation should become a physically believable layered-paper metaphor with generous negative space, soft studio shadows, and typography integrated into the paper structure.
  • Use 纸面击凸压凹封面 when the cover should feel like an art-book or independent-magazine surface: authentic paper fiber, letterpress-like emboss and deboss, editorial type as composition, one restrained relief metaphor, and large negative space.
  • Use 黑白复古蚀刻版画封面 when the cover should use strict black-and-white engraving, dense hatching and stippling, antique scientific-illustration detail, and one conceptual or surreal editorial metaphor.
  • Use 超大标题图文穿插 when the title should become part of the composition through a single central subject, explicit front/back typography layers, controlled occlusion, and strong editorial-poster impact across custom ratios.
  • Use business/report styles for strategy, product, AI, startup, industry, consulting, or analysis content.
  • Use 复古时代错位编辑封面 for AI, coding, digital work, future tools, or contemporary topics that benefit from a human-centered mid-century illustration and one restrained era-displacement metaphor.
  • Use 复古未来主义 for AI, automation, information overload, knowledge flow, archives, infrastructure, future cities, or system-change topics that benefit from one monumental analog process, physical information flow, and small human actions.
  • Use journal/concept styles for science, research, medicine, engineering, or mechanism-heavy content.
  • Use collage, giant-title, block, brick, or diffuse styles for social posts that need stronger shareability.
  • Use black-white minimal or avant-geometry styles for abstract, philosophical, critical, or high-contrast editorial themes.
  • Do not recommend styles whose metadata is avatar-only, portrait-only, pet-only, polaroid-only, or image-only unless they also declare cover or poster.

Cover Prompt Blueprint

Use references/cover-prompt-blueprint.md as the full prompt structure. The block below is retained only as the required task-field content that must be represented inside the integrated final prompt.

# punk-cover cover task instructions

Create one single cover image for {platform}. Requested aspect ratio:
{requested_ratio}. Generation aspect ratio: {generation_ratio}.
{ratio_resolution_notice}

Use the following derived content only:
- Title/topic: {title_or_topic}
- Optional subtitle: {subtitle}
- Language mode: {language_mode}
- Requested aspect ratio: {requested_ratio}
- Generation aspect ratio: {generation_ratio}
- Short context summary: {summary}
- Visual subject: {visual_subject}
- Audience: {audience}
- Mood: {mood}
- Visual metaphor: {metaphor}
- Banned elements: {banned_elements}

The main title must be complete, accurate, and clearly readable. If the source title is long, extract a short high-impact visual title while preserving the complete meaning through a smaller title, subtitle, or context line.

For long articles, use only derived fields such as title, summary, visual subject, metaphor, and supplemental context. Do not paste the original article body into the image, prompt, metadata, or small text system.

The cover must work for sharing: first glance identifies the topic, second glance reveals the visual metaphor. The image should feel like a deliberate editorial cover, not a generic illustration.

Avoid universal cover failures: PPT cover feel, course-cover feel, generic information-graphic template, e-commerce advertisement, unrelated decoration, misspelled title, missing title, title cropped beyond recognition, or title severely blocked by visual elements.

Generate only one final image per target ratio. For an explicitly requested multi-size suite, generate separate independently composed images rather than a grid or contact sheet. Do not output explanations, alternatives, or multi-option compositions.

Output Discipline

  • The final generated prompt must be one integrated cover-specific prompt compiled from the cover task fields, references/cover-prompt-blueprint.md, and exactly one selected style atom.
  • Do not paste the selected style STYLE.md as a standalone second section. Adapt its style atoms into the cover blueprint.
  • The final prompt must preserve the selected style's non-negotiable anchors from META.md and STYLE.md.
  • Do not copy long source text into the final prompt; use summaries and extracted fields.
  • Do not include style-selection rationale inside the prompt file.
  • Do not combine multiple styles.
  • Do not add a second custom style section beyond the selected style visual layer.
  • Do not expose non-cover styles in the style menu.
  • Default to one output. Only generate multiple images when the user explicitly requests a multi-size suite, and keep each ratio as a separate composition and artifact.

Signals

GitHub stars
1k
Forks
109
Last commit
Sep 2026

ahel review

  • K3info
    injection

Automated review, not a security audit. Ruleset v1+k2.

Advanced
Catalog kind
skill
Gateway key
punk-cover
Source
github.com/adrianpunk/punk-skill