{"id":49342340,"url":"https://github.com/boylegu/moonwalk-skill","last_synced_at":"2026-04-27T05:03:15.339Z","repository":{"id":352455041,"uuid":"1214223916","full_name":"boylegu/moonwalk-skill","owner":"boylegu","description":"Moonwalk Skill is a Claude Code plugin for Michael Jackson music discovery. It reads simple mood cues, recommends 2-4 fitting MJ songs, adds a brief emotionally aware line when useful, and opens the selected track through supported music providers.","archived":false,"fork":false,"pushed_at":"2026-04-19T16:21:21.000Z","size":3712,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-19T18:28:30.887Z","etag":null,"topics":["ai","ai-agent","ai-tool","ai-tools","aitool","claude","claude-code","music","music-skills","skill"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boylegu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-18T09:26:21.000Z","updated_at":"2026-04-19T16:21:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/boylegu/moonwalk-skill","commit_stats":null,"previous_names":["boylegu/moonwalk-skill"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/boylegu/moonwalk-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boylegu%2Fmoonwalk-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boylegu%2Fmoonwalk-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boylegu%2Fmoonwalk-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boylegu%2Fmoonwalk-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boylegu","download_url":"https://codeload.github.com/boylegu/moonwalk-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boylegu%2Fmoonwalk-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32323215,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","ai-tool","ai-tools","aitool","claude","claude-code","music","music-skills","skill"],"created_at":"2026-04-27T05:03:14.596Z","updated_at":"2026-04-27T05:03:15.329Z","avatar_url":"https://github.com/boylegu.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://cdn.jsdelivr.net/gh/boylegu/moonwalk-skill/assets/mjskill.png?raw=true\" width=\"300\" height=\"300\" alt=\"Moonwalk Skill preview\"\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-green?style=for-the-badge\" alt=\"license\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-Claude%20Code-blue?style=for-the-badge\" alt=\"platform\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/type-plugin-orange?style=for-the-badge\" alt=\"type\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/status-active-success?style=for-the-badge\" alt=\"status\" /\u003e\n\u003c/p\u003e\n\u003c/div\u003e\n\n# moonwalk-skill\n\nEnglish | [简体中文](./README.zh-CN.md)\n\nMoonwalk Skill is a Claude Code plugin focused on Michael Jackson music. It reads simple mood cues, recommends fitting songs, and opens the selected track fast.\n\nThis project is an independent fan-made plugin. It is not affiliated with, endorsed by, or sponsored by the Michael Jackson Estate or any official rights holder.\n\n## Launch Video Made with HyperFrames\n\n[![Moonwalk Skill demo](./assets/moonwalk-demo.gif)](https://vimeo.com/1184540755?fl=ip\u0026fe=ec)\n\nWatch the full Vimeo demo along with my original track \"code with rhythm\": [`vimeo.com/1184540755`](https://vimeo.com/1184540755?fl=ip\u0026fe=ec)\n\n## What It Does\n\n- Recommends 2-4 songs based on mood, context, or activity\n- Supports direct song requests such as `Billie Jean` and `Human Nature`\n- Adds a short, restrained emotional line when you sound tired, low, stressed, or nostalgic\n- Opens the selected song through a supported music provider\n- Supports both natural-language use and direct `/moonwalk-skill:mj` invocation\n\n## When You'd Use It\n\nUse it when you want the right song without overthinking the request:\n\n- You already know the song and want it opened quickly\n- You want a few picks for coding, focus, late night, or winding down\n- You want something softer after a rough day\n- You want recommendations from a single, consistent catalog instead of doing general music search\n\nTypical requests look like this:\n\n```text\nplay Billie Jean\nsomething for coding\nsomething softer for late night\nI had a rough day, play something gentle\n/moonwalk-skill:mj Billie Jean\n```\n\n## How It Responds\n\nNatural language is the default entry point.\n\n1. If you name a song, it opens that song directly.\n2. If you describe a mood, activity, or moment, it recommends 2-4 songs first.\n3. If the tone sounds personal, it adds one short, restrained line before the recommendations.\n4. If you say yes, it opens the top pick.\n\nThe plugin is intentionally narrow. It is for Michael Jackson music requests, not general music playback or artist discovery.\n\n## Supported Providers\n\n- `auto`\n- `youtube`\n- `ytmusic`\n- `spotify`\n- `apple`\n- `qq`\n- `netease`\n\nAuto-routing rules:\n\n- Chinese requests default to `qq`\n- English requests default to `apple` on macOS\n- English requests default to `spotify` on non-macOS platforms\n- An explicitly requested provider always wins\n\nOpen behavior:\n\n- `spotify` tries the local Spotify app first, then falls back to web search\n- `apple` tries the Music app first, then falls back to web search\n- `qq`, `netease`, `youtube`, and `ytmusic` open web search directly\n\n## Behavior and Limits\n\n- This project does not host or distribute any music\n- This project is independent and not an official Michael Jackson product\n- Playback redirects to external platforms such as Apple Music, Spotify, QQ Music, NetEase, or YouTube\n- Actual open behavior depends on the local OS, browser, and installed music apps\n- Some providers may open a search page instead of direct playback\n- The plugin only handles Michael Jackson music requests\n\n## Installation\n\nTo install from GitHub, first add this repository to your local marketplace sources:\n\n```text\n/plugin marketplace add boylegu/moonwalk-skill\n```\n\nThen install the plugin:\n\n```text\n/plugin install moonwalk-skill@mj-music\n```\n\n`marketplace add` only registers the repository in your local Claude Code environment. Other people still need to add the same source on their side before they can install from it.\n\nIf the marketplace catalog changes, refresh the local marketplace entry:\n\n```text\n/plugin marketplace update mj-music\n```\n\nIf the plugin itself releases a new version, update the installed copy:\n\n```text\n/plugin update moonwalk-skill@mj-music\n```\n\n## Usage Modes\n\n### Natural language\n\nThis is the default and recommended mode. Claude should auto-trigger the skill when your request is clearly about Michael Jackson music.\n\n### Direct skill invocation\n\nUse this mainly for debugging or forcing the skill to run:\n\n```text\n/moonwalk-skill:mj Billie Jean\n/moonwalk-skill:mj coding\n/moonwalk-skill:mj I had a rough day, give me some MJ\n```\n\n## Local Commands\n\nAdd `bin/` to `PATH` first:\n\n```bash\nexport PATH=\"$PWD/bin:$PATH\"\n```\n\n### `mj-recommend`\n\nReturn 2-4 MJ songs for a mood or context:\n\n```bash\nmj-recommend coding\nmj-recommend \"I had a rough day and feel tired\"\n```\n\n### `mj-open`\n\nOpen a song with a provider:\n\n```bash\nmj-open \"Billie Jean\"\nmj-open --provider auto \"Billie Jean\"\nmj-open --provider spotify \"Billie Jean\"\n```\n\n### `mj-status`\n\nPrint the latest plugin status line:\n\n```bash\nmj-status\n```\n\n### `mj-watch`\n\nRefresh the latest status in a loop:\n\n```bash\nmj-watch\n```\n\n### `debug.sh`\n\nRun quick syntax, JSON, and sample-command checks:\n\n```bash\nbash ./bin/debug.sh\n```\n\n## Expanding the Song Library\n\nIf you want to add more songs, edit [`data/songs.json`](./data/songs.json).\n\nEach entry should stay in this shape:\n\n```json\n{\n  \"title\": \"Song Title\",\n  \"tags\": [\"coding\", \"night\", \"comfort\"]\n}\n```\n\nKeep the tags short and consistent with the existing vocabulary. Reusing current tags is better than inventing near-duplicates, because recommendations depend on those tag matches.\n\nAfter updating the file, run:\n\n```bash\npython3 -m json.tool data/songs.json \u003e/dev/null\nbash ./bin/debug.sh\n```\n\n## Validation\n\nUseful checks from the repository root:\n\n```bash\nbash -n bin/mj-open.sh\nbash -n bin/mj-recommend\npython3 -m json.tool .claude-plugin/plugin.json \u003e/dev/null\npython3 -m json.tool .claude-plugin/marketplace.json \u003e/dev/null\npython3 -m json.tool data/songs.json \u003e/dev/null\nbash ./bin/debug.sh\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboylegu%2Fmoonwalk-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboylegu%2Fmoonwalk-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboylegu%2Fmoonwalk-skill/lists"}