Skip to content

Releases

v2.1.0

Choose a tag to compare

@ahmadammarm ahmadammarm released this 02 Nov 10:07

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 n to keep using ~/.claude. Answer y to pick profiles by number or by the name after claude-, several at once.
  • --profile <name> (-p) skips the question, for example npx musyskills add --all --global --profile work,personal. Use default for ~/.claude.
  • Without a terminal and without --profile, skills go into ~/.claude. When CLAUDE_CONFIG_DIR is set, that folder is used without asking.
  • update --global and doctor --global cover every profile. Project installs are not affected.

Website

  • Docs: a new Claude Code profiles section and --profile in 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

Choose a tag to compare

@ahmadammarm ahmadammarm released this 01 Nov 09:08

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

Choose a tag to compare

@ahmadammarm ahmadammarm released this 01 Nov 09:48

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

Choose a tag to compare

@ahmadammarm ahmadammarm released this 01 Nov 07:18

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 musyskills run, and the optional npm 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

Choose a tag to compare

@ahmadammarm ahmadammarm released this 01 Nov 07:01

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

Choose a tag to compare

@ahmadammarm ahmadammarm released this 01 Nov 06:50

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 add installs 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.

Breaking Changes

  • docs/skills.md is removed. Skill documentation now lives at https://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.
  • .gitattributes and .editorconfig keep every file on LF line endings.

Full Changelog: v1.4.1...v2.0.0

v1.4.1

Choose a tag to compare

@ahmadammarm ahmadammarm released this 01 Nov 06:12

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 *.txt files so local notes, such as recovery codes, are not committed by accident.

Changed

  • GitHub Actions updated to actions/checkout@v7 and actions/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

Choose a tag to compare

@ahmadammarm ahmadammarm released this 01 Nov 05:45

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

  • musyskills CLI: npx musyskills add pr-draft push-to-origin or npx musyskills add --all. Also list, remove, update, and doctor.
    • Detects the tool from the project, or choose with --tool claude|codex|cursor|antigravity; --global installs for your user.
    • Records installs in .musyskills.json and 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.

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

Choose a tag to compare

@ahmadammarm ahmadammarm released this 01 Nov 04:46

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/musyskills then /plugin install musyskills@musyskills. Skills are available as /musyskills:<skill>. Update with /plugin marketplace update musyskills.
  • release skill (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.json version in sync with CHANGELOG.md.

Full Changelog: v1.2.1...v1.3.0

v1.2.1

Choose a tag to compare

@ahmadammarm ahmadammarm released this 01 Nov 04:41

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 /prd alias, 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 as CLAUDE.md and AGENTS.md are 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 that skills/, README.md, and docs/skills.md list the same skills. Requires only Node 18+.
  • CI: GitHub Actions runs the validator on every push to main and every pull request.
  • Contributing: Added templates/SKILL.md and CONTRIBUTING.md.

Full Changelog: v1.2.0...v1.2.1