plugin-maintenance

To maintain Claude Code plugin documentation, update workflow steps, tool lists, and lifecycle guidance across both plugin and standalone skill docs when adding MCP tools. This prevents inconsistent tool or lifecycle guidance across releases by keeping all repository paths synchronized.

Synapse plugin hook scripts fail on macOS when updates are not Bash 3.2-safe. Claude Code environments run macOS default Bash, so enforcing Bash 3.2-compatible syntax during hook script updates prevents execution failures across user environments.

The best way to synchronize versions is to perform version bumps in both plugin.json and marketplace.json simultaneously. This controlled version management avoids mismatched releases and ensures marketplace versioned deployments install correctly for both plugin and standalone skill variants.

The release checklist covers adding MCP tools, modifying hook scripts, testing locally, and upgrading installed users. It requires editing correct repository paths, validating Bash 3.2 compatibility, and synchronizing plugin.json and marketplace.json versions to ensure end-to-end release integrity.

Yes, you can maintain standalone skills separate from the Synapse plugin. The maintenance process applies to both plugin and standalone skill variants, ensuring documentation alignment and versioned marketplace deployments work correctly regardless of the distribution format used.