changesets
By savvy-web
Companion plugin for @savvy-web/changesets that helps write well-structured changeset files for GitHub release documentation
npx claudepluginhub savvy-web/systems --plugin changesetsComponent Overview
Component Details
Skills (9)
Validate existing changeset files in .changeset/ against @savvy-web/changesets format rules. Checks structural compliance with CSH001-CSH005 rules and reports errors with file paths and rule codes.
Interactively create a changeset file for @savvy-web/changesets. Analyzes git diff, detects affected packages, proposes bump types, and drafts a properly structured changeset with valid section headings.
Delete one or more changeset files from .changeset/. Select by name or interactively pick from the list. Use when a changeset is no longer needed after a revert or scope change.
Use when writing, editing, or reviewing changeset files in .changeset/. Provides the @savvy-web/changesets format specification including valid section headings, structural rules, and content quality guidance. Activates when working with changeset markdown files, creating changesets, or discussing changeset format.
List all pending changeset files in .changeset/ with a summary showing filename, affected packages, bump types, and first line of content. Use to get an overview of queued changes before release.
Merge multiple changeset files in .changeset/ that share the same package-to-bump-type mapping. Combines content from matching changesets into a single file and removes the originals. Use to consolidate related changesets before release.
Preview what the combined CHANGELOG output would look like with all pending changesets. Shows the rendered release notes grouped by package, with sections merged and ordered by priority. Use to review before merging.
Provides awareness of existing changeset files when working in .changeset/. Loads context about pending changesets to prevent duplicates and inform decisions about new changesets. Activates when reading or listing files in the .changeset/ directory, reviewing pending changes, or discussing release readiness.
Update an existing changeset file in .changeset/. Select a changeset to modify, then edit its content, bump types, or affected packages. Use when the scope of a change evolves after the initial changeset was created.
Hooks (1)
README
@savvy-web/changesets
Custom changelog formatter and markdown processing pipeline for the Silk Suite. Replaces the default @changesets/cli/changelog formatter with a three-layer architecture: pre-validation (remark-lint), changelog formatting (Changesets API), and post-processing (remark-transform).
Features
- Section-aware changesets -- Categorize changes with h2/h3 headings (Features, Bug Fixes, Breaking Changes, etc.)
- CLI tooling --
savvy-changesetsbinary with init, lint, check, validate-file, transform, and version subcommands - GitHub integration -- Automatic PR links, commit references, and contributor attribution
- Editor support -- markdownlint rules for real-time validation in VS Code and CI
- Claude Code plugin -- Automated validation hooks, skills, and a changeset-writer agent for AI-assisted development
Repository Structure
This is a pnpm workspace monorepo:
| Directory | Purpose |
|---|---|
package/ | The published @savvy-web/changesets npm package |
plugin/ | Companion Claude Code plugin (hooks, skills, agents) |
docs/ | Repository-level documentation |
lib/ | Shared workspace configuration (lint-staged, markdownlint) |
Development
pnpm install
pnpm run build # Build all (dev + prod)
pnpm run test # Run all tests
pnpm run lint # Check code with Biome
pnpm run typecheck # Type-check via Turbo (tsgo)
See CONTRIBUTING.md for full development setup and conventions.
Documentation
- Package README -- Installation, quick start, and API overview
- CLI Reference -- All commands and options
- Section-Aware Pipeline -- End-to-end walkthrough
- Configuration -- Options, version files, CI integration
- Architecture -- Three-layer pipeline design
- API Reference -- Classes, types, Effect services, remark plugins
- Markdownlint Rules -- Per-rule documentation
License
Similar Plugins
context7-plugin
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools