Our review

Generates a self-contained HTML file with a swinging spotlight animation that reveals text.

Strengths

Fully customizable parameters (text, angle, speed, colors).
Self-contained single HTML file.
Supports transparent background.
Easy to use via command line.

Limitations

Output is HTML only, no video or GIF directly.
Requires Python to run the script.
Animation is simple (only one effect).

When to use it

Use when you need a stylish text reveal animation for presentations, logos, or web headers.

When not to use it

Do not use if you need a video file, complex animations, or multi-layered effects.

Examples

Customized spotlight reveal

Create a swinging spotlight text reveal animation for 'Hello World' with a swing angle of 30 degrees and a glow opacity of 0.8.

Logo text reveal with brand colors

Generate a light logo reveal animation with text 'MyBrand', golden text on dark background, swinging 45 degrees every 4 seconds.

Transparent background animation

Make a spotlight text reveal HTML for the word 'Vibes' with a transparent background and a lamp scale of 1.5.

description: Generate a swinging spotlight text-reveal HTML animation with configurable text, swing angle, lamp scale, glow, and colors. Use when users ask for 聚光灯扫字动画, spotlight text reveal, light logo reveal, 发光文字揭示动画, or want a reusable HTML animation instead of a static image.

Light Spotlight Render

Workflow

Collect the animation parameters:
- label_text
- swing_angle_degrees
- swing_cycle_seconds
- lamp_scale
- glow_opacity
- mask_color
- text_color
- background_color
- video_width
- video_height
- optional output
Resolve the installed skill directory and run scripts/render_light_spotlight.py.
Return the final absolute HTML path printed by the script.

Command

python3 scripts/render_light_spotlight.py \
  --label-text "vibe-motion" \
  --output "out/light-spotlight-vibe-motion.html"

Installed Skill Resolution

Use the installed skill copy, not the source repo checkout:

skill_dir=""
for base in "${AGENTS_HOME:-$HOME/.agents}" "${CLAUDE_HOME:-$HOME/.claude}" "${CODEX_HOME:-$HOME/.codex}"; do
  if [ -d "$base/skills/light-spotlight-render" ]; then
    skill_dir="$base/skills/light-spotlight-render"
    break
  fi
done
[ -n "$skill_dir" ] || { echo "light-spotlight-render skill not found under ~/.agents, ~/.claude, or ~/.codex"; exit 1; }

python3 "$skill_dir/scripts/render_light_spotlight.py" \
  --label-text "vibe-motion" \
  --output "$(pwd)/out/light-spotlight-vibe-motion.html"

Behavior

Read assets/light_spotlight_template.html.
Replace template placeholders with sanitized parameter values.
Keep the SVG spotlight animation self-contained in one HTML file.
Default output name is derived from label_text.
Preserve the top-vertex lamp scale pivot so the spotlight grows from the lamp tip rather than the swing axis.
Allow background_color=transparent for transparent-background workflows.

Output

Primary output: a standalone .html animation file.
Tell the user to open the HTML file in a browser to preview the animation.
If the user wants video output after generating the HTML, suggest rendering it with another tool or browser capture flow rather than rewriting the skill.

Light Spotlight Animation

Recommended for