Changelog
Every release, newest first. Release notes are also on GitHub.
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]
[v2.1.0] - 2026-11-02
Added
- CLI: Claude Code profiles. A global Claude install asks “Do you use more than the default Claude (~/.claude)?”. Answer
yto pick profiles such as~/.claude-workand~/.claude-personalby number, or type the name afterclaude-. Several can be chosen at once, separated by commas. - CLI:
--profile <name>(-p) chooses Claude Code profiles without asking, for example--profile work,personal. Usedefaultfor~/.claude. Without a terminal and without the flag, skills go into~/.claude, andCLAUDE_CONFIG_DIRis used when it is set. - CLI:
update --globalanddoctor --globalcover every Claude profile, and a home folder with only~/.claude-*profiles counts as Claude Code. - Website docs: a “Claude Code profiles” section and the
--profileoption in the command reference.
Changed
- Website: command output examples on the docs page keep their columns and scroll sideways inside their box when a line is too long, with a shadow on the side that has more.
- Website: the docs page’s “On this page” navigation shows its scrollbar only while the pointer is over it.
- Website: the changelog page lists releases only and hides the
[Unreleased]section.
[v2.0.4] - 2026-11-01
Fixed
- Website scrolling on Android phones. The sticky header uses a solid background instead of a backdrop blur on touch screens, 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.
[v2.0.3] - 2026-11-01
Fixed
- Website feels faster on phones and tablets. The dot field behind the home page heading is drawn once instead of animating, which frees most of the main thread while the page is open. The heading fades up without the blur filter and its scramble finishes sooner. Content that appears on scroll fades in twice as fast, starts just before it reaches the screen, and no longer waits in turn on touch screens. Desktop keeps the full effects.
- Website pages load before you tap: links are prefetched as they scroll into view, and the fade between pages is shorter.
[v2.0.2] - 2026-11-01
Added
- Website docs cover the whole journey: requirements, a four-step quick start, a first-install section (checking Node.js, the first
npxrun, and the optional global install), choosing a tool, project or global installs, using a skill, checking, updating, sharing, and removing skills, the Claude Code plugin, manual install, troubleshooting, and a command reference. Output examples come from the real CLI.
Fixed
- Website on phones: only tables scroll sideways. Commands, output examples, code blocks, and the terminal’s tool and skill rows wrap instead, and tables stay inside the content width with a shadow on the side where more columns are hidden.
[v2.0.1] - 2026-11-01
Fixed
- Website: no more sideways scrolling on phones. Command blocks and long inline code on the home page, skill pages, docs, and changelog now stay inside the screen.
- Website: long skill names wrap on small screens, and docs tables scroll inside their own box.
Changed
- Website layout adapts to every screen size: content widens to 1320px from 1920px and 1440px from 2400px, headings scale fluidly, the terminal’s tool and skill rows scroll in one line on phones, and short landscape screens get a smaller heading and a header that does not stick.
- The click spark only appears on desktop (a mouse on a screen at least 1024px wide).
- README title is now “Musyskills - Must be Yours Skills”, and it opens with “Musyskills (Must be Yours Skills) is an open-source collection of AI agent skills”.
[v2.0.0] - 2026-11-01
Added
- Website (
web/, Astro and Tailwind CSS v4) with an interactive install terminal, a page per skill generated fromSKILL.md, docs, and the changelog. Navigation runs client-side without full reloads. Deployed to GitHub Pages by.github/workflows/pages.yml. - Website motion effects in the style of React Bits, written without React and kept monochrome: a dot field behind the hero 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 visitors who prefer reduced motion.
.gitattributesand.editorconfigthat keep every text file on LF line endings.
Changed
README.mdexplains the name, Musyskills = Must be Yours Skills, links each skill to its page on the website, and lists every tool’s skills folder in one table.- The validator checks the README’s “Available skills” table instead of
docs/skills.md.
Removed
- Breaking:
docs/skills.md. Skill documentation now lives on the website, athttps://ahmadammarm.github.io/musyskills/skills/<skill-name>/, generated from eachSKILL.md. Update any links to the old file.
[v1.4.1] - 2026-11-01
Security
- The npm publish workflow now uses trusted publishing (OIDC) instead of a stored
NPM_TOKEN, so no long-lived npm token exists in the repository. .gitignorenow 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.
[v1.4.0] - 2026-11-01
Added
musyskillsnpm CLI (packages/cli/):npx musyskills list | add | remove | update | doctor. Installs skills into Claude Code, Codex, Cursor, or Antigravity, detects the tool from the project, supports--global, and records installs in.musyskills.jsonso it never overwrites skills the user edited unless--forceis passed. Skills are bundled in the package.- CI tests the CLI on Linux, Windows, and macOS with Node 24 and 26, including a run from the packed tarball.
- Publish workflow (
.github/workflows/release.yml) that publishes the CLI to npm with provenance when av*tag is pushed. - Validator checks that
packages/cli/package.jsonuses the same version as the latest release.
[v1.3.0] - 2026-11-01
Added
- Claude Code plugin marketplace (
.claude-plugin/marketplace.jsonandplugin.json). Install all skills with/plugin marketplace add ahmadammarm/musyskillsand/plugin install musyskills@musyskills. skills/release: a workflow that picks the Semantic Versioning bump from[Unreleased], updates the changelog and version files, commits, tags, pushes after confirmation, and publishes release notes.- Validator checks the plugin manifests and that the
plugin.jsonversion matches the latest release inCHANGELOG.md.
[v1.2.1] - 2026-11-01
Added
- MIT
LICENSE. scripts/validate.mjs: checks skill frontmatter, required sections, slash commands, agent references, and thatskills/,README.md, anddocs/skills.mdlist the same skills.- CI workflow (
.github/workflows/ci.yml) that runs the validator on every push tomainand every pull request. templates/SKILL.mdandCONTRIBUTING.mdfor contributors.
Fixed
prd-generator: removed the/prdalias; the slash command is/prd-generator, matching the folder name.push-to-origin: the exclusion list now covers machine-local files from other agents (CLAUDE.local.md,.claude/settings.local.json,*.local.*in agent folders) and states that shared files such asCLAUDE.mdandAGENTS.mdare committed normally.
[v1.2.0] - 2026-11-01
Added
project-explanation: non-interactive mode. When the user asks for no questions, the skill ends the summary with a Recommended Next Step section and stops instead of waiting for input.
Fixed
push-to-origin: removed the reference to agit-agentthat this repository does not ship; the skill runs git commands directly.prd-generator: replaced the ambiguous “createdocs/or ask the user” instruction with a deterministic rule (use the user’s location if given, otherwise createdocs/).project-explanation: Output Format said “two phases” but listed three.docs/skills.md: skills are now listed in alphabetical order (prd-generatorwas out of place at the end).
[v1.1.0] - 2026-08-21
Added
- Added
skills/prd-generator: A workflow to systematically interview the user to draft and save a structured Product Requirements Document (PRD). - Documented
prd-generatorcomprehensively indocs/skills.md. - Added
prd-generatorto the Available Skills list inREADME.md.
[v1.0.0] - 2026-08-04
Added
- Initial release of the Musyskills repository.
- Added
skills/apply-review-feedback: A workflow for addressing code review comments accurately. - Added
skills/code-changes-review: A workflow for reviewing uncommitted or staged code against best practices. - Added
skills/explain-changes: A workflow for summarizing code diffs in plain language. - Added
skills/pr-draft: A workflow for preparing or updating Pull Request titles and descriptions. - Added
skills/project-explanation: A workflow for interactively exploring and explaining a codebase. - Added
skills/push-to-origin: A workflow for safely orchestrating commits and pushes with mandatory user confirmation. - Added comprehensive skill reference documentation in
docs/skills.md. - Added
README.mdwith installation guides specifically tailored for Antigravity CLI and Claude Code.