joeseesun/qiaomu-suno-master

This project, written mostly in shell and Python scripts but distributed as a JavaScript-installable Agent Skill, helps a user turn a rough song idea into a finished track on Suno. Suno is an online service that generates music from a text prompt. The skill, called qiaomu-suno-master, wraps a separate command-line tool that talks to Suno, and adds the missing layer above it: the structured lyrics, the style tags, and the list of styles to avoid. The author's point is that writing one line of lyrics is not the hard part. The hard part is producing the whole package Suno needs to make a good song: a chorus, verses, a bridge, a hook, a description like punk-rock with male vocals and distorted guitars, an exclude list like auto-tune or trap, plus a few title options. The skill produces all of that from a plain-language request such as write a punk song about turning the volume up, or turn this article into a Chinese folk song. Installation is one command, npx skills add joeseesun/qiaomu-suno-master, which drops the files under a folder in the user's home directory. Before it works, the user needs the Rust-based suno command-line tool installed through cargo, and a logged-in Suno account. Optionally, the skill can reuse an already-open Chrome session through Chrome's remote debugging port, so the user does not have to re-authenticate every time. When the user does not know what style they want, a helper script called find_music_genres.py searches a built-in database of more than 5000 musical genres (sourced from a sister project, music-genre-finder) and suggests matching Suno tags. Another wrapper script, generate_with_suno.sh, then takes the title, tags, exclude list, and lyrics file and runs the actual generation. By default, finished songs land in ~/Documents/Suno/ under a folder named after the title. A second script, export_suno_assets.py, works on songs the user has already generated: given a Suno clip ID, it can pull down the audio file, the video or MTV clip if Suno provides one, the timed lyrics as JSON, LRC and SRT subtitle files, a cleaned SRT, and a Markdown version with timestamps. The README notes that generation uses Suno account credit, that Chrome remote debugging is a powerful permission that should only run on a trusted machine, and that Suno's web flow can change without warning.