← 返回 Skills 市场
dahuangfortoby

Music Analysis

作者 dahuangForToby · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
93
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install music-analysis-84
功能描述
Analyze music/audio files locally without external APIs. Extract tempo, pocket/groove feel, pulse stability, swing proxy, section/repetition structure, key c...
安全使用建议
This skill appears to implement the advertised local audio analysis (librosa-based features, temporal analysis, optional Whisper transcription). However: 1) Inspect setup.sh before running — it will create a virtualenv, pip install packages, download a ~1.5GB Whisper model from huggingface.co, and append aliases to ~/.zshrc; the script uses a hard-coded SKILL_DIR (/Users/huang/...), so it will likely fail or write unexpected files on your machine unless you edit it. 2) If you don't want the aliases or files in your home, do not run setup.sh as-is; instead create a venv manually, pip install requirements.txt, and run the scripts from a controlled directory. 3) The tool invokes ffmpeg/ffprobe and whisper-cli (optional); ensure you trust these binaries and verify their provenance. 4) The skill does not request credentials, nor does it clearly exfiltrate data, but it does perform network downloads during setup (model binary) and suggests using yt-dlp for audio sourcing. Recommendation: treat the package as useful but potentially intrusive — run it in a dedicated environment or container, review and adapt setup.sh (remove or fix hard-coded paths and ~/.zshrc modifications), and verify external downloads before executing them.
功能分析
Type: OpenClaw Skill Name: music-analysis-84 Version: 1.0.0 The music-analysis skill bundle provides a comprehensive suite for local audio analysis, including groove detection, structural mapping, and lyric transcription using Whisper. The code uses standard libraries (librosa, numpy) and external utilities (ffmpeg, whisper-cli) to process audio files as described. While the setup.sh script contains hardcoded paths specific to a developer's environment (/Users/huang) and modifies the user's shell configuration (~/.zshrc) to add convenience aliases, these actions are transparently aligned with the tool's stated purpose and do not exhibit malicious intent such as data exfiltration or unauthorized remote control.
能力评估
Purpose & Capability
The name/description (local music/audio analysis) matches the code: Python scripts use librosa, numpy, ffmpeg/ffprobe and optionally Whisper for transcription. That is coherent. Notes of concern: the setup.sh uses a hard-coded SKILL_DIR (/Users/huang/.openclaw/workspace/skills/music-analysis) and writes aliases to ~/.zshrc; those filesystem targets are specific and not declared in metadata. The SKILL.md suggests using yt-dlp for sourcing audio (external downloads) though yt-dlp is not installed by the skill — this is reasonable but should be explicit.
Instruction Scope
SKILL.md and scripts operate on local audio files and call ffmpeg/ffprobe and an optional whisper-cli; they do not contain code that exfiltrates analysis to external endpoints. Whisper usage and a model file are expected to be local; however SKILL.md and setup.sh instruct downloading large model binaries and suggest using yt-dlp to fetch YouTube audio (network actions). The scripts also modify/inspect user files (via setup.sh) and create temp files. No instructions ask for unrelated system credentials or to read arbitrary unrelated files, but the install script modifies shell config.
Install Mechanism
There is no registry install spec, but an included setup.sh performs actions: creates a venv, pip installs packages from PyPI, and curl-downloads a ~1.5GB Whisper binary from huggingface.co (a well-known host). Downloading a large prebuilt model is higher-risk than pure pip installs but the URL points to an expected Whisper/C++ model. The script expects brew-managed whisper-cli/ffmpeg or instructs how to install them. No obfuscated or shortener URLs found.
Credentials
The skill does not request environment variables or credentials. It does rely on certain filesystem locations (WHISPER model under ~/.local/share/whisper-cpp and the hard-coded SKILL_DIR) and presence of ffmpeg/whisper-cli. Because it writes aliases to ~/.zshrc and assumes a specific /Users/huang path, the requested filesystem access is broader than strictly necessary for a generic, relocatable skill.
Persistence & Privilege
The skill is not force-enabled (always: false), but setup.sh modifies the user's ~/.zshrc to add aliases and creates a venv at a hard-coded path. Those actions change the user's shell environment and drop files into the home/workspace; they increase persistence and have side effects beyond simply running analysis. This is legitimate for a local developer convenience script but should be flagged to users who expect non-invasive install behavior.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install music-analysis-84
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /music-analysis-84 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of music-analysis: structured, local audio analysis without external APIs. - Supports comprehensive music/audio file analysis via a single script, including tempo, structure, harmonic tension, timbre, and emotional reads - Integrates Whisper-based lyric transcription; filtered lyrics can influence emotional analysis when confidence is high - Outputs structured human-readable reports with detailed sections: snapshot, instrument read, temporal journey, emotional read, lyrics, synthesis, and aligned timeline - Includes standalone modes for fast snapshot analysis or temporal (windowed) mood/tension mapping - Designed for local use; requires only standard Python libraries (librosa, numpy) and system tools (ffmpeg) - Ensures graceful fallback if lyric transcription is unavailable and maintains clean workspace hygiene
元数据
Slug music-analysis-84
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Music Analysis 是什么?

Analyze music/audio files locally without external APIs. Extract tempo, pocket/groove feel, pulse stability, swing proxy, section/repetition structure, key c... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 93 次。

如何安装 Music Analysis?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install music-analysis-84」即可一键安装,无需额外配置。

Music Analysis 是免费的吗?

是的,Music Analysis 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Music Analysis 支持哪些平台?

Music Analysis 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Music Analysis?

由 dahuangForToby(@dahuangfortoby)开发并维护,当前版本 v1.0.0。

💬 留言讨论