{"id":"9a30702c-e7e6-4736-acf2-138e2fa25a81","entityType":"agent","slug":"clawhub-zhilogic-oss-create-music-web-wallpaper","name":"Music Web Wallpaper Builder","canonicalUrl":"https://www.xpersona.co/agent/clawhub-zhilogic-oss-create-music-web-wallpaper","canonicalPath":"/agent/clawhub-zhilogic-oss-create-music-web-wallpaper","generatedAt":"2026-10-11T14:15:20.359Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T11:41:43.778Z","emptyReason":null},"description":"Build polished Wallpaper Engine music web wallpapers Skill: Music Web Wallpaper Builder Owner: zhilogic-oss Summary: Build polished Wallpaper Engine music web wallpapers Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-25T07:38:25.958Z | auto Initial release for create-music-web-wallpaper - Enables creation and refinement of interactive music and album-player wallpapers for Wallpaper Engine using HTML, CSS, and JavaScript. - Guides users through staged collaboratio","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s172qk5acz3rp2e1bbjyyt784d8d5z89:create-music-web-wallpaper","sourceUrl":"https://clawhub.ai/zhilogic-oss/create-music-web-wallpaper","homepage":"https://clawhub.ai/zhilogic-oss/skills/create-music-web-wallpaper","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/zhilogic-oss/create-music-web-wallpaper","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/zhilogic-oss/skills/create-music-web-wallpaper","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Build polished Wallpaper Engine music web wallpapers Skill: Music Web Wallpaper Builder Owner: zhilogic-oss Summary: Build polished Wallpaper Engine music web w"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:41:43.778Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:41:43.778Z","emptyReason":null},"stars":null,"forks":null,"downloads":1073,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:41:43.717Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T11:41:43.778Z","lastCrawledAt":"2026-10-11T11:41:43.717Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T11:41:43.717Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-25T07:38:25.958Z","changelog":"Initial release for create-music-web-wallpaper - Enables creation and refinement of interactive music and album-player wallpapers for Wallpaper Engine using HTML, CSS, and JavaScript. - Guides users through staged collaboration, including intake, asset inventory, cataloging, and interface milestones. - Supports music library navigation, synchronized LRC lyrics, theming, visual effects, localization, persistent settings, and performance modes. - Prioritizes user-provided assets and verification/testing inside Wallpaper Engine. - Emphasizes source attribution, rights management, and safe handling of copyrighted material.","fileCount":36,"zipByteSize":129746}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s172qk5acz3rp2e1bbjyyt784d8d5z89:create-music-web-wallpaper","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T14:15:20.358Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhilogic-oss-create-music-web-wallpaper/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T11:41:43.778Z","emptyReason":null},"readme":"Skill: Music Web Wallpaper Builder\n\nOwner: zhilogic-oss\n\nSummary: Build polished Wallpaper Engine music web wallpapers\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-08-25T07:38:25.958Z | auto\n\nInitial release for create-music-web-wallpaper\n\n- Enables creation and refinement of interactive music and album-player wallpapers for Wallpaper Engine using HTML, CSS, and JavaScript.\n- Guides users through staged collaboration, including intake, asset inventory, cataloging, and interface milestones.\n- Supports music library navigation, synchronized LRC lyrics, theming, visual effects, localization, persistent settings, and performance modes.\n- Prioritizes user-provided assets and verification/testing inside Wallpaper Engine.\n- Emphasizes source attribution, rights management, and safe handling of copyrighted material.\n\nArchive index:\n\nArchive v0.1.0: 36 files, 129746 bytes\n\nFiles: agents (0b), agents/openai.yaml (345b), assets (0b), assets/icon.png (78564b), assets/starter (0b), assets/starter/assets (0b), assets/starter/assets/covers (0b), assets/starter/assets/covers/placeholder.svg (1030b), assets/starter/index.html (3842b), assets/starter/LICENSE.txt (11358b), assets/starter/NOTICE.txt (576b), assets/starter/project.json (286b), assets/starter/SOURCES.md (1155b), assets/starter/static (0b), assets/starter/static/css (0b), assets/starter/static/css/styles.css (6621b), assets/starter/static/js (0b), assets/starter/static/js/app.js (11397b), assets/starter/static/js/catalog.js (443b), LICENSE.txt (11357b), NOTICE.txt (870b), README.md (9866b), README.zh-CN.md (8400b), references (0b), references/acceptance.md (1853b), references/catalog-and-assets.md (3090b), references/credits-and-rights.md (2271b), references/lyrics.md (1490b), references/wallpaper-engine-web.md (1917b), scripts (0b), scripts/init_wallpaper.py (4143b), scripts/inventory_media.py (12607b), scripts/validate_wallpaper.py (12144b), skill-card.md (2661b), SKILL.md (11317b), _meta.json (145b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: create-music-web-wallpaper\ndescription: Create, rebuild, or refine interactive music and album-player wallpapers for Wallpaper Engine using HTML, CSS, and JavaScript. Use when an agent needs to turn user-provided or authorized music by bands, solo singers, vocalists, producers, composers, or other creators—together with album covers, audio, LRC lyrics, logos, and visual direction—into a Web wallpaper; build library navigation, synchronized lyrics, themes, optional motion, settings, localization, performance modes, and credits; or iterate on the interface through user feedback and Wallpaper Engine testing. Prefer Web wallpapers over Scene wallpapers for full music-player behavior, seeking, dynamic playlists, and lyric parsing.\n---\n\n# Create Music Web Wallpaper\n\nBuild a Wallpaper Engine **Web wallpaper** as a staged collaboration with the user. Preserve source assets, make attribution visible, and validate playback inside Wallpaper Engine rather than assuming ordinary-browser behavior is sufficient.\n\n## Load only the references needed\n\n- Read [references/wallpaper-engine-web.md](references/wallpaper-engine-web.md) before creating or changing a Wallpaper Engine project.\n- Read [references/catalog-and-assets.md](references/catalog-and-assets.md) when collecting, naming, matching, or importing covers, audio, logos, and lyrics.\n- Read [references/lyrics.md](references/lyrics.md) before implementing lyric parsing or synchronization.\n- Read [references/credits-and-rights.md](references/credits-and-rights.md) before adding third-party material or preparing a release.\n- Read [references/acceptance.md](references/acceptance.md) before handing off a build or claiming completion.\n\n## 1. Begin with an intake conversation\n\nDo not start a large build until the user has confirmed the direction. Ask only the questions that materially change the result:\n\n- wallpaper title, bands, solo singers, vocalists, producers, composers, other music creators, albums, and desired grouping;\n- paths to user-provided audio, covers, lyrics, logos, and fonts;\n- desired visual mood, colors, reference screenshots, and target resolutions;\n- lyric languages and whether the files are ordinary single-language LRC, same-timestamp bilingual LRC, or separately timed translations;\n- wallpaper author name and any additional credits;\n- minimum feature set and performance preference.\n\nRecommend collecting the highest-resolution legitimate album covers available. Ask for lossless logos when possible. Never silently replace user assets with approximate search results.\n\nIf online research is needed, use current official Wallpaper Engine documentation for platform behavior and authoritative or rights-holder sources for metadata. Do not download copyrighted audio or lyrics from unauthorized sources. Prefer user-supplied files.\n\n## 2. Choose Web wallpaper architecture\n\nUse HTML, CSS, and JavaScript when the requested wallpaper includes a music player, progress seeking, dynamic playlists, LRC parsing, draggable panels, multilingual UI, or user-imported libraries. Do not propose an automatic Web-to-Scene conversion.\n\nKeep these concerns separate:\n\n- catalog and source metadata;\n- audio playback state;\n- lyrics parsing and display;\n- visualizer rendering;\n- themes and layout;\n- Wallpaper Engine property bridge;\n- localization;\n- persistent user state.\n\nFor an empty project, initialize the bundled starter:\n\n```powershell\npython scripts/init_wallpaper.py <target-directory> --title \"Wallpaper title\" --author \"Wallpaper author\"\n```\n\nWhen Python is not on `PATH`, locate an available Python runtime instead of rewriting the scaffold by hand. Treat `assets/starter/` as boilerplate: adapt it rather than forcing its design on the user.\n\n## 3. Inventory and organize assets\n\nRun the inventory tool on user-provided material:\n\n```powershell\npython scripts/inventory_media.py <material-directory> --output <material-directory>/media-inventory.json --hash\n```\n\nReview duplicate hashes, unmatched audio/LRC pairs, lyric encoding and timestamps, raster-image dimensions, available audio metadata, and ambiguous names with the user. A warning is a prompt for review, not proof that an asset is unusable: small logos and intentional non-square artwork may be valid. Preserve originals outside the working copy. Use stable relative paths and never overwrite a source file merely to fix runtime behavior.\n\nUse the inventory as evidence, then perform the library matching with the Agent. Match normalized filenames, LRC metadata, embedded audio metadata when accessible, album folders, and user-provided track lists. Present ambiguous matches for confirmation; do not require or build a separate automatic importer merely to use this Skill.\n\nCopy every media file selected for a publishable wallpaper into the wallpaper project. A subscriber cannot access the original creator's unrelated local folders. Keep the original source library outside the project as a backup, but make all catalog paths project-relative.\n\nCreate or update a catalog that records at least:\n\n- stable track ID;\n- title, performing artist or group, optional vocalist/producer/composer credits, collection, album, and track order;\n- audio path and optional lyric path;\n- album cover and optional track-specific cover;\n- accent/background colors;\n- visible source and rights metadata.\n\nDo not infer an exact album track order from memory when it can be verified.\n\n## 4. Treat lyrics conservatively\n\nDefault to standard LRC behavior: parse timestamps, sort lines, and display the text attached to each timestamp.\n\nDo **not** apply bilingual timestamp realignment by default. The specialized Chinese/Japanese repair used by one source project is not a universal rule and can damage ordinary lyrics.\n\nOnly introduce bilingual grouping or realignment when:\n\n1. the file format clearly contains multiple languages;\n2. an observed playback test proves that the timelines are mismatched; and\n3. the user approves the correction rule.\n\nKeep the correction reversible and separate from the original LRC. See [references/lyrics.md](references/lyrics.md).\n\n## 5. Build a functional slice before polishing\n\nImplement and verify one complete path first:\n\n1. one album cover displays;\n2. one song loads and produces sound;\n3. play, pause, seeking, and volume work;\n4. lyrics follow playback;\n5. the track appears in the list;\n6. its source is visible in the credits view.\n\nThen expand the catalog and add optional features. Avoid changing localization, playback, and visualizer internals in one untested batch.\n\nAfter the basic player works, briefly ask whether the user wants optional effects such as cover motion, blurred cover backgrounds, an audio visualizer, draggable panels, multilingual controls, system-theme following, or a low-usage mode. Do not add them automatically, bundle an effect installer, or insist that they are required. Implement only the features the user explicitly chooses through the normal Agent editing workflow.\n\n## 6. Iterate on the interface through conversation\n\nTreat design as a sequence of user-reviewed milestones:\n\n1. layout and information hierarchy;\n2. album/track navigation;\n3. typography and colors;\n4. themes and cover/background behavior;\n5. motion and visualizer;\n6. settings and localization;\n7. performance and unusual aspect ratios.\n\nAfter each milestone, describe the visible result and ask the user to test it in Wallpaper Engine. When screenshots are available, inspect them and change measured spacing, scale, stacking, and interaction behavior instead of guessing.\n\nPreserve accepted behavior while editing a later milestone. Record deferred ideas separately rather than slipping them into the current change.\n\n## 7. Add features with explicit state rules\n\nFor each control, define:\n\n- what it changes;\n- whether it affects browsing, playback, or both;\n- whether the value persists across reloads;\n- whether Wallpaper Engine properties override the in-wallpaper value;\n- its keyboard, pointer, touchpad, and localization behavior.\n\nRecommended defaults:\n\n- switching album filters or artist views must not interrupt the currently playing song;\n- clicking a track or using previous/next may change playback;\n- shuffle should avoid repeats within one cycle;\n- theme, background mode, panel layout, volume, and performance mode should persist;\n- low-usage mode should disable only expensive effects and retain core player information;\n- cover motion and visualizer frame rates should be capped independently.\n\n## 8. Make credits visible and accurate\n\nEvery generated wallpaper must include an accessible, visible **About / Credits / Material Sources** view. Do not hide attribution only in repository files or the Workshop description.\n\nKeep authorship roles distinct:\n\n- Set the wallpaper author to the person actually making that wallpaper.\n- When the bundled starter, album-player layout, or interaction design is actually derived from the reference, credit it as: `Inspired by OriginalCube's Bocchi the Rock! album-player wallpaper` and link to `https://steamcommunity.com/sharedfiles/filedetails/?id=2905017768`.\n- When the user creates a genuinely independent interface and uses only the general workflow, do not make the inaccurate claim that its interface was inspired by OriginalCube. Record the catalog credit flag accordingly.\n- Add a separate tool credit: `Created with the create-music-web-wallpaper Agent Skill by 双料贝斯手长崎素世 (2932821663@qq.com).`\n- Keep the tool credit readable and easy to find in About, Credits, or Material Sources, but visually subordinate to the wallpaper title, actual author, cover, and playback information. Do not place it as a persistent banner, splash screen, or dominant main-interface label.\n- Do **not** describe 双料贝斯手长崎素世 as the wallpaper author unless that person actually made the wallpaper.\n\nList every third-party cover, audio file, lyric, translation, logo, icon, font, and generated image with its creator or rights holder, source link or supplied-file note, license/permission status, and modifications. Follow [references/credits-and-rights.md](references/credits-and-rights.md).\n\n## 9. Validate before delivery\n\nRun the included validator:\n\n```powershell\npython scripts/validate_wallpaper.py <wallpaper-directory>\n```\n\nRun project-specific automated tests, then test the actual Wallpaper Engine build. Ordinary Chrome playback does not prove CEF audio, localization, property callbacks, or visualizer behavior.\n\nDo not claim completion while required assets are missing, audio is silent, attribution is invisible, or only one resolution has been checked. Use [references/acceptance.md](references/acceptance.md).\n\n## 10. Keep release boundaries honest\n\n- Clearly label fan-made and unofficial work.\n- Do not claim ownership of music, lyrics, translations, official artwork, or trademarks.\n- Do not imply that visible attribution grants a license.\n- Do not publish user-provided private files without permission.\n- Do not bundle copyrighted examples in this skill or reuse another wallpaper's code/assets without permission.\n- Preserve the bundled Apache-2.0 `LICENSE.txt` and `NOTICE.txt` when distributing a wallpaper based on the starter.\n- Keep the starter generic; replace every placeholder before publishing.\n\nFile v0.1.0:README.md\n\n# Music Web Wallpaper Builder\n\nEnglish | [简体中文](README.zh-CN.md)\n\n![Music Web Wallpaper Builder icon](assets/icon.png)\n\nAn Agent Skill that helps an AI Agent collaborate with a user to create **Wallpaper Engine music Web wallpapers**.\n\nProvide music you are authorized to use, LRC lyrics, album artwork, logos, and your design ideas. Then work with the Agent through conversation to build and refine a player, music library, synchronized lyrics, themes, motion, settings, localization, and performance optimizations. You do not need prior knowledge of HTML, CSS, or JavaScript, but you should still participate in asset review, interface decisions, and real testing inside Wallpaper Engine.\n\n## What it is for\n\nThis Skill is not limited to bands. It can also be used for:\n\n- solo artists, vocalists, and virtual singers;\n- composers, music producers, and other creators;\n- game, animation, or personal music collections;\n- single-album, multi-album, or creator-based libraries;\n- Wallpaper Engine projects that need a complete player, seeking, dynamic playlists, and lyric parsing.\n\nFor projects with these features, the Skill recommends a **Web wallpaper** rather than a Scene wallpaper by default.\n\n## Main capabilities\n\n- Design and refine the wallpaper interface in user-reviewed stages;\n- organize albums, tracks, creators, artwork, and material-source records;\n- assist with matching audio and lyric files while asking the user to resolve ambiguous matches;\n- inspect cover resolution, lyric encoding and timestamps, duplicate files, and missing assets;\n- build playback, pause, track switching, seeking, volume, playlists, shuffle, and related controls;\n- parse standard LRC lyrics and support original, translated, or bilingual display when requested;\n- add themes, cover motion, blurred backgrounds, visualizers, localization, and low-usage modes when selected by the user;\n- handle Wallpaper Engine properties, persistent state, and common aspect ratios;\n- check material credits, copyright notices, release structure, and basic runtime status;\n- continue refining the result through user feedback and real testing instead of applying a fixed template once.\n\n## What to prepare\n\nPrepare as many of the following as possible:\n\n1. Audio files you are authorized to use;\n2. LRC lyric files, although instrumental or lyricless tracks are also supported;\n3. The highest-resolution legitimate album or single artwork available;\n4. Optional transparent PNG or WebP logos, or vector SVG logos;\n5. Album names, track order, and artist or creator information;\n6. Material creators, source links, licenses, or permission details;\n7. Preferred colors, layout references, and target aspect ratios;\n8. The name of the actual wallpaper author.\n\nPreserve original source assets and do not overwrite them directly. Before a public release, all audio, lyrics, and images used by the final wallpaper must be copied into the wallpaper project. Published wallpapers cannot continue referencing unrelated absolute paths on the creator's computer.\n\n## Installation\n\n### Download from GitHub\n\n1. Download or clone this repository:\n   `https://github.com/zhilogic-oss/create-music-web-wallpaper`\n2. Place the entire `create-music-web-wallpaper` folder in a Skills directory supported by your Agent.\n3. Make sure `SKILL.md` is located at the root of that folder.\n4. Restart or refresh the Agent so it scans for Skills again.\n\nSkills directories vary by Agent. For example, Codex can use a user-level Skills directory, while clients compatible with the Agent Skills standard may also use `.agents/skills/`. Follow the official documentation for your client.\n\nOnce approved on SkillHub, this Skill can also be installed from SkillHub.\n\n## Getting started\n\nAfter installation, you can tell your Agent:\n\n> Use create-music-web-wallpaper to make a Wallpaper Engine music wallpaper from these album covers, audio files, and LRC lyrics. Confirm the overall direction with me first instead of building every feature immediately.\n\nOr provide a more detailed request:\n\n> I want to create a music wallpaper for a solo artist. The library has three albums and needs synchronized lyrics, light and dark themes, a blurred cover background, and a low-usage mode. Inspect my asset quality and file matches first, then propose a staged plan.\n\nThe Skill prioritizes questions that materially affect the result, including asset paths, creator grouping, lyric format, visual direction, target resolution, feature scope, and wallpaper authorship. It should not start a large implementation before the direction is confirmed.\n\n## Recommended workflow\n\n1. **Confirm the direction:** decide the creators, album structure, interface style, lyric languages, and feature scope.\n2. **Inspect the assets:** review quality, encoding, duplicates, missing items, and source information.\n3. **Build a functional slice:** make one song play, seek correctly, and display synchronized lyrics.\n4. **Expand the library:** add the remaining tracks, albums, covers, and categories.\n5. **Refine the interface in stages:** review layout, typography, colors, themes, and motion separately.\n6. **Optimize interaction and performance:** define persistence, switching rules, frame-rate caps, and low-usage behavior.\n7. **Test inside Wallpaper Engine:** verify audio, lyrics, properties, localization, multiple resolutions, and performance.\n8. **Complete credits before release:** make the author, material sources, and required copyright information visible inside the wallpaper.\n\nDo not assume that audio, property callbacks, localization, or a visualizer will work in Wallpaper Engine merely because the project works in an ordinary browser.\n\n## Lyric-handling principles\n\nThe Skill treats imported lyrics as standard LRC by default: it parses timestamps, sorts lines stably, and displays the associated text.\n\nIt **does not apply the specialized Chinese/Japanese bilingual timeline realignment from a particular source project by default**. Reversible special handling should be introduced only when playback proves that the bilingual timelines are systematically misaligned and the user approves the correction rule. Original LRC files should not be overwritten.\n\nWhen filenames, LRC tags, embedded audio metadata, and album folders disagree, the Agent should present plausible matches for the user to decide instead of pretending that an automatic match is certain.\n\n## Included tools\n\nThe repository includes three helper scripts:\n\n- `scripts/init_wallpaper.py`: initialize a music Web wallpaper from the generic starter;\n- `scripts/inventory_media.py`: inspect media files, lyrics, image dimensions, and duplicate hashes;\n- `scripts/validate_wallpaper.py`: validate project structure, relative paths, track data, credits, and release readiness.\n\nThese scripts make repeated work more reliable. The Agent will usually run them according to the current environment; users without Python experience do not need to edit them manually.\n\n## Optional effects\n\nAfter the basic player works, the Agent will ask whether you want features such as:\n\n- cover tilt controlled by the pointer or a floating cover animation;\n- blurred cover backgrounds;\n- an audio visualizer;\n- draggable and resizable lyric and playlist panels;\n- a multilingual interface;\n- light and dark themes that follow the operating system;\n- a low-usage mode.\n\nThese are optional directions, not features that are automatically added to every project. The wallpaper creator decides what to implement and how it should behave, then refines it through real testing.\n\n## What it is not\n\n- It is not a one-click program that produces a finished work without discussion;\n- it does not include copyrighted example music, lyrics, official artwork, or logos;\n- it does not resolve third-party asset permissions for the user;\n- it does not guarantee that every file can be matched accurately from its filename alone;\n- it does not automatically convert Web wallpapers into Scene wallpapers;\n- it does not force every project to use the same layout, colors, or effects.\n\n## Authorship, references, and credits\n\nThe author of a wallpaper made with this Skill should be **the person who actually creates that wallpaper**, not the Skill author.\n\nIf a work actually uses the bundled player starter, album-player layout, or corresponding interaction model, its visible in-wallpaper About, Credits, or Material Sources view should:\n\n- state that the interface was inspired by OriginalCube's *Bocchi the Rock!* album-player wallpaper:\n  `https://steamcommunity.com/sharedfiles/filedetails/?id=2905017768`\n- include the following tool credit without competing with the main visual focus:\n  `Created with the create-music-web-wallpaper Agent Skill by 双料贝斯手长崎素世 (2932821663@qq.com).`\n\nIf the creator uses only the Skill's general workflow and designs a genuinely independent interface, the work should not inaccurately claim that its interface was inspired by OriginalCube. However, when the Skill or its bundled files are used, the brief Skill tool credit should still be retained.\n\nRecord the creator or rights holder, source, permission status, and modifications for every piece of music, lyric, translation, artwork, logo, icon, font, and generated image. Attribution does not by itself grant permission to use a material.\n\n## License\n\nThis Skill, its generic wallpaper starter, and the bundled scripts are licensed under the [Apache License 2.0](LICENSE.txt). See [NOTICE.txt](NOTICE.txt) for additional notices.\n\nThis license does not automatically cover music, lyrics, artwork, logos, fonts, trademarks, or other materials imported by users or provided by third parties. Those materials remain subject to their own licenses, permissions, and rights-holder requirements.\n\nSkill author: **双料贝斯手长崎素世**  \nContact: `2932821663@qq.com`\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn71m3bs8dey1gfn54t300pn5h8d4wzb\",\n  \"slug\": \"create-music-web-wallpaper\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1787643505958\n}\n\nFile v0.1.0:references/acceptance.md\n\n# Acceptance checklist\n\n## Assets and catalog\n\n- Every catalog path exists and uses consistent casing.\n- No duplicate track IDs or unintended duplicate audio paths exist.\n- Album order and titles are verified.\n- High-resolution covers display without stretching or unintended cropping.\n- Every shipped asset is referenced or intentionally retained.\n\n## Playback and lyrics\n\n- Audio is audible in Wallpaper Engine, not only in Chrome.\n- Play, pause, previous, next, seeking, volume, repeat, and shuffle behave as specified.\n- Browsing another artist, creator, collection, or album does not interrupt playback unless designed to do so.\n- Rapid switching cannot display lyrics from the previous track.\n- Lyrics are checked at the beginning, middle, and end.\n- Ordinary imported LRC is not subjected to unrequested bilingual realignment.\n\n## Interface\n\n- Test 16:9, 16:10, 21:9, and at least one small desktop resolution.\n- Test mouse, wheel/touchpad, hover transitions, draggable panels, and stacking.\n- Menus remain above draggable content.\n- Light, dark, and cover-background themes preserve contrast.\n- State intended to persist survives wallpaper reload.\n\n## Performance\n\n- Measure idle, pointer interaction, and visualizer-on states.\n- Cap render loops and stop hidden effects.\n- Provide a low-usage mode when expensive optional effects exist.\n- Verify behavior at the Wallpaper Engine default FPS.\n\n## Localization and release\n\n- Wallpaper Engine property labels and in-wallpaper text use the intended languages.\n- Missing translations fall back predictably.\n- Preview metadata points to an existing file.\n- Visible credits include the actual wallpaper author, the OriginalCube reference when the starter/reference design was used, the discreet Skill credit, and material sources.\n- Workshop description matches the shipped behavior and attribution.\n\nFile v0.1.0:references/catalog-and-assets.md\n\n# Catalog and asset workflow\n\n## Intake\n\nAsk the user to supply or authorize:\n\n- highest-resolution album and single covers for bands, solo singers, producers, composers, or other creators;\n- original audio files;\n- LRC or other lyric files;\n- vector or transparent logos;\n- desired author name and source records.\n\nDo not scrape copyrighted audio or lyrics from unauthorized mirrors. Record whether a file was supplied by the user, downloaded from a rights-holder page, recreated, converted, or AI-generated.\n\n## Matching order\n\nUse this order and ask for confirmation when ambiguous:\n\n1. normalized exact base-name match;\n2. track number plus album metadata;\n3. LRC `ti`, `ar`, and `al` tags;\n4. embedded audio metadata;\n5. similarity suggestion;\n6. manual selection.\n\nNever silently bind two plausible lyric files to one song.\n\n## Quality review\n\nUse `scripts/inventory_media.py` to report raster dimensions, vector status, lyric encoding and timestamp counts, optional audio metadata, and exact duplicate hashes. Treat warnings as review prompts:\n\n- prefer high-resolution covers when legitimate sources provide them;\n- verify that a small raster is not being stretched as a full cover;\n- distinguish deliberately small logos and icons from insufficient album artwork;\n- inspect non-UTF-8 or ambiguous lyric encoding before conversion;\n- confirm that an LRC contains usable timestamps;\n- compare exact duplicates before removing files.\n\nThe inventory tool may report that audio metadata was not inspected when the optional `mutagen` library is unavailable. The Agent can use another safe local metadata tool or ask the user for the missing title, artist, album, and order; this is not a reason to block the project.\n\n## Preferred catalog fields\n\n```json\n{\n  \"id\": \"stable-track-id\",\n  \"title\": \"Track title\",\n  \"artist\": \"Artist\",\n  \"vocalist\": \"Optional vocalist\",\n  \"producer\": \"Optional producer or music creator\",\n  \"composer\": \"Optional composer\",\n  \"collectionId\": \"artist-or-creator-group\",\n  \"albumId\": \"album-id\",\n  \"trackNumber\": 1,\n  \"audio\": \"assets/audio/song.mp3\",\n  \"lyrics\": \"assets/lyrics/song.lrc\",\n  \"cover\": \"assets/covers/album.jpg\",\n  \"trackCover\": \"\",\n  \"accentColor\": \"#3388bb\",\n  \"sourceId\": \"material-record-id\"\n}\n```\n\nUse a track-specific cover only when present; otherwise fall back to the album cover.\n\nThe Agent may build the catalog directly after reviewing the inventory. It should not pretend uncertain matches are confirmed. When filenames, tags, folders, and track lists disagree, show the alternatives to the user.\n\n## File handling\n\n- Preserve original files outside the project.\n- Copy only referenced release assets into the wallpaper project before publishing; Workshop subscribers cannot read the author's unrelated local source folders.\n- Normalize unsafe filenames only in the working copy and update catalog paths together.\n- Detect text encoding before declaring an LRC corrupted.\n- Hash or compare sizes before deleting apparent duplicates.\n- Do not infer duplicate songs solely from similar titles; compare metadata and audio when needed.\n\nFile v0.1.0:references/credits-and-rights.md\n\n# Credits and rights\n\n## Required visible credits\n\nProvide an in-wallpaper About, Credits, or Material Sources view containing:\n\n1. the actual wallpaper author;\n2. when the starter or its album-player interaction model is used, `Inspired by OriginalCube's Bocchi the Rock! album-player wallpaper` with https://steamcommunity.com/sharedfiles/filedetails/?id=2905017768;\n3. `Created with the create-music-web-wallpaper Agent Skill by 双料贝斯手长崎素世 (2932821663@qq.com).`, shown as a discreet secondary line inside the credits view rather than a prominent main-interface element;\n4. material-level attribution.\n\nThe skill creator is not the wallpaper author unless they actually made that wallpaper.\n\nKeep the skill credit readable without competing with the wallpaper's own identity. An About/Credits dialog, settings information panel, or material-sources page is appropriate. Avoid persistent overlays, title-level typography, startup interruptions, or branding that could imply authorship of the wallpaper.\n\nDo not claim OriginalCube inspiration for a genuinely independent interface that used only the Skill's general production workflow. In that case, set the catalog's `credits.usesOriginalCubeReference` flag to `false` and remove the interface-inspiration sentence. The separate Skill tool credit remains required when the Skill or its bundled files were used.\n\n## Material record\n\nFor every external item, record:\n\n- material name and type;\n- creator, collector, translator, or rights holder as applicable;\n- source URL or `Provided locally by the user`;\n- license or permission status;\n- modifications such as crop, conversion, recolor, vector redraw, or AI generation;\n- copyright notice where appropriate.\n\nUse `Unknown / not independently verified` rather than inventing a license. Attribution does not replace permission.\n\n## AI disclosure\n\nIdentify generated covers, backgrounds, or other visual assets. Do not describe official artwork, audio, lyrics, or logos as AI-generated merely because an agent organized or converted them.\n\n## Release copy\n\nState that the wallpaper is unofficial and fan-made when applicable. Credit translations separately from original lyrics. Keep the visible in-wallpaper record and Workshop description consistent.\n\nFile v0.1.0:references/lyrics.md\n\n# Lyrics behavior\n\n## Default contract\n\nTreat imported lyrics as ordinary LRC unless evidence says otherwise:\n\n1. parse `[mm:ss.xx]` and `[hh:mm:ss.xxx]` timestamps;\n2. allow multiple timestamps on one line;\n3. preserve all text after the timestamp;\n4. sort stably by time;\n5. group only lines with the exact same timestamp;\n6. show `No lyrics` in the selected interface language when no usable lines exist.\n\nDo not guess which same-timestamp line is a translation. Let the catalog or the user declare language roles.\n\n## Bilingual lyrics\n\nSupport these as separate modes:\n\n- original only;\n- translation only;\n- both lines grouped at identical timestamps.\n\nIf original and translation use separate time axes, keep them separate by default. Do not automatically shift, merge, or reorder them.\n\n## Optional realignment\n\nOnly implement realignment after a playback sample proves a systematic mismatch. Document:\n\n- the affected files;\n- the detection rule;\n- the transformed runtime representation;\n- the fallback when confidence is low;\n- how to disable the correction.\n\nNever overwrite the source LRC. Store corrections as catalog metadata, a derived cache, or a separate generated file.\n\n## Race safety\n\nWhen switching songs quickly, associate each asynchronous lyric load with a request ID or expected path. Ignore a response if the active track changed before it completed.\n\nTest lyric timing near the beginning, middle, and end of every newly added song, not only whether lines appear.\n\nFile v0.1.0:references/wallpaper-engine-web.md\n\n# Wallpaper Engine Web wallpaper notes\n\nRead the current official documentation before relying on platform behavior:\n\n- Web overview: https://docs.wallpaperengine.io/en/web/overview.html\n- Creating a Web wallpaper: https://docs.wallpaperengine.io/en/web/first/gettingstarted.html\n- Web user properties: https://docs.wallpaperengine.io/en/web/customization/properties.html\n- Audio visualizer: https://docs.wallpaperengine.io/en/web/audio/visualizer.html\n- FPS control: https://docs.wallpaperengine.io/en/web/performance/fps.html\n- CEF debugging: https://docs.wallpaperengine.io/en/web/debug/debug.html\n\n## Architecture rules\n\n- Package required HTML, CSS, JavaScript, images, fonts, audio, and lyrics locally.\n- Use relative paths and URL-encode paths containing spaces, non-ASCII characters, or `#`.\n- Register `window.wallpaperPropertyListener` globally and early.\n- Treat `applyUserProperties` as partial updates after the initial callback.\n- Keep Wallpaper Engine property keys and values stable when localizing display labels.\n- Use `window.wallpaperRegisterAudioListener` once for system-audio visualization.\n- Respect the configured FPS and independently limit expensive visualizer or pointer loops.\n- Use CEF DevTools for audio, media state, callback, and rendering diagnosis.\n\n## Important boundaries\n\n- Web and Scene wallpapers are different project types; there is no automatic conversion.\n- Web file/directory user properties officially target image and video imports, not arbitrary MP3/LRC libraries.\n- A Web wallpaper cannot change Wallpaper Engine's global fullscreen or pause policy.\n- A Web wallpaper must not assume it can launch the default browser or arbitrary executables.\n- Workshop updates can replace files inside a subscribed wallpaper directory; never store user-created libraries there.\n\nVerify undocumented browser APIs in Wallpaper Engine CEF before committing the product design to them.\n\nFile v0.1.0:assets/starter/SOURCES.md\n\n# Material sources and credits\n\nWallpaper title: **{{TITLE}}**  \nWallpaper author: **{{AUTHOR}}**\n\n## Required visible credits\n\n- Interface and interaction reference, required when the bundled starter/reference design is used: [OriginalCube's Bocchi the Rock! album-player wallpaper](https://steamcommunity.com/sharedfiles/filedetails/?id=2905017768)\n- Creation tool: `create-music-web-wallpaper` Agent Skill by 双料贝斯手长崎素世, 2932821663@qq.com\n\nThese credits are also visible inside the wallpaper. They do not grant permission to use third-party material.\n\n## Material register\n\nReplace the examples below with every cover, audio file, lyric, translation, logo, icon, font, and generated image used in the published wallpaper.\n\n| ID | Material | Creator / rights holder | Source | License or permission | Modifications |\n| --- | --- | --- | --- | --- | --- |\n| example-cover | Placeholder cover | Wallpaper author | Original work | Author-owned | None |\n\n## Release statement\n\nState whether the wallpaper is unofficial or fan-made where applicable. Do not claim ownership of third-party music, lyrics, translations, artwork, or trademarks.\n\nFile v0.1.0:README.zh-CN.md\n\n# Music Web Wallpaper Builder\n\n[English](README.md) | 简体中文\n\n![Music Web Wallpaper Builder 图标](assets/icon.png)\n\n一个帮助 AI Agent 与用户协作制作 **Wallpaper Engine 音乐网页壁纸**的 Agent Skill。\n\n你可以提供自己拥有使用权的音乐、LRC 歌词、专辑封面、Logo 和设计想法，再通过与 Agent 对话，逐步完成播放器、曲库、同步歌词、主题、动效、设置、多语言和性能优化。你不需要先掌握 HTML、CSS 或 JavaScript，但仍需要参与素材确认、界面选择和 Wallpaper Engine 实机验收。\n\n## 它适合做什么\n\n这个 Skill 不只适用于乐队，也适用于：\n\n- 独立歌手、演唱者与虚拟歌手；\n- 作曲者、音乐制作人和其他创作者；\n- 游戏、动画或个人音乐收藏；\n- 单一专辑、多专辑或按创作者分类的曲库；\n- 需要完整播放器、进度调整、动态歌单和歌词解析的 Wallpaper Engine 项目。\n\n对于这类功能，Skill 默认建议制作 **Web 网页壁纸**，而不是 Scene 场景壁纸。\n\n## 主要能力\n\n- 根据用户提供的方向，分阶段设计并调整壁纸界面；\n- 整理专辑、曲目、创作者、封面和素材来源信息；\n- 辅助匹配音乐文件与歌词文件，并把不确定的匹配交给用户确认；\n- 检查封面分辨率、歌词编码与时间戳、重复文件和缺失素材；\n- 构建播放、暂停、切歌、进度调整、音量、歌单和随机播放等功能；\n- 解析普通 LRC 歌词，并按需要支持原文、翻译或双语显示；\n- 按用户选择加入主题、封面动效、模糊背景、频谱、多语言和低占用模式；\n- 处理 Wallpaper Engine 属性、状态保存和常见屏幕比例适配；\n- 检查素材署名、版权说明、发布结构和基本运行状态；\n- 通过与用户反复沟通和实机测试继续微调，而不是一次性套用固定模板。\n\n## 使用前需要准备\n\n尽量准备以下材料：\n\n1. 有权使用的音乐文件；\n2. LRC 歌词文件，没有歌词的歌曲也可以加入；\n3. 尽可能高清的专辑或单曲封面；\n4. 可选的透明 PNG、WebP 或矢量 SVG Logo；\n5. 专辑名称、曲目顺序、歌手或创作者信息；\n6. 素材作者、来源链接、许可证或授权情况；\n7. 喜欢的配色、布局参考和目标屏幕比例；\n8. 最终壁纸作者的名称。\n\n优先保留原始素材，不要直接覆盖源文件。准备公开发布时，最终使用的音乐、歌词和图片必须复制进壁纸项目，不能继续引用作者电脑中与项目无关的绝对路径。\n\n## 安装\n\n### 从 GitHub 下载\n\n1. 下载或克隆本仓库：\n   `https://github.com/zhilogic-oss/create-music-web-wallpaper`\n2. 将整个 `create-music-web-wallpaper` 文件夹放入所用 Agent 支持的 Skills 目录。\n3. 确保 `SKILL.md` 位于该文件夹根目录。\n4. 重新启动或刷新 Agent，使其重新扫描 Skills。\n\n不同 Agent 的 Skills 目录可能不同，例如 Codex 可使用用户级 Skills 目录，兼容 Agent Skills 标准的客户端也可能使用 `.agents/skills/`。请以所用客户端的官方说明为准。\n\n通过 SkillHub 审核后，也可以从 SkillHub 安装本 Skill。\n\n## 如何开始\n\n安装后，可以直接对 Agent 说：\n\n> 使用 create-music-web-wallpaper，帮我用这些专辑封面、音乐和 LRC 歌词制作一个 Wallpaper Engine 音乐壁纸。先和我确认整体方向，不要立即完成全部功能。\n\n也可以给出更具体的要求：\n\n> 我想为一位独立歌手制作音乐壁纸。曲库分为三张专辑，需要同步歌词、亮暗主题、模糊封面背景和低占用模式。请先检查我的素材质量和文件匹配情况，再制定分阶段计划。\n\nSkill 会优先询问真正影响结果的问题，例如素材路径、创作者分类、歌词形式、视觉风格、目标分辨率、功能范围和壁纸作者，而不是在方向尚未确认时直接进行大规模修改。\n\n## 推荐工作流程\n\n1. **确认方向**：决定创作者、专辑结构、界面风格、歌词语言和功能范围。\n2. **检查素材**：核对文件质量、编码、重复项、缺失项和来源信息。\n3. **完成最小可用版本**：先让一首歌曲能够播放、调整进度并同步显示歌词。\n4. **扩展曲库**：加入其余歌曲、专辑、封面和分类。\n5. **逐项调整界面**：依次确认布局、字体、颜色、主题和动效。\n6. **优化交互与性能**：明确状态保存、切换逻辑、帧率上限和低占用模式。\n7. **在 Wallpaper Engine 中验收**：检查声音、歌词、属性、多语言、不同分辨率和性能。\n8. **完善署名后发布**：保证壁纸内可以看到作者、素材来源和必要的版权说明。\n\n不要仅凭普通浏览器中运行正常，就断定 Wallpaper Engine 中的音频、属性回调、本地化和频谱一定正常。\n\n## 歌词处理原则\n\nSkill 默认把导入文件当作普通 LRC：解析时间戳、稳定排序，并显示对应文本。\n\n它**不会默认套用特定项目中的中日双语时间轴重排规则**。只有实际播放证明双语时间轴存在系统性错位，并且用户确认修正规则后，才会加入可撤销的特殊处理。原始 LRC 文件不应被直接覆盖。\n\n当文件名称、LRC 标签、音频元数据和专辑目录给出不同答案时，Agent 应列出可能的匹配并让用户决定，而不是假装已经自动判断正确。\n\n## 附带工具\n\n仓库包含三个辅助脚本：\n\n- `scripts/init_wallpaper.py`：从通用模板初始化一个音乐网页壁纸；\n- `scripts/inventory_media.py`：检查媒体文件、歌词、图片尺寸和重复哈希；\n- `scripts/validate_wallpaper.py`：检查项目结构、相对路径、曲目数据、署名和发布准备情况。\n\n这些脚本用于提高重复工作的可靠性。通常由 Agent 根据当前环境调用；没有 Python 基础的用户不需要手动修改脚本。\n\n## 可选效果\n\n完成基本播放器后，Agent 会询问你是否希望加入以下内容：\n\n- 封面随鼠标倾斜或上下浮动；\n- 模糊封面背景；\n- 音频频谱；\n- 可拖动、缩放的歌词栏和歌单栏；\n- 多语言界面；\n- 跟随系统亮暗主题；\n- 低占用模式。\n\n这些只是可选方向，不会自动全部加入。是否实现、实现成什么样，应由壁纸制作者决定并通过实际测试调整。\n\n## 这不是什么\n\n- 不是不经沟通即可生成最终作品的一键式程序；\n- 不附带受版权保护的示例音乐、歌词、官方封面或 Logo；\n- 不会替用户解决第三方素材授权问题；\n- 不保证所有文件都能仅凭名称自动准确匹配；\n- 不会把 Web 网页壁纸自动转换成 Scene 场景壁纸；\n- 不会强制每个项目使用相同布局、颜色或动效。\n\n## 作者、参考与署名\n\n使用本 Skill 做出的壁纸，作者应当是**实际制作该壁纸的人**，而不是 Skill 作者。\n\n如果作品实际使用了本 Skill 附带的播放器模板、专辑播放器布局或相应交互思路，应在壁纸内可见的“关于 / 致谢 / 素材来源”区域中：\n\n- 注明界面参考了 OriginalCube 的《Bocchi the Rock!》专辑播放器壁纸：\n  `https://steamcommunity.com/sharedfiles/filedetails/?id=2905017768`\n- 以不抢占主要视觉焦点的方式注明：\n  `Created with the create-music-web-wallpaper Agent Skill by 双料贝斯手长崎素世 (2932821663@qq.com).`\n\n如果制作者只使用了本 Skill 的通用工作流程，并自行设计了真正独立的界面，则不应错误声称界面参考了 OriginalCube；但实际使用本 Skill 或其附带文件时，仍应保留简短的 Skill 工具署名。\n\n所有音乐、歌词、翻译、封面、Logo、图标、字体和生成图片都应分别记录作者或权利人、来源、许可状态与修改情况。署名不等同于已经获得使用许可。\n\n## 许可证\n\n本 Skill、通用壁纸模板和配套脚本采用 [Apache License 2.0](LICENSE.txt)。相关说明见 [NOTICE.txt](NOTICE.txt)。\n\n该许可证不自动覆盖用户导入或第三方提供的音乐、歌词、封面、Logo、字体、商标及其他素材。这些内容仍受各自许可证、授权条件和权利人要求约束。\n\nSkill 作者：**双料贝斯手长崎素世**  \n联系邮箱：`2932821663@qq.com`\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nCreate, rebuild, or refine interactive Wallpaper Engine music Web wallpapers with HTML, CSS, JavaScript, user-authorized media, synchronized lyrics, themes, settings, performance modes, and visible credits.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[zhilogic-oss](https://clawhub.ai/user/zhilogic-oss)\n\n### License/Terms of Use:\n\nApache 2.0\n\n## Use Case:\n\nExternal users and developers use this skill to collaborate with an agent on Wallpaper Engine music Web wallpapers that include playback, playlists, synchronized LRC lyrics, asset cataloging, localization, visual effects, settings, and release-ready credits.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Generated wallpapers may include a fixed visible tool credit with the skill creator's name and email, and validation may require that credit.\n\nMitigation: Review the credit behavior before installing or distributing wallpapers made with this skill, and make the credit optional or user-controlled for neutral distribution.\n\nRisk: Wallpaper projects can accidentally include or reference copyrighted music, lyrics, artwork, logos, or private local files without permission.\n\nMitigation: Use only user-provided or authorized assets, keep material-source records, copy publishable assets into project-relative paths, and verify visible credits before release.\n\n## Reference(s):\n\n- [Server-resolved source repository](https://github.com/zhilogic-oss/create-music-web-wallpaper)\n- [Wallpaper Engine Web Wallpaper Notes](references/wallpaper-engine-web.md)\n- [Catalog and Asset Workflow](references/catalog-and-assets.md)\n- [Lyrics Behavior](references/lyrics.md)\n- [Credits and Rights](references/credits-and-rights.md)\n- [Acceptance Checklist](references/acceptance.md)\n- [OriginalCube Wallpaper Reference](https://steamcommunity.com/sharedfiles/filedetails/?id=2905017768)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with inline commands and generated or modified HTML, CSS, JavaScript, JSON, and project files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Outputs are shaped through staged user review and should be validated in Wallpaper Engine before release.]\n\n## Skill Version(s):\n\n0.1.0 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v0.1.0:assets/starter/project.json\n\n{\n  \"file\": \"index.html\",\n  \"general\": {\n    \"properties\": {\n      \"volume\": {\n        \"order\": 1,\n        \"text\": \"Volume\",\n        \"type\": \"slider\",\n        \"value\": 80,\n        \"min\": 0,\n        \"max\": 100\n      }\n    }\n  },\n  \"title\": \"{{TITLE}}\",\n  \"type\": \"web\",\n  \"version\": 1\n}","readmeExcerpt":"Skill: Music Web Wallpaper Builder Owner: zhilogic-oss Summary: Build polished Wallpaper Engine music web wallpapers Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-25T07:38:25.958Z | auto Initial release for create-music-web-wallpaper - Enables creation and refinement of interactive music and album-player wallpapers for Wallpaper Engine using HTML, CSS, and JavaScript. - Guides users through staged collaboratio","codeSnippets":[],"executableExamples":[{"language":"powershell","snippet":"python scripts/init_wallpaper.py <target-directory> --title \"Wallpaper title\" --author \"Wallpaper author\""},{"language":"powershell","snippet":"python scripts/inventory_media.py <material-directory> --output <material-directory>/media-inventory.json --hash"},{"language":"powershell","snippet":"python scripts/validate_wallpaper.py <wallpaper-directory>"},{"language":"json","snippet":"{\n  \"id\": \"stable-track-id\",\n  \"title\": \"Track title\",\n  \"artist\": \"Artist\",\n  \"vocalist\": \"Optional vocalist\",\n  \"producer\": \"Optional producer or music creator\",\n  \"composer\": \"Optional composer\",\n  \"collectionId\": \"artist-or-creator-group\",\n  \"albumId\": \"album-id\",\n  \"trackNumber\": 1,\n  \"audio\": \"assets/audio/song.mp3\",\n  \"lyrics\": \"assets/lyrics/song.lrc\",\n  \"cover\": \"assets/covers/album.jpg\",\n  \"trackCover\": \"\",\n  \"accentColor\": \"#3388bb\",\n  \"sourceId\": \"material-record-id\"\n}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: create-music-web-wallpaper\ndescription: Create, rebuild, or refine interactive music and album-player wallpapers for Wallpaper Engine using HTML, CSS, and JavaScript. Use when an agent needs to turn user-provided or authorized music by bands, solo singers, vocalists, producers, composers, or other creators—together with album covers, audio, LRC lyrics, logos, and visual direction—into a Web wallpaper; build library navigation, synchronized lyrics, themes, optional motion, settings, localization, performance modes, and credits; or iterate on the interface through user feedback and Wallpaper Engine testing. Prefer Web wallpapers over Scene wallpapers for full music-player behavior, seeking, dynamic playlists, and lyric parsing.\n---\n\n# Create Music Web Wallpaper\n\nBuild a Wallpaper Engine **Web wallpaper** as a staged collaboration with the user. Preserve source assets, make attribution visible, and validate playback inside Wallpaper Engine rather than assuming ordinary-browser behavior is sufficient.\n\n## Load only the references needed\n\n- Read [references/wallpaper-engine-web.md](references/wallpaper-engine-web.md) before creating or changing a Wallpaper Engine project.\n- Read [references/catalog-and-assets.md](references/catalog-and-assets.md) when collecting, naming, matching, or importing covers, audio, logos, and lyrics.\n- Read [references/lyrics.md](references/lyrics.md) before implementing lyric parsing or synchronization.\n- Read [references/credits-and-rights.md](references/credits-and-rights.md) before adding third-party material or preparing a release.\n- Read [references/acceptance.md](references/acceptance.md) before handing off a build or claiming completion.\n\n## 1. Begin with an intake conversation\n\nDo not start a large build until the user has confirmed the direction. Ask only the questions that materially change the result:\n\n- wallpaper title, bands, solo singers, vocalists, producers, composers, other music creators, albums, and desired grouping;\n- paths to user-provided audio, covers, lyrics, logos, and fonts;\n- desired visual mood, colors, reference screenshots, and target resolutions;\n- lyric languages and whether the files are ordinary single-language LRC, same-timestamp bilingual LRC, or separately timed translations;\n- wallpaper author name and any additional credits;\n- minimum feature set and performance preference.\n\nRecommend collecting the highest-resolution legitimate album covers available. Ask for lossless logos when possible. Never silently replace user assets with approximate search results.\n\nIf online research is needed, use current official Wallpaper Engine documentation for platform behavior and authoritative or rights-holder sources for metadata. Do not download copyrighted audio or lyrics from unauthorized sources. Prefer user-supplied files.\n\n## 2. Choose Web wallpaper architecture\n\nUse HTML, CSS, and JavaScript when the requested wallpaper includes a music player, progress seeking, dynamic playlists, LRC"},{"path":"README.md","content":"# Music Web Wallpaper Builder\n\nEnglish | [简体中文](README.zh-CN.md)\n\n![Music Web Wallpaper Builder icon](assets/icon.png)\n\nAn Agent Skill that helps an AI Agent collaborate with a user to create **Wallpaper Engine music Web wallpapers**.\n\nProvide music you are authorized to use, LRC lyrics, album artwork, logos, and your design ideas. Then work with the Agent through conversation to build and refine a player, music library, synchronized lyrics, themes, motion, settings, localization, and performance optimizations. You do not need prior knowledge of HTML, CSS, or JavaScript, but you should still participate in asset review, interface decisions, and real testing inside Wallpaper Engine.\n\n## What it is for\n\nThis Skill is not limited to bands. It can also be used for:\n\n- solo artists, vocalists, and virtual singers;\n- composers, music producers, and other creators;\n- game, animation, or personal music collections;\n- single-album, multi-album, or creator-based libraries;\n- Wallpaper Engine projects that need a complete player, seeking, dynamic playlists, and lyric parsing.\n\nFor projects with these features, the Skill recommends a **Web wallpaper** rather than a Scene wallpaper by default.\n\n## Main capabilities\n\n- Design and refine the wallpaper interface in user-reviewed stages;\n- organize albums, tracks, creators, artwork, and material-source records;\n- assist with matching audio and lyric files while asking the user to resolve ambiguous matches;\n- inspect cover resolution, lyric encoding and timestamps, duplicate files, and missing assets;\n- build playback, pause, track switching, seeking, volume, playlists, shuffle, and related controls;\n- parse standard LRC lyrics and support original, translated, or bilingual display when requested;\n- add themes, cover motion, blurred backgrounds, visualizers, localization, and low-usage modes when selected by the user;\n- handle Wallpaper Engine properties, persistent state, and common aspect ratios;\n- check material credits, copyright notices, release structure, and basic runtime status;\n- continue refining the result through user feedback and real testing instead of applying a fixed template once.\n\n## What to prepare\n\nPrepare as many of the following as possible:\n\n1. Audio files you are authorized to use;\n2. LRC lyric files, although instrumental or lyricless tracks are also supported;\n3. The highest-resolution legitimate album or single artwork available;\n4. Optional transparent PNG or WebP logos, or vector SVG logos;\n5. Album names, track order, and artist or creator information;\n6. Material creators, source links, licenses, or permission details;\n7. Preferred colors, layout references, and target aspect ratios;\n8. The name of the actual wallpaper author.\n\nPreserve original source assets and do not overwrite them directly. Before a public release, all audio, lyrics, and images used by the final wallpaper must be copied into the wallpaper project. Published wallpapers cannot continue referencing unrelated absolut"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn71m3bs8dey1gfn54t300pn5h8d4wzb\",\n  \"slug\": \"create-music-web-wallpaper\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1787643505958\n}"},{"path":"references/acceptance.md","content":"# Acceptance checklist\n\n## Assets and catalog\n\n- Every catalog path exists and uses consistent casing.\n- No duplicate track IDs or unintended duplicate audio paths exist.\n- Album order and titles are verified.\n- High-resolution covers display without stretching or unintended cropping.\n- Every shipped asset is referenced or intentionally retained.\n\n## Playback and lyrics\n\n- Audio is audible in Wallpaper Engine, not only in Chrome.\n- Play, pause, previous, next, seeking, volume, repeat, and shuffle behave as specified.\n- Browsing another artist, creator, collection, or album does not interrupt playback unless designed to do so.\n- Rapid switching cannot display lyrics from the previous track.\n- Lyrics are checked at the beginning, middle, and end.\n- Ordinary imported LRC is not subjected to unrequested bilingual realignment.\n\n## Interface\n\n- Test 16:9, 16:10, 21:9, and at least one small desktop resolution.\n- Test mouse, wheel/touchpad, hover transitions, draggable panels, and stacking.\n- Menus remain above draggable content.\n- Light, dark, and cover-background themes preserve contrast.\n- State intended to persist survives wallpaper reload.\n\n## Performance\n\n- Measure idle, pointer interaction, and visualizer-on states.\n- Cap render loops and stop hidden effects.\n- Provide a low-usage mode when expensive optional effects exist.\n- Verify behavior at the Wallpaper Engine default FPS.\n\n## Localization and release\n\n- Wallpaper Engine property labels and in-wallpaper text use the intended languages.\n- Missing translations fall back predictably.\n- Preview metadata points to an existing file.\n- Visible credits include the actual wallpaper author, the OriginalCube reference when the starter/reference design was used, the discreet Skill credit, and material sources.\n- Workshop description matches the shipped behavior and attribution."},{"path":"references/catalog-and-assets.md","content":"# Catalog and asset workflow\n\n## Intake\n\nAsk the user to supply or authorize:\n\n- highest-resolution album and single covers for bands, solo singers, producers, composers, or other creators;\n- original audio files;\n- LRC or other lyric files;\n- vector or transparent logos;\n- desired author name and source records.\n\nDo not scrape copyrighted audio or lyrics from unauthorized mirrors. Record whether a file was supplied by the user, downloaded from a rights-holder page, recreated, converted, or AI-generated.\n\n## Matching order\n\nUse this order and ask for confirmation when ambiguous:\n\n1. normalized exact base-name match;\n2. track number plus album metadata;\n3. LRC `ti`, `ar`, and `al` tags;\n4. embedded audio metadata;\n5. similarity suggestion;\n6. manual selection.\n\nNever silently bind two plausible lyric files to one song.\n\n## Quality review\n\nUse `scripts/inventory_media.py` to report raster dimensions, vector status, lyric encoding and timestamp counts, optional audio metadata, and exact duplicate hashes. Treat warnings as review prompts:\n\n- prefer high-resolution covers when legitimate sources provide them;\n- verify that a small raster is not being stretched as a full cover;\n- distinguish deliberately small logos and icons from insufficient album artwork;\n- inspect non-UTF-8 or ambiguous lyric encoding before conversion;\n- confirm that an LRC contains usable timestamps;\n- compare exact duplicates before removing files.\n\nThe inventory tool may report that audio metadata was not inspected when the optional `mutagen` library is unavailable. The Agent can use another safe local metadata tool or ask the user for the missing title, artist, album, and order; this is not a reason to block the project.\n\n## Preferred catalog fields\n\n```json\n{\n  \"id\": \"stable-track-id\",\n  \"title\": \"Track title\",\n  \"artist\": \"Artist\",\n  \"vocalist\": \"Optional vocalist\",\n  \"producer\": \"Optional producer or music creator\",\n  \"composer\": \"Optional composer\",\n  \"collectionId\": \"artist-or-creator-group\",\n  \"albumId\": \"album-id\",\n  \"trackNumber\": 1,\n  \"audio\": \"assets/audio/song.mp3\",\n  \"lyrics\": \"assets/lyrics/song.lrc\",\n  \"cover\": \"assets/covers/album.jpg\",\n  \"trackCover\": \"\",\n  \"accentColor\": \"#3388bb\",\n  \"sourceId\": \"material-record-id\"\n}\n```\n\nUse a track-specific cover only when present; otherwise fall back to the album cover.\n\nThe Agent may build the catalog directly after reviewing the inventory. It should not pretend uncertain matches are confirmed. When filenames, tags, folders, and track lists disagree, show the alternatives to the user.\n\n## File handling\n\n- Preserve original files outside the project.\n- Copy only referenced release assets into the wallpaper project before publishing; Workshop subscribers cannot read the author's unrelated local source folders.\n- Normalize unsafe filenames only in the working copy and update catalog paths together.\n- Detect text encoding before declaring an LRC corrupted.\n- Hash or compare sizes before deleting apparent duplicates.\n- Do not "}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Build polished Wallpaper Engine music web wallpapers Skill: Music Web Wallpaper Builder Owner: zhilogic-oss Summary: Build polished Wallpaper Engine music web wallpapers Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-25T07:38:25.958Z | auto Initial release for create-music-web-wallpaper - Enables creation and refinement of interactive music and album-player wallpapers for Wallpaper Engine using HTML, CSS, and JavaScript. - Guides users through staged collaboratio","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1870,"uniquenessScore":46,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T11:41:43.778Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T11:41:43.778Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:15:20.359Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}