Punk Avatar

---
name: punk-avatar
description: Generate avatar images and reusable avatar image prompts from the shared Punk style library for people, pets, objects, profile pictures, pet portraits, and avatar-derived keepsake cards. Use this skill to identify the subject from image or text, choose one avatar-capable style, 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 five styles in the `punk-avatar` menu:
  - `pixel-avatar`
  - `grotesque-soul-sketch`
  - `messy-crayon-pet-portrait`
  - `fashion-sketch-observation`
  - `polaroid-keepsake`
- 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.
   - 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 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.

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.
   - 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 ratio: silently use `1:1`.
   - Known style: continue without asking.
   - If both style and subject are known enough to proceed, compile the prompt.

6. Compile the final image prompt:
   - Use `references/avatar-prompt-blueprint.md` as the required structure for `prompts/avatar.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`.
   - Extract the selected style's non-negotiable visual anchors: subject treatment, composition, background behavior, line or texture system, color logic, typography or handwritten behavior, likeness constraints, and negative constraints.
   - Fuse the avatar task fields and style anchors into one full avatar prompt. The final prompt should read like a complete avatar-generation brief, not like two unrelated prompt fragments pasted together.
   - Include avatar-shape sections for role/task, input fields, source interpretation, subject identity, likeness policy, avatar composition, crop safety, background, style application, color/material/texture, optional text/name handling, negative constraints, and final standard.
   - Do not append the raw `STYLE.md` content as a standalone second section. Rewrite and adapt its style atoms into the avatar blueprint.
   - Do not combine multiple styles or add a second custom style section.
   - Replace or resolve all explicit placeholders from the selected style file.
   - For image-based inputs, preserve recognizable subject identity without creating a photorealistic copy unless the selected style requires realistic structure.
   - For text-only fictional avatars, say the image should follow the description and avoid claims such as "preserve photo likeness".
   - Do not bring cover-title hierarchy, article summaries, platform propagation rules, or social-cover composition into the avatar prompt.
   - Do not output analysis inside the final prompt.

7. Save files before image generation:
   - Create `punk-assets/punk-avatar/{slug}/prompts/avatar.md` with the complete filled prompt.
   - 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-avatar/{slug}/avatar.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 `avatar.png`.

8. Generate an image by default after saving the prompt when a usable image-generation tool is available, such as `image_gen`. Treat inline preview generation as successful image generation, but treat local `avatar.png` 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 input with no style, ask concisely:

```text
默认画幅：1:1。

请选择一个头像风格：
- `风格 A`：reason tied to the subject.
- `风格 B`：reason tied to the subject.
- `风格 C`：reason tied to the subject.

也可以回复 "auto" 让我自动选择。
```

Do not ask for ratio unless the user explicitly wants ratio options.

## Style Selection Heuristics

- Use `pixel-avatar` for people, pets, objects, symbolic avatars, icon-like profile pictures, and unclear subjects.
- Use `grotesque-soul-sketch` for people or pets that should feel expressive, funny, sketchy, and personality-driven.
- Use `messy-crayon-pet-portrait` only for pets and pet portrait avatars.
- Use `fashion-sketch-observation` only for people, especially fashion, travel, street-photo, film-still, or editorial personal portraits.
- Use `polaroid-keepsake` only for pets, especially memorial, collectible, named pet cards, and avatar-derived keepsake cards.

## Avatar Prompt Blueprint

Use `references/avatar-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.

```text
# punk-avatar task instructions

Create one single avatar image. Aspect ratio: {ratio}.

Use the following derived subject fields only:
- Subject type: {subject_type}
- Generation mode: {image_based_or_description_based}
- Subject identity: {subject_identity}
- Recognizable traits: {recognizable_traits}
- Name or text to include: {name_or_text}
- Intended use: {use_case}
- Background preference: {background_preference}
- Mood: {mood}
- Preserve: {preserve}
- Avoid: {avoid}

For image-based inputs, preserve the subject's most recognizable traits while translating them into the selected style. Do not claim exact biometric identity or photorealistic duplication.

For description-based inputs, create a fictional avatar from the description. Do not write that it preserves photo likeness.

The avatar must work as a profile image: readable at small size, centered or deliberately framed, clear silhouette, no important facial features or subject marks cropped out, simplified background, and one final output.

Generate only one final image. Do not output explanations, alternatives, grids, contact sheets, or multi-option compositions.
```

## Output Discipline

- The final generated prompt must be one integrated avatar-specific prompt compiled from the avatar task fields, `references/avatar-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 avatar blueprint.
- The final prompt must preserve the selected style's non-negotiable anchors from `META.md` and `STYLE.md`.
- Do not copy unrelated user text into the final prompt; use concise derived subject fields.
- Do not include style-selection rationale inside the prompt file.
- Do not combine multiple styles.
- Do not add cover/poster title hierarchy, article summary, or platform cover rules.