task icon Task

Create Trading Card

Requirements
Subject description or photo, name, stats/achievements, team colors.
Instructions
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).
2

Gather trading card details from the user: (1) Subject - who is on the card? If they have a photo to transform, get the path. Otherwise get a description of the person/character. (2) Name to display on the card header. (3) Sport or game type. (4) Team colors (primary and accent). (5) 3-5 stats or achievements to show. (6) Jersey/player number if applicable. (7) Rarity level: standard, premium, or legendary.

5

Craft a detailed prompt for the trading card with ALL text spelled out. The prompt MUST include: (1) The exact name text for the header, e.g. 'JAMES MILLER' in bold. (2) Each stat with its exact value, e.g. 'PTS 28.4 / AST 8.2 / REB 7.1'. (3) Team colors, border style for rarity, holographic effects. Write every piece of text that should appear on the card - the AI needs exact strings to render.

7

Tell the user where their trading card was saved. Offer to create variations (different pose, alternate colorway, different rarity border) or generate cards for additional players/characters.

                    To run this task you must have the following required information:

> Subject description or photo, name, stats/achievements, team colors.

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. Gather trading card details from the user: (1) Subject - who is on the card? If they have a photo to transform, get the path. Otherwise get a description of the person/character. (2) Name to display on the card header. (3) Sport or game type. (4) Team colors (primary and accent). (5) 3-5 stats or achievements to show. (6) Jersey/player number if applicable. (7) Rarity level: standard, premium, or legendary.

3. [Read Trading Card Style Guide]: Read the documentation in: `./skills/sauna/[skill_id]/references/media.tradingcard.style.md` (Load trading card design guidance)

4. [Read Image Prompting Guide]: Read the documentation in: `./skills/sauna/[skill_id]/references/media.image.prompts.md` (General image generation patterns)

5. Craft a detailed prompt for the trading card with ALL text spelled out. The prompt MUST include: (1) The exact name text for the header, e.g. 'JAMES MILLER' in bold. (2) Each stat with its exact value, e.g. 'PTS 28.4 / AST 8.2 / REB 7.1'. (3) Team colors, border style for rarity, holographic effects. Write every piece of text that should appear on the card - the AI needs exact strings to render.

6. [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 trading card prompt
- `imagePath`: absolute path to source photo if provided, otherwise empty string for generation
- `outputDir`: ./documents/trading-cards/*

7. [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
}
```

8. Tell the user where their trading card was saved. Offer to create variations (different pose, alternate colorway, different rarity border) or generate cards for additional players/characters.