task icon Task

Colorize Photo

Requirements
Absolute path to the black-and-white or faded photo to colorize. Optional: known era or decade, any context about subjects (e.g., military branch, location, occasion).
3

Analyze the provided photo to identify the likely era and context. Look for visual cues:

  • Clothing styles (collars, hemlines, silhouettes)
  • Hairstyles
  • Architecture visible
  • Vehicles or technology
  • Any military uniforms (identify nation and branch if possible)

If the user provided context about the era or subjects, incorporate that. If the era is unclear and context wasn't provided, describe what you observe and ask the user for clarification before proceeding.

4

Based on your era identification and the colorization guide, craft a detailed colorization prompt. Include:

  • The identified era and appropriate color palette
  • Specific colors for identifiable elements (military uniforms, common fashion items)
  • Guidance to maintain period-appropriate muted tones rather than over-saturated modern colors
  • Instructions to preserve the vintage photograph quality

Explain your color choices to the user before proceeding—they may have corrections or preferences.

6

Present the colorized result to the user. Note:

  • Where the colorized image was saved
  • The key color choices you made and why
  • Offer to adjust specific colors if they don't match the user's expectations or knowledge
  • Ask if they want a more saturated or more muted version
                    To run this task you must have the following required information:

> Absolute path to the black-and-white or faded photo to colorize. Optional: known era or decade, any context about subjects (e.g., military branch, location, occasion).

If you don't have all of this information, exit here and respond asking for any extra information you require, and instructions to run this task again with ALL required information.

---

You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple read steps in a row, read them all at once (in parallel).

Add all steps to your todo list now and begin executing.

## Steps

1. [Run Code: Verify Gemini Connection]: Call `run_script` with:

```json
{
  "file": {
    "path": https://sk.ills.app/code/media.gemini.verify/preview,
    "args": [

    ]
  },
  "packages": null
}
```

2. [Read Historical Photo Colorization Guide]: Read the documentation in: `./skills/sauna/[skill_id]/references/media.colorize.guide.md` (Historical accuracy guidance—era identification, military uniforms, fashion colors, common mistakes)

3. Analyze the provided photo to identify the likely era and context. Look for visual cues:
- Clothing styles (collars, hemlines, silhouettes)
- Hairstyles
- Architecture visible
- Vehicles or technology
- Any military uniforms (identify nation and branch if possible)

If the user provided context about the era or subjects, incorporate that. If the era is unclear and context wasn't provided, describe what you observe and ask the user for clarification before proceeding.


4. Based on your era identification and the colorization guide, craft a detailed colorization prompt. Include:
- The identified era and appropriate color palette
- Specific colors for identifiable elements (military uniforms, common fashion items)
- Guidance to maintain period-appropriate muted tones rather than over-saturated modern colors
- Instructions to preserve the vintage photograph quality

Explain your color choices to the user before proceeding—they may have corrections or preferences.


5. [Gather Arguments: Generate or Edit Image] The next step has the following requirements for arguments, do not proceed until you have all the required information:
- `prompt`: the colorization prompt you crafted
- `imagePath`: absolute path to the source photo from requirements
- `outputDir`: ./documents/colorized-photos/

6. [Run Code: Generate or Edit Image]: Call `run_script` with:

```json
{
  "file": {
    "path": https://sk.ills.app/code/media.image.generate/preview,
    "args": [
      "prompt",
      "imagePath",
      "outputDir"
    ]
  },
  "packages": null
}
```

7. Present the colorized result to the user. Note:
- Where the colorized image was saved
- The key color choices you made and why
- Offer to adjust specific colors if they don't match the user's expectations or knowledge
- Ask if they want a more saturated or more muted version