Tuzi Cover Image

Generates article cover images with 5 dimensions (type, palette, rendering, text, mood) combining 9 color palettes and 6 rendering styles. Supports cinematic...

Security Scan

The skill's behavior mostly matches a cover-image generator, but its runtime instructions require reading/writing user files (project and $HOME EXTEND.md) and enforce a blocking first-time setup even though the registry metadata declares no config paths — this mismatch and the aggressive 'MUST incorporate' reference-handling are worth caution.

Purpose & Capability

The skill name/description describe an image-cover generator and the instructions implement that. However the SKILL metadata claims no required config paths or credentials while the runtime docs explicitly read and write EXTEND.md in either the project (./.tuzi-skills/tuzi-cover-image/EXTEND.md) or the user's home (~/.tuzi-skills/tuzi-cover-image/EXTEND.md). That filesystem access (and the explicit blocking setup) should have been declared in registry metadata; the mismatch is incoherent and surprising.

Instruction Scope

SKILL.md instructs the agent to run shell checks (test -f ...) and to create directories and write EXTEND.md, save source and reference images to disk, and write prompt files (prompts/cover.md). It also instructs very prescriptive handling of reference images — extracting exact colors, logos and 'MUST' reproducible elements — which can enable replication of copyrighted or sensitive visual assets. All of these file reads/writes and the blocking-first-time-setup step extend beyond a simple 'generate' prompt and should be highlighted to the user.

Install Mechanism

This is an instruction-only skill with no install spec and no code files, which is lowest install risk — nothing is downloaded or executed by an installer. The runtime behavior relies on the agent's ability to read/write files and use whatever toolchain the agent has.

Credentials

The skill declares no environment variables or credentials, which matches the lack of network/service integrations. However it does implicitly require access to the filesystem (project dir and $HOME) to store preferences and outputs; those config paths are not declared in the metadata and therefore the registry info understates the skill's access needs.

Persistence & Privilege

always:false (good) and the skill does not request elevated platform privileges, but it mandates creating persistent config files (EXTEND.md) and output directories and blocks other operations until setup completes. This persistent footprint is normal for tools that save preferences, but the blocking behavior and default option to save to the user home may be surprising and should be made explicit to the user before install/run.

What to consider before installing

Before installing or invoking this skill: (1) Be aware it will read/write a preferences file at either .tuzi-skills/tuzi-cover-image/EXTEND.md in your project or ~/.tuzi-skills/tuzi-cover-image/EXTEND.md in your home and will create output and refs/ directories — the registry metadata did not list these config paths. (2) The first-time setup is blocking and must complete before the skill analyzes content; if you prefer no global files, choose the 'Project' save location during setup or inspect the EXTEND.md content after creation. (3) Avoid providing reference images that contain copyrighted logos, private or sensitive visuals if you don't want the skill to reproduce them — the instructions explicitly push for exact, 'MUST' reproduction of reference elements and exact color values. (4) Because this is an instruction-only skill, confirm what agent tooling will perform filesystem writes (the skill's instructions assume the agent can run shell/file operations). If you need the skill to be less persistent or less invasive, ask the owner to (a) declare required config paths in metadata, (b) make the first-time setup optional or non-blocking, and (c) reduce the 'MUST' reproduction language for reference handling.

Cover Image Generator

Generate elegant cover images for articles with 5-dimensional customization.

Usage

# Auto-select dimensions based on content
/tuzi-cover-image path/to/article.md

# Quick mode: skip confirmation
/tuzi-cover-image article.md --quick

# Specify dimensions
/tuzi-cover-image article.md --type conceptual --palette warm --rendering flat-vector

# Style presets (shorthand for palette + rendering)
/tuzi-cover-image article.md --style blueprint

# With reference images
/tuzi-cover-image article.md --ref style-ref.png

# Direct content input
/tuzi-cover-image --palette mono --aspect 1:1 --quick
[paste content]

Options

Option	Description
--type <name>	hero, conceptual, typography, metaphor, scene, minimal
--palette <name>	warm, elegant, cool, dark, earth, vivid, pastel, mono, retro
--rendering <name>	flat-vector, hand-drawn, painterly, digital, pixel, chalk
--style <name>	Preset shorthand (see Style Presets)
--text <level>	none, title-only, title-subtitle, text-rich
--mood <level>	subtle, balanced, bold
--font <name>	clean, handwritten, serif, display
--aspect <ratio>	16:9 (default), 2.35:1, 4:3, 3:2, 1:1, 3:4
--lang <code>	Title language (en, zh, ja, etc.)
--no-title	Alias for --text none
--quick	Skip confirmation, use auto-selection
--ref <files...>	Reference images for style/composition guidance

Five Dimensions

Dimension	Values	Default
Type	hero, conceptual, typography, metaphor, scene, minimal	auto
Palette	warm, elegant, cool, dark, earth, vivid, pastel, mono, retro	auto
Rendering	flat-vector, hand-drawn, painterly, digital, pixel, chalk	auto
Text	none, title-only, title-subtitle, text-rich	title-only
Mood	subtle, balanced, bold	balanced
Font	clean, handwritten, serif, display	clean

Auto-selection rules: references/auto-selection.md

Galleries

Types: hero, conceptual, typography, metaphor, scene, minimal → Details: references/types.md

Palettes: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro → Details: references/palettes/

