sn-image-resume

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: sn-image-resume
description: |
  Generates a designed portfolio-resume image from resume content provided in conversation text.
  Extracts optional style instructions, converts the resume into a fixed portfolio-resume layout prompt,
  and generates the final image through sn-image-base. Use when user asks to create "resume image",
  "portfolio resume", "简历图", "简历海报", or "个人简历视觉设计".
metadata:
  project: SenseNova-Skills
  tier: 1
  category: scene
  priority: 8
  user_visible: true
triggers:
  - "resume image"
  - "portfolio resume"
  - "visual resume"
  - "resume poster"
  - "CV image"
  - "简历图"
  - "简历海报"
  - "可视化简历"
  - "个人简历视觉设计"
  - "作品集简历"
---

# sn-image-resume

Resume image generation scene skill (tier 1), relying on the `sn-text-optimize` and `sn-image-generate` tools provided by `sn-image-base` (tier 0).

Features:

- Accepts resume content directly from conversational text
- Supports optional user-provided style direction
- Applies the fixed portfolio-resume layout rules in `prompts/resume.md`
- Generates a tall designed resume image through `sn-image-generate`

## Non-goals

- Editing or polishing a plain text resume document without generating an image
- Parsing uploaded resume files as the primary input format
- Creating a conventional single-column ATS resume
- Guaranteeing exact preservation of every long paragraph when the image layout requires compression

## Input Specification

|Parameter|Type|Default Value|Description|
|---|---|---|---|
|`resume_content`|string|**Required**|Resume text provided by the user in conversation, including name, profile, education, experience, skills, projects, contact details, etc.|
|`style`|string|Optional|User-specified visual style, tone, color palette, profession aesthetic, or reference mood. May be embedded in `resume_content`.|
|`aspect_ratio`|string|`9:16`|Output aspect ratio. Allowed values: `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `1:1`, `16:9`, `9:16`, `21:9`, `9:21`. Default is `9:16` (vertical) because the template is a tall stacked portfolio-resume page.|
|`image_size`|string|`2k`|Image size preset, `1k` or `2k`.|
|`output_mode`|string|`friendly`|Output mode: `friendly` or `verbose`.|

## API Configuration

All API calls in this skill are executed through the `sn_agent_runner.py` of the `sn-image-base` skill, with authentication parameters using default values (CLI > environment variables > built-in defaults), so they do not need to be passed explicitly in normal use.

|Call Type|Tool|Authentication Parameters|Description|
|---|---|---|---|
|**LLM**|`sn-text-optimize`|Default reads `SN_TEXT_API_KEY` -> `SN_CHAT_API_KEY` -> `SN_API_KEY`|Converts user resume text into a detailed image generation prompt using `prompts/resume.md` as the system prompt|
|**Image Generation**|`sn-image-generate`|Default reads `SN_IMAGE_GEN_API_KEY` -> `SN_API_KEY`|Generates the final resume image|

If all capabilities use the same gateway, configure only:

```ini
SN_BASE_URL="https://your-api-endpoint.com/v1"
SN_API_KEY="your-api-key"
```

**When encountering `MissingApiKeyError` or needing to specify a model**: pass parameters explicitly via CLI. See `$SN_IMAGE_BASE/references/api_spec.md`.

**`$SN_IMAGE_BASE` path explanation**: `$SN_IMAGE_BASE` is the installation directory of the `sn-image-base` skill (`SKILL.md` exists). The agent can locate this path by skill name `sn-image-base`.

## Architecture: Main Agent + Worker Agent

This skill uses a two-tier agent architecture:

|Role|Responsibility|
|---|---|
|**Main Agent**|Receive user request, normalize parameters, send preflight, start Worker, collect result, and send final text/image to user|
|**Worker Agent**|Execute prompt generation and image generation, then return structured JSON|

**Responsibility Boundaries**:

- Worker Agent **does not send any messages to the user directly**, only returns structured JSON
- Main Agent is responsible for all user-visible messages
- Worker Agent's last message **must be and only be** t