/punk-avatar

name: punk-avatar
description: Generate avatar images, surreal paper-art portraits, and reusable image prompts from the shared Punk style library for people, pets, objects, profile pictures, pet portraits, and keepsake cards. Use this skill to identify the subject from image or text, choose one avatar-capable style and any required style mode, compile the selected style atom into the avatar blueprint, save the final prompt, and generate the image when an image-generation tool is available.

Punk Avatar

Core Rule

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

The final image prompt is not a loose concatenation of "avatar instructions + style instructions". It must be one integrated, avatar-specific prompt that applies the selected style to a profile image, portrait avatar, object avatar, pet avatar, or avatar-derived keepsake card.

Use three inputs:

1. `punk-avatar` task fields: subject type, source image or text description, intended use, likeness policy, avatar composition, aspect ratio, background simplification, crop safety, and universal output constraints. 2. The selected style's `META.md` metadata and `STYLE.md` reusable visual style atom. 3. `references/avatar-prompt-blueprint.md`, which defines the full avatar prompt shape.

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

Resources

• Read `references/style-catalog.md` to list or choose avatar styles.
• Read `references/avatar-prompt-blueprint.md` before composing the final prompt.
• For the selected style, read both:
• `../../styles/{style-id}/META.md`
• `../../styles/{style-id}/STYLE.md`
• Expose only these seven styles in the `punk-avatar` menu:
• `pixel-avatar`
• `grotesque-soul-sketch`
• `messy-crayon-pet-portrait`
• `fashion-sketch-observation`
• `polaroid-keepsake`
• `minimal-paper-acrylic-block-illustration`
• `surreal-pop-up-paper-landscape`
• `surreal-pop-up-paper-landscape` has two output modes. After reading its `META.md` and `STYLE.md`, read exactly one mode reference selected by the user:
• `../../styles/surreal-pop-up-paper-landscape/references/before-after.md`
• `../../styles/surreal-pop-up-paper-landscape/references/final-artwork.md`
• Do not expose cover/poster styles in the `punk-avatar` menu.
• Do not read `punk-cover` references or templates for avatar runs.

Workflow

1. Analyze the source material:

• If the user provides one or more images, treat image input as primary.
• Identify the main subject type: `person`, `pet`, `object`, or `unclear`.
• Extract only concise visual traits needed for an avatar: face/head shape, hair or fur, eyes, expression, posture, signature colors, clothing, accessories, object silhouette, and any must-preserve marks.
• Use text as supplemental context: name, temperament, intended use, preferred background color, elements to preserve, and elements to avoid.
• If there is no image and the user describes a fictional avatar, handle it as description-based generation. Do not promise likeness to a real photo.

2. Resolve aspect ratio:

• Default ratio is always `1:1` inside `punk-avatar`.
• If the user specifies `3:4`, `4:5`, `16:9`, or any custom ratio, keep the user's ratio exactly.
• Do not use the selected style metadata's `default_ratio` as the avatar default.
• For `polaroid-keepsake`, default to `1:1` in `punk-avatar`; only generate a vertical polaroid card when the user explicitly asks for a vertical ratio.
• For `surreal-pop-up-paper-landscape`, use `3:2` for `before-after` mode and `3:4` for `final-artwork` mode when the user omits the ratio. Keep any user-specified ratio exactly.
• Do not ask a ratio question when the user omits ratio.

3. Confirm style before generating any prompt:

• If the user specifies one catalog style, use it.
• If the user supplies a complete visual direction that matches a catalog style, including the `极简纸感丙烯色块插画` or `立体人物扁平景色纸艺` brief, treat that style as specified and use its style atom without asking the user to repeat the style.
• If no style is specified, recommend 2-3 eligible styles based on the subject type and ask the user to choose one.
• When style is missing, stop after asking. Do not fill a style file, save prompt files, or generate an image.
• Only auto-select one style when the user explicitly says to decide everything automatically.
• For `surreal-pop-up-paper-landscape`, also resolve the output mode. Map requests for `前后对比图`, `对比图`, `before/after`, or `comparison` to `before-after`; map `效果图`, `单张效果图`, `成品图`, `final artwork`, or `single image` to `final-artwork`.
• If the user selects `surreal-pop-up-paper-landscape` but gives no mode, ask only which of the two modes to use and stop. Do not generate both unless the user explicitly requests both.

4. Recommendation rules:

• Pet subject: recommend `凌乱蜡笔宠物肖像`, `拍立得纪念卡`, and `怪诞灵魂手绘`; include `像素头像` when a more icon-like avatar may fit.
• Person subject: recommend `怪诞灵魂手绘`, `时尚速写观察页`, and `像素头像`.
• Object subject or unclear subject: recommend `像素头像` first.
• A photo or theme that needs a small symbolic subject, rough white paper, clear acrylic blocks, and large negative space: recommend `极简纸感丙烯色块插画`.
• A person photo with a recognizable surrounding scene that should become a photorealistic upright figure emerging from a flattened paper landscape: recommend `立体人物扁平景色纸艺`.
• Do not recommend `messy-crayon-pet-portrait` for people.
• Do not recommend `fashion-sketch-observation` for pets or objects unless the user explicitly asks for that style.
• Do not recommend `polaroid-keepsake` for people or objects.

5. Use this confirmation gate:

• Missing style: ask for style choice and stop.
• Missing r