create-bitfun-cinematic-wallpaper-skin

Builds BitFun Appearance skins from animated wallpaper videos with VP9 backgrounds and derived WebP assets.

1.9k|214|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/GCWing/BitFun --skill create-bitfun-cinematic-wallpaper-skin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-bitfun-cinematic-wallpaper-skin
Source: https://github.com/GCWing/BitFun/tree/main/src/crates/assembly/core/builtin_skills/create-bitfun-skin/examples/cinematic-animated-wallpaper
Command: npx skills add https://github.com/GCWing/BitFun --skill create-bitfun-cinematic-wallpaper-skin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Turning an animated character wallpaper into a complete BitFun Appearance skin requires manual video encoding, frame cropping, palette design, manifest authoring, and host validation. This recipe automates that pipeline into reproducible build, rebuild, and check commands.

Core Features & Use Cases

  • Cinematic asset generation: Encodes a host-managed VP9 WebM background with poster and derives darkened, cropped WebP assets for floating chat, sidebars, cards, and dialogs from a chosen source frame.
  • Palette-driven manifest scaffolding: Maps a semantic hex palette into translucent materials plus CSS, Widget, Monaco, xterm, Mermaid, and Canvas renderer settings, validated against the Appearance registry.
  • Reproducible builds and drift checks: Records every encoding decision in skin-build.json, verifies source and archive hashes, and runs strict host verification against a BitFun checkout.
  • Use Case: Given an animated wallpaper MP4, generate a contact sheet, pick a frame, tune a palette, and produce an importable .bitfun-appearance package with a runtime inspection checklist.

Quick Start

Load the parent create-bitfun-skin Skill, then ask the agent to build a cinematic skin from my wallpaper video using this recipe with a custom palette and run the host verification.

Frequently Asked Questions about create-bitfun-cinematic-wallpaper-skin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a BitFun skin from an animated wallpaper video?

Run the build command with your video source, output directory, skin id, name, frame time, palette, and BitFun repo path. The script generates a contact sheet first so you can pick a frame, then encodes the VP9 background, derives WebP assets, scaffolds the manifest, and validates the archive.

How do I choose the right frame and crops for skin assets?

Run the contact subcommand to generate a timestamped contact sheet from the video, inspect it, and select a frame time. Then pass normalized crop rectangles for floating, sidebar, detail, portrait, and dialog roles, and re-run build with --force after reviewing the asset preview sheet.

What video format and size limits apply to BitFun background media?

Backgrounds use VP9 WebM kept at or below 64 MiB, with host limits of 60 seconds, 4096 pixels per side, and 9 million pixels. Images stay under 16 MiB, the preview under 4 MiB, and the archive under 96 MiB; the default auto quality mode adapts CRF to satisfy these limits.

Can I reproduce or verify a skin build later?

Yes. The build writes skin-build.json recording the source hash, palette, surface plan, encoding decisions, and archive hash. The rebuild command regenerates from that record, and check verifies hashes, manifest drift, package validity, and host compatibility.

Why does my skin validate but look wrong at runtime?

Structural validation does not check cascade outcomes; host background shorthand rules can reset declared backgrounds. The playbook recommends targeted cascade overrides on registered Parts and a runtime inspection checklist covering workbench, floating chat, dialogs, and reduced-motion fallback.