SkillFoxx

NetEase Cloud Music Agent Skills

Three NetEase Cloud Music skills: ncm-cli setup, music search and playback, and an assistant that recommends by taste

  • 267 ★ on the repository
  • Last commit
SkillOfficial

Extended access

Why this level

  • The skills work through a NetEase API key and an account login, control the player and create playlists
  • On a scheduling request the assistant writes jobs to crontab and files to ~/.config/ncm
  • The liked-track list reveals the user's tastes and is analysed by the model
All reasons and checks

netease/skillsAuthor:NetEase

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/netease-cloud-music-agent-skills

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The skills work through a NetEase API key and an account login, control the player and create playlists
  • On a scheduling request the assistant writes jobs to crontab and files to ~/.config/ncm
  • The liked-track list reveals the user's tastes and is analysed by the model

This is third-party code. Review the repository files before installing.

What it does

The NetEase/skills repository is an official set of NetEase Cloud Music skills on top of the ncm-cli console program. The ncm-cli-setup skill installs and configures ncm-cli when it is missing. The netease-music-cli skill searches songs, playlists and albums, controls playback (pause, next track, volume), manages the queue, creates playlists and adds tracks to them, and shows daily recommendations and user data. The third skill, netease-music-assistant, builds a smart helper on top of that layer. It analyses the list of liked tracks: counts genre tags, works out mood, languages and favourite artists, and looks at recent additions. Then it builds up to six search queries, runs several in parallel, drops what was already recommended or saved and explains the choice. It can send a recommendation to Feishu through OpenClaw and, with consent, write suitable tracks to a new playlist. The assistant also handles scheduling: rules go into ~/.config/ncm/ncm-schedule.json and are registered in crontab so picks arrive at the set time.

Who it is for. NetEase Cloud Music listeners who want an agent to control the player and playlists, and developers building a music-picks digest for Feishu.

Good fit when

  • You want to find a song or album and play it right away: the first track plays and the other finds go to the queue
  • An agent is asked to create a "Running" playlist and fill it with suitable tracks
  • You want a taste profile from your liked list: genres, mood, languages, favourite artists and the recent shift
  • Picks should arrive on a schedule in Feishu through OpenClaw

Not a fit when

  • You listen in Yandex Music or Spotify: the skills work only with NetEase Cloud Music
  • The agent must not change the system schedule: the assistant's timed digest writes jobs into crontab
  • You need one single command: calling ncm-cli directly is simpler than going through skills

Example request

Find calm instrumental tracks for work in NetEase Cloud Music, play the first one and queue the rest

Limitations

  • Node.js 18 or newer, ncm-cli and an API key (appId and privateKey) are required; the key is issued after developer registration on the NetEase Cloud Music open platform, whose pages are in Chinese.
  • The README and skills are written in Chinese, and the assistant activates on the words "网易云" or "云音乐" in a message.
  • Tracks flagged visible false do not play, and the skill tells the agent to skip them.
  • The last commit in the repository is from March 2026. The author does not describe installing the skills themselves.

How to disable. Remove the skills by deleting the ncm-cli-setup, netease-music-cli and netease-music-assistant folders from the agent's skills directory. npm uninstall -g @music163/ncm-cli removes the package. Digest jobs show up in crontab -l and are deleted by editing crontab.

FAQ

How do I connect the NetEase Cloud Music skills to an agent?

Install npm install -g @music163/ncm-cli, run ncm-cli configure and ncm-cli login, then add the skills with npx skills add NetEase/skills. If ncm-cli is not found, the netease-music-cli skill hands over to the ncm-cli-setup skill itself.

How do I check that I am logged in?

ncm-cli login --check shows the status. If there is no login the skill runs ncm-cli login --background, and if the API key is unset it asks you to finish setting it up.

Why does a track not play?

Unavailable songs carry visible false in the reply, and the skill forbids queueing or playing them. Ask the agent to find another version. The built-in player needs mpv installed, which the install_mpv.py script in ncm-cli-setup installs.

Which files does the assistant keep on disk?

The digest schedule lives in ~/.config/ncm/ncm-schedule.json, and ncm-history.json holds the IDs of playlists already recommended so they do not repeat. Preferences are saved to ncm-preference.json.

Why is an API key needed and where do I get one?

ncm-cli calls the NetEase API, so it needs an appId and privateKey. They are issued after developer registration on developer.music.163.com and entered with ncm-cli configure.

Discussion

No questions or reviews yet.

Skills

MCP server and skill that search songs, albums, lyrics and playback links across four Chinese music services

MCP serverExtended access118

A skill that teaches the agent to build narrated videos through narrator-ai-cli: source, template, music, voice, script and composing

SkillExtended access3.2K

29 skills for composing and arranging pop music: from a brief the agent fills in a spec sheet for Suno, YuE2 or MIDI

PluginMinimal access209

A Rust music server with MCP: an agent searches tracks, builds a queue and picks the next ones by tempo and energy.

MCP serverExtended access533

A pixel DJ for Claude Code and Codex that plays Apple Music, shows lyrics and reacts to commits and tests

SkillExtended access112
Official

A MiniMax skill that turns a short song description and tagged lyrics into a detailed prompt for the MiniMax Music 3 generator

SkillMinimal access1K

README in short

The Chinese README starts with a warning that you must install ncm-cli and register on the platform before use. Then come a table of the three skills, a diagram of their dependencies and a short description of each with its triggers and key rules. The assistant gets the longest section.

README badge

Original SKILL.md

---
name: netease-music-cli
description: 使用 ncm-cli 操作网易云音乐。当用户想播放歌曲、搜索歌曲、控制播放（暂停、下一首、上一首、调音量）、管理播放队列、查看播放状态、播放歌单时，使用此 skill。
---

# 网易云音乐 CLI（ncm-cli）

通过 `ncm-cli` 命令行工具操作网易云音乐，完成播放、搜索、队列管理等任务。

## 第一步：检查是否已安装

```bash
ncm-cli --version
```

如果命令不存在，调用 `ncm-cli-setup` skill 引导用户完成全部的安装，安装完成后再继续执行任务。


## 第二步：校验用户是否已登录

```bash
ncm-cli login --check
```
如果显示未登录，请先引导登录：

```bash
ncm-cli login --background
```

如果显示API key没有设置，请指引用户完成API key设置。
> 如果还没有 API Key，请先前往[网易云音乐开放平台](https://developer.music.163.com/st/developer/apply/account?type=INDIVIDUAL)申请 API Key（appId 和 privateKey）
```bash
ncm-cli config set appId <你的AppId>
ncm-cli config set privateKey <你的privateKey>
```

## 第三步：针对播放（play），需要特殊判断播放器逻辑

仅针对播放才执行该步骤。
通过以下命令判断用户的播放器是否是内置播放器（mpv）。
```bash
ncm-cli config get player
```
如果用户选择的播放器是内置播放器（mpv），则需要判断用户是否已安装mpv。
```bash
mpv --version
```
如果用户没安装，引导用户去安装mpv。

## 第四步：获取当前命令树

Report a problem