Agent skill

Music

by zhinjs in zhinjs/zhin

音乐搜索与分享能力。当用户想搜索歌曲、点歌、分享音乐、 听某首歌或查找歌手的歌时使用。支持 QQ 音乐和网易云音乐两个平台。

MITAuto-check passed

Install Music

skills CLI
$ npx skills add zhinjs/zhin --skill music -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zhinjs/zhin music --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zhinjs/zhin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/utils/music/skills/music .claude/skills/music && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
music
GitHub stars
136
Token cost
~208 tokens
SKILL.md length
37 words
Files
3
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

音乐搜索与分享能力。当用户想搜索歌曲、点歌、分享音乐、 听某首歌或查找歌手的歌时使用。支持 QQ 音乐和网易云音乐两个平台。

  • Works in 3 steps: search 和 share 的 source 必须一致。QQ 音乐搜到的 ID… → 分享需要 ID,不能直接用歌名。必须先搜索获取 ID。 → 用户没说平台时,默认用 QQ 音乐(source="qq")。
  • SKILL.md covers 工作流 and 易错点
  • Runs TypeScript scripts from its folder

What it does

Music is an agent skill from zhinjs/zhin. 音乐搜索与分享能力。当用户想搜索歌曲、点歌、分享音乐、 听某首歌或查找歌手的歌时使用。支持 QQ 音乐和网易云音乐两个平台。 即使用户只是说「来首歌」「点个歌」或提到某首歌的名字,也应触发。

Its SKILL.md is about 210 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `tools/music-search/index.ts` and `tools/music-share/index.ts`).

The repository describes itself as: AI-native TypeScript bot framework — one codebase for 20+ chat platforms (QQ, Discord, Telegram, Slack, WeChat…). Opt-in AI agent with MCP, tools & security policies. <10MB core. The licence is MIT.

Example prompts

  • “/music”

Requirements

  • Node.js

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. search 和 share 的 source 必须一致。QQ 音乐搜到的 ID 不能用网易云分享。
  2. 分享需要 ID,不能直接用歌名。必须先搜索获取 ID。
  3. 用户没说平台时,默认用 QQ 音乐(source="qq")。

What it can do on your machine

Read from SKILL.md and the folder at commit 9b480e7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Music loads about 208 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 37 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~208

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from zhinjs/zhin at commit 9b480e7, republished under its MIT licence (© zhinjs). 37 words, ~208 tokens.

Download SKILL.mdSave it as .claude/skills/music/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
music
description
音乐搜索与分享能力。当用户想搜索歌曲、点歌、分享音乐、 听某首歌或查找歌手的歌时使用。支持 QQ 音乐和网易云音乐两个平台。 即使用户只是说「来首歌」「点个歌」或提到某首歌的名字,也应触发。
keywords
music, 音乐, 歌曲, 搜索, 分享, QQ音乐, 网易云, 点歌, 听歌
tags
music, entertainment, media
tools
music-search, music-share

音乐搜索分享技能

搜索歌曲并以富文本卡片分享到聊天中。

工作流

典型的点歌流程是两步走:先搜后分享。

Example:

用户: 点一首周杰伦的晴天
步骤1: music_search(keyword="周杰伦 晴天", source="qq") → 获取歌曲列表
步骤2: music_share(id=搜索结果中的歌曲ID, source="qq") → 发送卡片
工具用途关键参数
music_search搜索歌曲keyword(关键词), source(qq/163), count(数量)
music_share分享歌曲id(歌曲 ID,来自搜索结果), source(qq/163)

易错点

  1. search 和 share 的 source 必须一致。QQ 音乐搜到的 ID 不能用网易云分享。
  2. 分享需要 ID,不能直接用歌名。必须先搜索获取 ID。
  3. 用户没说平台时,默认用 QQ 音乐(source="qq")。

© zhinjs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in plugins/utils/music/skills/music of zhinjs/zhin.

  • SKILL.md
  • tools/music-search/index.ts
  • tools/music-share/index.ts

Open the folder on GitHubat commit 9b480e7

Compare with similar skills

Music next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Music compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Music this skillzhinjs/zhin136—~208Automated safety check: PassMIT
Musichashgraph-online/awesome-codex-plugins1.3k—~2.7kAutomated safety check: PassApache-2.0
Musictadaspetra/loop2962 repos~827Automated safety check: PassMIT
Music Generation0xsline/OpenChatCut2.2k—~1.1kAutomated safety check: PassAGPL-3.0
MusicGTKottman/mortiflix-oss476—~4.6kAutomated safety check: PassAGPL-3.0
MusicbozhouDev/video-skills-toolkit150—~3.6kAutomated safety check: PassMIT

