From d2f9638c5c1df1cd2a93126f499a3914975cd18c Mon Sep 17 00:00:00 2001 From: Zhongwei Li Date: Sat, 29 Nov 2025 18:15:29 +0800 Subject: [PATCH] Initial commit --- .claude-plugin/plugin.json | 12 +++++ README.md | 3 ++ SKILL.md | 104 +++++++++++++++++++++++++++++++++++++ plugin.lock.json | 45 ++++++++++++++++ 4 files changed, 164 insertions(+) create mode 100644 .claude-plugin/plugin.json create mode 100644 README.md create mode 100644 SKILL.md create mode 100644 plugin.lock.json diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..d662168 --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,12 @@ +{ + "name": "changelog-generator", + "description": "Automatically creates user-facing changelogs from git commits by analyzing history and transforming technical commits into customer-friendly release notes.", + "version": "0.0.0-2025.11.28", + "author": { + "name": "ComposioHQ", + "email": "tech@composio.dev" + }, + "skills": [ + "./" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..bd46ef7 --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# changelog-generator + +Automatically creates user-facing changelogs from git commits by analyzing history and transforming technical commits into customer-friendly release notes. diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..72919de --- /dev/null +++ b/SKILL.md @@ -0,0 +1,104 @@ +--- +name: changelog-generator +description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation. +--- + +# Changelog Generator + +This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate. + +## When to Use This Skill + +- Preparing release notes for a new version +- Creating weekly or monthly product update summaries +- Documenting changes for customers +- Writing changelog entries for app store submissions +- Generating update notifications +- Creating internal release documentation +- Maintaining a public changelog/product updates page + +## What This Skill Does + +1. **Scans Git History**: Analyzes commits from a specific time period or between versions +2. **Categorizes Changes**: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security) +3. **Translates Technical → User-Friendly**: Converts developer commits into customer language +4. **Formats Professionally**: Creates clean, structured changelog entries +5. **Filters Noise**: Excludes internal commits (refactoring, tests, etc.) +6. **Follows Best Practices**: Applies changelog guidelines and your brand voice + +## How to Use + +### Basic Usage + +From your project repository: + +``` +Create a changelog from commits since last release +``` + +``` +Generate changelog for all commits from the past week +``` + +``` +Create release notes for version 2.5.0 +``` + +### With Specific Date Range + +``` +Create a changelog for all commits between March 1 and March 15 +``` + +### With Custom Guidelines + +``` +Create a changelog for commits since v2.4.0, using my changelog +guidelines from CHANGELOG_STYLE.md +``` + +## Example + +**User**: "Create a changelog for commits from the past 7 days" + +**Output**: +```markdown +# Updates - Week of March 10, 2024 + +## ✨ New Features + +- **Team Workspaces**: Create separate workspaces for different + projects. Invite team members and keep everything organized. + +- **Keyboard Shortcuts**: Press ? to see all available shortcuts. + Navigate faster without touching your mouse. + +## 🔧 Improvements + +- **Faster Sync**: Files now sync 2x faster across devices +- **Better Search**: Search now includes file contents, not just titles + +## 🐛 Fixes + +- Fixed issue where large images wouldn't upload +- Resolved timezone confusion in scheduled posts +- Corrected notification badge count +``` + +**Inspired by:** Manik Aggarwal's use case from Lenny's Newsletter + +## Tips + +- Run from your git repository root +- Specify date ranges for focused changelogs +- Use your CHANGELOG_STYLE.md for consistent formatting +- Review and adjust the generated changelog before publishing +- Save output directly to CHANGELOG.md + +## Related Use Cases + +- Creating GitHub release notes +- Writing app store update descriptions +- Generating email updates for users +- Creating social media announcement posts + diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..d50646a --- /dev/null +++ b/plugin.lock.json @@ -0,0 +1,45 @@ +{ + "$schema": "internal://schemas/plugin.lock.v1.json", + "pluginId": "gh:ComposioHQ/awesome-claude-skills:changelog-generator", + "normalized": { + "repo": null, + "ref": "refs/tags/v20251128.0", + "commit": "b7b422fb09cd656776e878705363e6484fd96756", + "treeHash": "4dca9e1ec55a69be3197ae9ec383f4cfe45e392e6ba35afbaa5a148ff0bf7494", + "generatedAt": "2025-11-28T10:10:06.596017Z", + "toolVersion": "publish_plugins.py@0.2.0" + }, + "origin": { + "remote": "git@github.com:zhongweili/42plugin-data.git", + "branch": "master", + "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390", + "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data" + }, + "manifest": { + "name": "changelog-generator", + "description": "Automatically creates user-facing changelogs from git commits by analyzing history and transforming technical commits into customer-friendly release notes.", + "version": null + }, + "content": { + "files": [ + { + "path": "README.md", + "sha256": "0bf5b2048aca78a4412c90eea2f353f4575bc9df28346f1e7f0386f81e1a58ef" + }, + { + "path": "SKILL.md", + "sha256": "0fdde1fc7ed062a82fd7ba98057f5d471c5d1905bfe2ddc4eeb213450cb00c18" + }, + { + "path": ".claude-plugin/plugin.json", + "sha256": "6ae894a5a664bfb0e84cbe1627810e76123dd848443043801a76f197e6331f27" + } + ], + "dirSha256": "4dca9e1ec55a69be3197ae9ec383f4cfe45e392e6ba35afbaa5a148ff0bf7494" + }, + "security": { + "scannedAt": null, + "scannerVersion": null, + "flags": [] + } +} \ No newline at end of file