alano-mascot

name	alano-mascot
description	Create consistent Alano mascot stills, badges, transparent cutouts, and loopable videos from canonical reference art. Use when adding Alano to a product, choosing an Alano pose or mood, generating on-brand Alano art with Seedream or Seedance, removing flat backgrounds, or preparing mascot media for web and apps.

Alano Mascot

Use this suite to produce Alano artwork without character drift. Every generation must stay anchored to bundled canonical reference images and fixed brand rules.

Locate this skill

Resolve SKILL_DIR as the directory containing this SKILL.md. All references/, scripts/, and assets/ paths below are relative to SKILL_DIR. Run scripts from the user's project root so generated files land under that project's output/ directory.

Route the request

1. Read references/brand.md before any visual generation.
2. Then read only the relevant workflow:
   • Still, pose, costume, badge, or icon: references/image-generation.md
   • Animation or raw video clip: references/video-generation.md
   • Square crop, seamless loop, poster, compression, or manifest: references/video-postprocess.md
   • Transparent still or background removal: references/cutout.md
3. Use bundled scripts rather than recreating API or post-processing logic.

Core commands

From project root, replace <SKILL_DIR> with resolved absolute path:

# Generate selected stills or badges.
SEEDANCE_API_KEY="<runtime key>" \
SEEDREAM_ONLY="wave" \
node <SKILL_DIR>/scripts/generate-alano-images.mjs

# Generate selected raw clips.
SEEDANCE_API_KEY="<runtime key>" \
SEEDANCE_ONLY="idle" \
node <SKILL_DIR>/scripts/generate-alano-videos.mjs

# Finish raw clips already in output/video/raw/.
node <SKILL_DIR>/scripts/postprocess-alano-clips.mjs idle

# Produce transparent WebP from a flat-background still.
python3 <SKILL_DIR>/scripts/cutout_alano.py output/stills/wave.png

Set ALANO_OUTPUT_DIR=/absolute/path to override default output root ($PWD/output).

Requirements

• Node.js 18+ for generation and video post-processing scripts.
• Python 3.9+, Pillow, and NumPy for cutouts.
• ffmpeg on PATH for video finishing.
• BytePlus Ark access for generation; inject SEEDANCE_API_KEY only at runtime.

Non-negotiable rules

• Never generate without bundled canonical reference image.
• Never store, print, or commit API keys.
• Never freestyle Alano's character design or canonical style string.
• Never ask image model to render final text; composite real text locally.
• Keep generated masters under user's output/; do not overwrite bundled assets.
• Treat assets/ as Alano-owned brand material governed by ASSET_LICENSE.md, not MIT code.

Deliverables

• Stills and badges: PNG masters under output/stills/ or output/badges/.
• Transparent cutouts: trimmed RGBA WebP beside source image.
• Raw clips: MP4 under output/video/raw/.
• Finished clips: 480×480 H.264 MP4, WebP poster, and clips.json under output/video/.