Repository navigation
Releases
v2.1.0
Release v2.1.0 - Claude Code profiles
This minor release lets the CLI install into several Claude Code profiles, such as ~/.claude-work and ~/.claude-personal, and polishes the website docs and changelog.
Claude Code profiles
- A global Claude install now asks whether you use more than the default Claude:
Do you use more than the default Claude (~/.claude)? (y/N) y Claude profiles in your home folder: 1) claude ~/.claude 2) claude-personal ~/.claude-personal 3) claude-work ~/.claude-work Pick numbers, or type the name after "claude-". Separate several with commas. claude-work,personal - Answer
nto keep using~/.claude. Answeryto pick profiles by number or by the name afterclaude-, several at once. --profile <name>(-p) skips the question, for examplenpx musyskills add --all --global --profile work,personal. Usedefaultfor~/.claude.- Without a terminal and without
--profile, skills go into~/.claude. WhenCLAUDE_CONFIG_DIRis set, that folder is used without asking. update --globalanddoctor --globalcover every profile. Project installs are not affected.
Website
- Docs: a new Claude Code profiles section and
--profilein the command reference. - Command output examples keep their columns and scroll sideways inside their box on small screens.
- The docs page's "On this page" navigation shows its scrollbar only on hover.
- The changelog page lists releases only and hides
[Unreleased].
Full Changelog: v2.0.4...v2.1.0
v2.0.4
Release v2.0.4 - Smoother scrolling on Android
This patch release makes scrolling smoother on Android phones. Skills, the CLI, and the plugin are unchanged.
Performance
- On touch screens the sticky header uses a solid background instead of a backdrop blur, so the GPU no longer re-blurs the page under it on every scroll frame. This affects every page.
- The still dot field behind the home page heading is drawn at 1x on touch screens, a quarter of the memory it used before.
- Text no longer uses
text-rendering: optimizeLegibility, which slows down rendering of long pages on Android.
Desktop looks and behaves the same as before.
Full Changelog: v2.0.3...v2.0.4
v2.0.3
Release v2.0.3 - Faster website on phones
This patch release makes the website feel faster on phones and tablets. Skills, the CLI, and the plugin are unchanged.
Performance
- The dot field behind the home page heading is drawn once on touch screens instead of animating. While the page is open the main thread is now mostly idle (26% busy before, 4% now, measured on a phone profile with a slowed CPU).
- On touch screens the home page heading fades up without the blur filter, and its scramble finishes in about 0.6 seconds instead of 1.1.
- Content that appears on scroll fades in twice as fast, starts just before it reaches the screen, and appears together on touch screens instead of one item after another.
- Links are prefetched as they scroll into view, so a tap opens the next page without waiting for the network, and the fade between pages is shorter.
Desktop keeps the full effects, and reduced motion still turns all motion off.
Full Changelog: v2.0.2...v2.0.3
v2.0.2
Release v2.0.2 - Complete docs
This patch release completes the website docs and fixes sideways scrolling on phones. Skills, the CLI, and the plugin are unchanged.
Docs
- The docs page now covers the whole journey, from the first install to removing the last skill:
- Requirements and a four-step quick start.
- First install: checking Node.js, the first
npx musyskillsrun, and the optionalnpm install -g musyskills. - Choosing a tool, project or global installs, and where skills go.
- Using a skill, checking your install, updating, keeping your edits, sharing with your team, and removing skills.
- The Claude Code plugin (install, update, uninstall), manual install, troubleshooting, and a command reference with exit codes.
- Output examples come from the real CLI.
Fixes
- On phones only tables scroll sideways. Commands, output examples, code blocks, and the terminal's tool and skill rows wrap instead.
- Tables stay inside the content width and show a shadow on the side where more columns are hidden.
Full Changelog: v2.0.1...v2.0.2
v2.0.1
Release v2.0.1 - Responsive website
This patch release makes the website work well on every screen, from small phones to ultrawide monitors. Skills, the CLI, and the plugin are unchanged.
Fixes
- No more sideways scrolling on phones: command blocks and long inline code stay inside the screen on every page.
- Long skill names wrap on small screens, and docs tables scroll inside their own box.
Changes
- Content widens on large screens (1320px from 1920px, 1440px from 2400px) and headings scale fluidly.
- The terminal's tool and skill rows scroll in one line on phones.
- Landscape phones get a smaller heading and a header that does not stick.
- The click spark only appears on desktop.
- README now opens with "Musyskills (Must be Yours Skills) is an open-source collection of AI agent skills".
Full Changelog: v2.0.0...v2.0.1
v2.0.0
Release v2.0.0 - Musyskills website
Musyskills stands for Must be Yours Skills: the AI agent skills every developer should own. This major release adds the project website and moves skill documentation onto it.
New Features
- Website: https://ahmadammarm.github.io/musyskills
- An interactive terminal shows exactly where
npx musyskills addinstalls each skill for Claude Code, Codex, Cursor, and Antigravity. - Every skill has its own page, generated from its
SKILL.md, plus docs and the changelog. - Monochrome motion effects: a dot field that reacts to the pointer, decrypted and blur-in headings, spotlight skill cards, scroll reveal, magnetic buttons, and a click spark. All of it turns off for reduced motion.
- Pages switch in the browser without full reloads.
- An interactive terminal shows exactly where
Breaking Changes
docs/skills.mdis removed. Skill documentation now lives athttps://ahmadammarm.github.io/musyskills/skills/<skill-name>/. Update any links to the old file. Skills, the CLI, and the plugin work exactly as before.
Project
- README explains the name and links each skill to its page.
.gitattributesand.editorconfigkeep every file on LF line endings.
Full Changelog: v1.4.1...v2.0.0
v1.4.1
Release v1.4.1 - Trusted Publishing
This patch release hardens how Musyskills is published. There are no changes to the skills or the CLI behavior.
Security
- Trusted publishing: The npm package is now published from GitHub Actions through OpenID Connect. No long-lived npm token is stored in the repository, and every release keeps its provenance statement.
.gitignore: Ignores*.txtfiles so local notes, such as recovery codes, are not committed by accident.
Changed
- GitHub Actions updated to
actions/checkout@v7andactions/setup-node@v7, which run on Node 24 instead of the deprecated Node 20.
Full Changelog: v1.4.0...v1.4.1
v1.4.0
Release v1.4.0 - musyskills npm CLI
This minor release adds a command-line installer that works with Claude Code, Codex, Cursor, and Antigravity.
New Features
musyskillsCLI:npx musyskills add pr-draft push-to-originornpx musyskills add --all. Alsolist,remove,update, anddoctor.- Detects the tool from the project, or choose with
--tool claude|codex|cursor|antigravity;--globalinstalls for your user. - Records installs in
.musyskills.jsonand never overwrites a skill you edited unless you pass--force. - Skills are bundled in the package, so it works offline. Requires Node.js 24 or later.
- Detects the tool from the project, or choose with
Project
- CI tests the CLI on Linux, Windows, and macOS with Node 24 and 26, including a run from the packed tarball.
- Tagged releases publish to npm with provenance.
Full Changelog: v1.3.0...v1.4.0
v1.3.0
Release v1.3.0 - Claude Code Plugin and Release Skill
This minor release makes Musyskills installable as a Claude Code plugin and adds a skill for cutting releases.
New Features
- Claude Code plugin: Install all skills with
/plugin marketplace add ahmadammarm/musyskillsthen/plugin install musyskills@musyskills. Skills are available as/musyskills:<skill>. Update with/plugin marketplace update musyskills. releaseskill (skills/release): Picks the SemVer bump from[Unreleased], updates the changelog and version files, commits, tags, pushes after confirmation, and publishes release notes.
Project
- The validator now checks the plugin manifests and keeps the
plugin.jsonversion in sync withCHANGELOG.md.
Full Changelog: v1.2.1...v1.3.0
v1.2.1
Release v1.2.1 - Validator, CI and License
This patch release fixes two skill issues and adds the tooling that keeps skills consistent.
Fixes
prd-generator: Removed the/prdalias, which tools do not support. The slash command is/prd-generator, matching the folder name.push-to-origin: The exclusion list now covers machine-local agent files (CLAUDE.local.md,.claude/settings.local.json,*.local.*in agent folders). Shared files such asCLAUDE.mdandAGENTS.mdare still committed normally.
Project
- License: Musyskills is now released under the MIT License.
- Validator (
scripts/validate.mjs): Checks frontmatter, required sections, slash commands, agent references, and thatskills/,README.md, anddocs/skills.mdlist the same skills. Requires only Node 18+. - CI: GitHub Actions runs the validator on every push to
mainand every pull request. - Contributing: Added
templates/SKILL.mdandCONTRIBUTING.md.
Full Changelog: v1.2.0...v1.2.1