Imagery: Visual Asset Lifecycle

Skill-local scripts (scripts/provider.py, scripts/*.sh) are stdlib-only and run base-directory-relative with python3 (py -3 on Windows).

Manage the full lifecycle of visual assets through three specialized sub-skills. Each sub-skill handles a distinct phase of creative work, from analysis through generation to iterative refinement.

Sub-Skills

When To Use Each

• "What is in this image?" — review
• "Generate a new image of..." — create
• "Change this image to..." — alter
• "Is this image ready for production?" — review (quality gates)
• "Make the sky more dramatic" — alter (img2img or inpainting)

The Creative Loop: Analyze-Execute-Review-Refine

Every visual task follows this iterative cycle until the output matches requirements:

┌─────────┐     ┌─────────┐     ┌─────────┐     ┌─────────┐
│ ANALYZE │────>│ EXECUTE │────>│ REVIEW  │────>│ REFINE  │
│ (review)│     │(create/ │     │(review) │     │ (alter) │
│         │     │ alter)  │     │         │     │         │
└─────────┘     └─────────┘     └─────────┘     └────┬────┘
     ^                                                │
     └────────────────────────────────────────────────┘

1. Analyze — Understand the visual context, reference images, or requirements (review sub-skill)
2. Execute — Generate new assets (create) or modify existing ones (alter)
3. Review — Run quality gates: brand, accessibility, production, sensitivity (review sub-skill)
4. Refine — Adjust prompts, parameters, or masks based on review findings (alter sub-skill)

Provider Status

The imagery skill uses a provider abstraction layer. Review works without any provider. Create and alter require at least one:

# Check available providers
python3 scripts/provider.py detect

Quick Start

Analyze an existing image

Read the image file → apply review sub-skill analysis lenses

Generate a new image

Describe requirements → create sub-skill generates → review sub-skill validates

Modify an existing image

Review identifies issues → alter sub-skill applies changes → review validates

Reference Map

Review References

• review/refs/analysis-lenses.md — Four analysis lenses (general, technical, style, layout)
• review/refs/quality-gates.md — Four quality gates (brand, a11y, production, sensitivity)

Create References

• create/refs/provider-reference.md — Provider APIs and configuration
• create/refs/prompt-engineering.md — Crafting effective prompts

Alter References

• alter/refs/editing-reference.md — Modification patterns, provider commands, refinement strategies