add-swag-item

name	add-swag-item
description	Add a newly dropped `.webp` swag image to this portfolio's existing swag collection by gathering the required metadata, renaming the asset to the next numeric filename, and updating `src/assets/swag/swag.ts`. Use when the user wants to add a new swag item, mentions a dropped swag image, or asks to update the swag collection in this repository.

Add Swag Item

Add swag items to the existing collection in src/assets/swag.

Keep the current data model unchanged: each swag item needs label and may include caption. Do not invent new fields or refactor the collection structure.

Workflow

1. Inspect src/assets/swag/swag.ts and src/assets/swag/*.webp only if you need to confirm the current numbering or file layout.
2. Determine the source image:
   • If the user already gave a path to the new .webp, use it.
   • Otherwise, look for exactly one newly dropped non-numeric .webp inside src/assets/swag.
   • If there is no clear source image, ask for the path.
3. Collect missing metadata:
   • Ask for label if it was not already provided.
   • Ask for caption only if it was not already provided, and allow the user to skip it.
4. Run scripts/add_swag_item.py with the repo root, source image path, label, and optional caption.
5. Review the diff to confirm:
   • the image was renamed to the next numeric filename such as 100.webp
   • a matching import swag100 from "./100.webp"; line was added
   • a matching object was appended to the swags array
6. Report the new numeric filename and summarize the metadata that was added.

Ask Rules

• Ask only for information that is actually missing.
• Keep questions minimal and direct.
• Do not ask for filename or numbering preferences; the filename is always the next integer.
• If multiple possible source images exist, present the candidate paths and ask the user which one to ingest.

Command

From the repo root, run:

python3 agents/skills/add-swag-item/scripts/add_swag_item.py \
  --repo-root "$PWD" \
  --source "/absolute/path/to/new.webp" \
  --label "Swag label" \
  --caption "Optional caption"

Omit --caption when the user skips it.

If the user did not provide --source, the script may be run without it only when there is exactly one non-numeric .webp already inside src/assets/swag.

Guardrails

• Do not reorder existing swag entries.
• Do not change existing labels or captions unless the user explicitly asks.
• Do not overwrite an existing numeric image.
• Do not convert image formats; this workflow is only for .webp.
• Fail clearly when swag.ts does not match the expected import-array-export structure.

Resource

scripts/add_swag_item.py performs the rename/move and updates src/assets/swag/swag.ts.