Changelog generator
Skill FortiumPartners/ensemble/packages/git/skills/changelog-generator
Ensemble Plugin Ecosystem - Modular Claude Code plugins for AI-augmented development workflowsFrom the repository description
npx -y skills add FortiumPartners/ensemble --skill changelog-generatorAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 12 stars12 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.3 KB, as published. Nobody here has run it
Changelog Generator Skill
Quick Reference - Parse conventional commits and generate categorized changelog
Mission
Generate changelog from conventional commits with categorization (Features, Bug Fixes, Breaking Changes, Performance, Documentation) and formatted output for release notes.
Core Capabilities
- Conventional Commit Parsing: Extract type, scope, description, breaking changes
- Change Categorization: Group by type (feat, fix, perf, docs, refactor, test, chore)
- Breaking Change Detection: Identify BREAKING CHANGE footer and ! syntax
- Semantic Version Integration: Suggest version bump based on change types
- Multi-Format Output: Markdown, JSON, plain text formats
Quick Start
const { ChangelogGenerator } = require('./scripts/generate-changelog.js');
const generator = new ChangelogGenerator({
fromTag: 'v2.0.0',
toTag: 'HEAD',
format: 'markdown'
});
const changelog = await generator.generate();
console.log(changelog);
Conventional Commit Format
<type>(<scope>): <description>
[optional body]
[optional footer(s)]
Supported Types:
feat: New feature → Features sectionfix: Bug fix → Bug Fixes sectionperf: Performance improvement → Performance sectiondocs: Documentation → Documentation sectionstyle: Code style (no logic change)refactor: Code refactoringtest: Test additions/updateschore: Build/tooling changes
Breaking Changes:
BREAKING CHANGE:footer → Breaking Changes section!after type/scope → Breaking Changes section
Category Priority
- Breaking Changes (highest impact)
- Features (new functionality)
- Bug Fixes (fixes)
- Performance (optimizations)
- Documentation (docs updates)
Example Output
## [2.1.0] - 2025-11-05
### Breaking Changes
- **auth**: Remove deprecated OAuth 1.0 support (c4f3b2a)
### Features
- **api**: Add rate limiting with Redis backend (a1b2c3d)
- **ui**: Implement dark mode toggle (e5f6g7h)
### Bug Fixes
- **database**: Fix connection pool exhaustion (i8j9k0l)
- **auth**: Resolve JWT token expiration edge case (m1n2o3p)
### Performance
- **api**: Optimize query performance with database indexes (q4r5s6t)
Pass/Fail Criteria
Pass: Changelog generated with all changes categorized
- ✅ All conventional commits parsed correctly
- ✅ Changes grouped by category (breaking, features, fixes, etc.)
- ✅ Commit hashes included for traceability
- ✅ Execution time <60 seconds
Fail: Parsing or generation errors
- ❌ Non-conventional commits cannot be parsed
- ❌ Category detection fails
- ❌ Output format invalid
- ❌ Execution time exceeds 60 seconds
Configuration
# skills/changelog-generator/templates/changelog-config.yaml
fromTag: v2.0.0
toTag: HEAD
format: markdown # or 'json', 'plain'
categories:
- breaking
- features
- fixes
- performance
- documentation
excludeTypes:
- style
- test
- chore
includeCommitHash: true
Performance Target
Target: <60 seconds for 1000 commits
- Git log parsing: <20s
- Commit analysis: <20s
- Markdown generation: <20s
Need More Detail?
Load: skills/changelog-generator/REFERENCE.md (~15KB)
- Advanced parsing patterns
- Custom category configuration
- Multi-repository support
- Integration examples