Similar skills

  • Music

    hashgraph-online/awesome-codex-plugins

    Make songs, themes and game scores for a Homie studio with ElevenLabs Music, through the creator's OWN ElevenLabs account — a composition plan for anything sung, a transcription check that every…

    1.3k GitHub stars~2.7k tokensUpdated today
    Media & CreativeAuto-check passed
  • Music

    tadaspetra/loop

    Generate music using ElevenLabs Music API. An agent skill from tadaspetra/loop.

    296 GitHub starsUsed in 2 repos~827 tokens
    Media & CreativeAuto-check passed
  • Music Generation

    0xsline/OpenChatCut

    Generates instrumentals, songs, soundtracks and covers through Mureka, MiniMax, Atlas Cloud or Sonilo using the `submit_music` tool.

    2.2k GitHub stars~1.1k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Music

    GTKottman/mortiflix-oss

    The music engine, for a song or a video's score. An agent skill from GTKottman/mortiflix-oss.

    476 GitHub stars~4.6k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Music

    bozhouDev/video-skills-toolkit

    Generate music using ElevenLabs Music API. An agent skill from bozhouDev/video-skills-toolkit.

    150 GitHub stars~3.6k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Music

    autonomous-ai/Physical-AI-Operating-System

    Play and stop music from YouTube through the device's speaker on user request.

    381 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

More from zhinjs/zhin

All 11 skills in this repo
  • Refactor existing Zhin.js plugins into a cleaner standard structure.

    136 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Migrate legacy Zhin.js plugins and projects to the convention-based Plugin Runtime — from usePlugin/getPlugin/addCommand/addMiddleware/addComponent/addTool/addCron/declareConfig/useContext and…

    136 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Zhin Audit

    zhinjs/zhin

    Audit Zhin.js changes for security, performance, lifecycle, and architecture regressions.

    136 GitHub stars~596 tokensUpdated yesterday
    Auto-check: notes
  • Implement Zhin.js plugins with Plugin Runtime. An agent skill from zhinjs/zhin.

    136 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • GitHub CLI

    zhinjs/zhin

    使用 gh CLI 处理内置 GitHub Tool 未覆盖的 Issue、PR、Release、Workflow、搜索和 API 操作。

    136 GitHub stars~366 tokensUpdated yesterday
    Auto-check passed
  • Wecom

    zhinjs/zhin

    企业微信平台管理能力。当用户在企业微信中请求用户信息查询、部门架构查询、 发送文本消息时使用。即使用户没有提到企业微信,只要上下文是企业微信/WeCom 场景且涉及用户查询、部门管理或消息发送,就应触发。

    136 GitHub stars~297 tokensUpdated yesterday
    Auto-check passed

Questions about Music

What does Music do?

音乐搜索与分享能力。当用户想搜索歌曲、点歌、分享音乐、 听某首歌或查找歌手的歌时使用。支持 QQ 音乐和网易云音乐两个平台。. Music is an agent skill from zhinjs/zhin.

How do I install Music in Claude Code?

Run `npx skills add zhinjs/zhin --skill music -a claude-code`. Or copy the skill folder (plugins/utils/music/skills/music in zhinjs/zhin) into .claude/skills/music in your project. Claude Code loads it when a task matches its description.

How do I install Music in Codex?

Run `npx skills add zhinjs/zhin --skill music -a codex`. Or copy the skill folder (plugins/utils/music/skills/music in zhinjs/zhin) into .agents/skills/music in your project. Codex loads it when a task matches its description.

Can I use Music in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zhinjs/zhin --skill music -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/music, .gemini/skills/music, .github/skills/music and .opencode/skills/music in your project.

What does Music need to run?

Going by SKILL.md and its folder, Music needs TypeScript for the scripts in its folder. Our summary lists: Node.js.

Does Music access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Music safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Music use?

Music is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Music use?

About 208 tokens (SKILL.md is roughly 832 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Music?

Skills that share tags, products or a category with Music: Music (hashgraph-online/awesome-codex-plugins, 1.3k stars), Music (tadaspetra/loop, 296 stars), Music Generation (0xsline/OpenChatCut, 2.2k stars) and Music (GTKottman/mortiflix-oss, 476 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Music?

zhinjs (a GitHub organization) maintains it in zhinjs/zhin, which has 136 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: zhinjs/zhin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.