Renderings: flat-vector, hand-drawn, painterly, digital, pixel, chalk → Details: references/renderings/

Text Levels: none (pure visual) | title-only (default) | title-subtitle | text-rich (with tags) → Details: references/dimensions/text.md

Mood Levels: subtle (low contrast) | balanced (default) | bold (high contrast) → Details: references/dimensions/mood.md

Fonts: clean (sans-serif) | handwritten | serif | display (bold decorative) → Details: references/dimensions/font.md

File Structure

Output directory per default_output_dir preference:

• same-dir: {article-dir}/
• imgs-subdir: {article-dir}/imgs/
• independent (default): cover-image/{topic-slug}/

<output-dir>/
├── source-{slug}.{ext}    # Source files
├── refs/                  # Reference images (if provided)
│   ├── ref-01-{slug}.{ext}
│   └── ref-01-{slug}.md   # Description file
├── prompts/cover.md       # Generation prompt
└── cover.png              # Output image

Slug: 2-4 words, kebab-case. Conflict: append -YYYYMMDD-HHMMSS

Workflow

Progress Checklist

Cover Image Progress:
- [ ] Step 0: Check preferences (EXTEND.md) ⛔ BLOCKING
- [ ] Step 1: Analyze content + save refs + determine output dir
- [ ] Step 2: Confirm options (6 dimensions) ⚠️ unless --quick
- [ ] Step 3: Create prompt
- [ ] Step 4: Generate image
- [ ] Step 5: Completion report

Flow

Input → [Step 0: Preferences] ─┬─ Found → Continue
                               └─ Not found → First-Time Setup ⛔ BLOCKING → Save EXTEND.md → Continue
        ↓
Analyze + Save Refs → [Output Dir] → [Confirm: 6 Dimensions] → Prompt → Generate → Complete
                                              ↓
                                     (skip if --quick or all specified)

Step 0: Load Preferences ⛔ BLOCKING

Check EXTEND.md existence (priority: project → user):

test -f .tuzi-skills/tuzi-cover-image/EXTEND.md && echo "project"
test -f "$HOME/.tuzi-skills/tuzi-cover-image/EXTEND.md" && echo "user"

Result	Action
Found	Load, display summary → Continue
Not found	⛔ Run first-time setup (references/config/first-time-setup.md) → Save → Continue

CRITICAL: If not found, complete setup BEFORE any other steps or questions.

Step 1: Analyze Content

1. Save reference images (if provided) → references/workflow/reference-images.md
2. Save source content (if pasted, save to source.md)
3. Analyze content: topic, tone, keywords, visual metaphors
4. Deep analyze references ⚠️: Extract specific, concrete elements (see reference-images.md)
5. Detect language: Compare source, user input, EXTEND.md preference
6. Determine output directory: Per File Structure rules

Step 2: Confirm Options ⚠️

Full confirmation flow: references/workflow/confirm-options.md

Condition	Skipped	Still Asked
--quick or quick_mode: true	6 dimensions	Aspect ratio (unless --aspect)
All 6 + --aspect specified	All	None

Step 3: Create Prompt

Save to prompts/cover.md. Template: references/workflow/prompt-template.md

CRITICAL - References in Frontmatter:

• Files saved to refs/ → Add to frontmatter references list
• Style extracted verbally (no file) → Omit references, describe in body
• Before writing → Verify: test -f refs/ref-NN-{slug}.{ext}

Reference elements in body MUST be detailed, prefixed with "MUST"/"REQUIRED", with integration approach.

Step 4: Generate Image

1. Backup existing cover.png if regenerating
2. Check image generation skills; if multiple, ask preference
3. Process references from prompt frontmatter:
   • direct usage → pass via --ref (use ref-capable backend)
   • style/palette → extract traits, append to prompt
4. Generate: Call skill with prompt file, output path, aspect ratio
5. On failure: auto-retry once

Step 5: Completion Report

Cover Generated!

Topic: [topic]
Type: [type] | Palette: [palette] | Rendering: [rendering]
Text: [text] | Mood: [mood] | Font: [font] | Aspect: [ratio]
Title: [title or "visual only"]
Language: [lang] | Watermark: [enabled/disabled]
References: [N images or "extracted style" or "none"]
Location: [directory path]

Files:
✓ source-{slug}.{ext}
✓ prompts/cover.md
✓ cover.png

Image Modification

Action	Steps
Regenerate	Backup → Update prompt file FIRST → Regenerate
Change dimension	Backup → Confirm new value → Update prompt → Regenerate

Composition Principles

• Whitespace: 40-60% breathing room
• Visual anchor: Main element centered or offset left
• Characters: Simplified silhouettes; NO realistic humans
• Title: Use exact title from user/source; never invent

Extension Support

Custom configurations via EXTEND.md. See Step 0 for paths.

Supports: Watermark | Preferred dimensions | Default aspect/output | Quick mode | Custom palettes | Language

Schema: references/config/preferences-schema.md

References

Dimensions: text.md | mood.md | font.md Palettes: references/palettes/ Renderings: references/renderings/ Types: references/types.md Auto-Selection: references/auto-selection.md Style Presets: references/style-presets.md Compatibility: references/compatibility.md Visual Elements: references/visual-elements.md Workflow: confirm-options.md | prompt-template.md | reference-images.md Config: preferences-schema.md | first-time-setup.md | watermark-guide.md