skills.rest
nnsi
nnsiCOMMUNITY
Explore all skills by this author →
GitHub

bms-diff-install

Install BMS chart differentials from beatoraja difficulty tables into music folders.

6|1|Updated May 19, 2026
Search Tags:#automation#beatoraja#bms#downloading#file placement#web orchestration#songdata.db
One-click install
npx skills add https://github.com/nnsi/bms-diff-install-cc-skill --skill bms-diff-install
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bms-diff-install
Source: https://github.com/nnsi/bms-diff-install-cc-skill/tree/main
Command: npx skills add https://github.com/nnsi/bms-diff-install-cc-skill --skill bms-diff-install

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It removes the tedious manual work of installing BMS chart differentials from a beatoraja-compatible difficulty table by automatically downloading, matching parent songs, and placing the resulting chart files into the correct music folders.

Core Features & Use Cases

  • Difficulty-table-driven batch install: Reads a difficulty table header.json, processes each entry, downloads url_diff, extracts chart and related assets, and places charts into matched parent folders without overwriting existing files.
  • Parent-song auto-install (optional): When a differential references a parent that is not installed, it can resolve parent URLs via host adapters (manbow/venue.bmssearch/GDrive/Dropbox/archive.org) and download and install the parent songs too.
  • Disambiguation with Haiku subagent: Uses deterministic scoring for clear matches and delegates ambiguous cases to a Haiku subagent to decide the correct parent folder.
  • Optional songdata.db registration: After placement, can run the built-in songdb pipeline to insert fully populated rows into beatoraja’s songdata.db so charts appear without an expensive full rescan.

Quick Start

Ask the skill to install charts by providing the difficulty table header.json URL, the beatoraja songdata.db path, your music root folder path, and a writable state directory, then run the skill to complete dry-run, parent installation (if needed), placement, and reporting.

Frequently Asked Questions about bms-diff-install

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

FAQPage Schema
How do I batch install BMS chart differentials from a difficulty table into beatoraja?▼

Batch installing BMS chart differentials is handled by reading a difficulty table header.json, downloading url_diff artifacts, and placing the chart files into matched parent song folders within your beatoraja music library.

How does automatic BMS differential matching find the correct parent song folder?▼

BMS differential matching works by analyzing #WAV keysound filename references inside the chart to deterministically score and match the correct parent song folder, delegating ambiguous cases to a Haiku subagent for disambiguation.

Can I automatically download and install missing parent BMS songs referenced by a difficulty table?▼

Yes, you can automatically install missing parent BMS songs by resolving parent URLs through host adapters like manbow, venue.bmssearch, GDrive, Dropbox, and archive.org, with multi-agent browser fallbacks for difficult cases.

What do I need to provide to automate BMS chart placement and songdata.db registration?▼

To automate BMS chart placement and songdata.db registration, you need to provide a difficulty table header.json URL, your beatoraja songdata.db path, your music root folder path, and a writable state directory.

Does installing BMS differentials overwrite existing chart files or keysounds in my music library?▼

No, installing BMS differentials uses safe non-overwriting file placement logic to ensure that existing chart files and keysounds in your matched parent folders are not overwritten during the batch installation process.

How do I add BMS differential charts to beatoraja's songdata.db without a full library rescan?▼

You can add BMS differential charts to beatoraja's songdata.db without a full rescan by running the built-in songdb pipeline to upsert fully populated rows directly into the database after file placement.

Related Skills

Explore More Software Engineering Skills→
base44base44
86

sync-sdk-skill

Synchronize the Base44 SDK skill with the latest SDK source code.

Official
Advanced
Aken-TeamsAken-Teams

Excel Spreadsheet Generator

Translate natural-language spreadsheet specifications into XLSX files.

Official
Intermediate
hemoryhemory

agent-browser

Displays a list of available commands for the specified tool.

Community
Intermediate
dragosrouadragosroua
14

astro-cta-injector

Inject CTA templates into Astro content with configurable placements and dry-run previews.

Community
Advanced