docs: merge RELEASE_NOTES into CHANGELOG, single source for releases

This commit is contained in:
sck_0
2026-01-31 08:45:29 +01:00
parent 9f6d75245f
commit 4310ca4922
4 changed files with 64 additions and 192 deletions

View File

@@ -41,7 +41,7 @@ it means you **did not run or commit** the Validation Chain correctly.
### 3. 📝 EVIDENCE OF WORK
- You must create/update `walkthrough.md` or `RELEASE_NOTES.md` to document what changed.
- You must create/update `walkthrough.md` or `CHANGELOG.md` to document what changed.
- If you made something new, **link it** in the artifacts.
### 4. 🚫 NO BRANCHES
@@ -172,7 +172,7 @@ Reject any PR that fails this:
When cutting a new version (e.g., V4):
1. **Run Full Validation**: `python3 scripts/validate_skills.py --strict`
2. **Update Changelog**: Create `RELEASE_NOTES.md`.
2. **Update Changelog**: Add the new release section to `CHANGELOG.md`.
3. **Bump Version**: Update header in `README.md`.
4. **Tag Release**:
```bash
@@ -180,12 +180,12 @@ When cutting a new version (e.g., V4):
git push origin v4.0.0
```
### 📋 Release Note Template
### 📋 Changelog Entry Template
All changeslogs/release notes MUST follow this structure to ensure professionalism and quality:
Each new release section in `CHANGELOG.md` should follow [Keep a Changelog](https://keepachangelog.com/) and this structure:
```markdown
# Release vX.Y.Z: [Theme Name]
## [X.Y.Z] - YYYY-MM-DD - "[Theme Name]"
> **[One-line catchy summary of the release]**

View File

@@ -7,8 +7,64 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
---
## [4.5.0] - 2026-01-31 - "Stitch UI Design"
> Expert prompting guide for Google Stitch AI-powered UI design tool.
### Added
- **New Skill**: `stitch-ui-design` Expert guide for creating effective prompts for Google Stitch AI UI design tool (Gemini 2.5 Flash). Covers prompt structure, specificity techniques, iteration strategies, design-to-code workflows, and 10+ examples for landing pages, mobile apps, and dashboards.
### Changed
- **Documentation**: Clarified in README.md and GETTING_STARTED.md that installation means cloning the full repo once; Starter Packs are curated lists to discover skills by role, not a different installation method (fixes [#44](https://github.com/sickn33/antigravity-awesome-skills/issues/44)).
### Registry
- **Total Skills**: 625 (from 624). Catalog regenerated.
### Credits
- [@ALEKGG1](https://github.com/ALEKGG1) stitch-ui-design (PR #45)
- [@CypherPoet](https://github.com/CypherPoet) Documentation clarity (#44)
---
## [4.4.0] - 2026-01-30 - "fp-ts skills for TypeScript"
> Three practical fp-ts skills for TypeScript functional programming.
### Added
- **New Skills** (from [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills)):
- `fp-ts-pragmatic` Pipe, Option, Either, TaskEither without academic jargon.
- `fp-ts-react` Patterns for fp-ts with React 18/19 and Next.js 14/15 (state, forms, data fetching).
- `fp-ts-errors` Type-safe error handling with Either and TaskEither.
### Registry
- **Total Skills**: 624 (from 621). Catalog regenerated.
---
## [4.3.0] - 2026-01-29 - "VoltAgent Integration & Context Engineering Suite"
> 61 new skills from VoltAgent/awesome-agent-skills: official team skills and context engineering suite.
### Added
- **61 new skills** from [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills):
- **Official (27)**: Sentry (commit, create-pr, find-bugs, iterate-pr), Trail of Bits (culture-index, fix-review, sharp-edges), Expo (expo-deployment, upgrading-expo), Hugging Face (hugging-face-cli, hugging-face-jobs), Vercel, Google Stitch (design-md), Neon (using-neon), n8n (n8n-code-python, n8n-mcp-tools-expert, n8n-node-configuration), SwiftUI, fal.ai (fal-audio, fal-generate, fal-image-edit, fal-platform, fal-upscale, fal-workflow), deep-research, imagen, readme.
- **Community (34)**: Context suite (context-fundamentals, context-degradation, context-compression, context-optimization, multi-agent-patterns, memory-systems, evaluation), frontend-slides, linear-claude-skill, skill-rails-upgrade, terraform-skill, tool-design, screenshots, automate-whatsapp, observe-whatsapp, aws-skills, ui-skills, vexor, pypict-skill, makepad-skills, threejs-skills, claude-scientific-skills, claude-win11-speckit-update-skill, security-bluebook-builder, claude-ally-health, clarity-gate, beautiful-prose, claude-speed-reader, skill-seekers, varlock-claude-skill, superpowers-lab, nanobanana-ppt-skills, x-article-publisher-skill, ffuf-claude-skill.
### Registry
- **Total Skills**: 614 (from 553). Catalog and SOURCES.md updated.
### Credits
- VoltAgent/awesome-agent-skills and official teams (Sentry, Trail of Bits, Expo, Hugging Face, Vercel Labs, Google Labs, Neon, fal.ai).
---
## [4.0.0] - 2026-01-28 - "The Enterprise Era"
@@ -120,7 +176,7 @@ The following skills are now correctly indexed and visible in the registry:
- **Documentation**:
- `docs/EXAMPLES.md`: Cookbook with 3 real-world scenarios.
- `docs/SOURCES.md`: Legal ledger for attributions and licenses.
- `RELEASE_NOTES.md`: Generated release announcement (archived).
- Release announcements are documented in this CHANGELOG.
### Changed

View File

@@ -1,184 +0,0 @@
# Release v4.5.0: Stitch UI Design
> **Expert prompting guide for Google Stitch AI-powered UI design tool**
This release adds the stitch-ui-design skill and clarifies documentation around Starter Packs vs full repo installation, bringing the total to 625 skills. The new skill provides comprehensive guidance for creating effective prompts in Google Stitch (Gemini 2.5 Flash) to generate high-quality UI designs for web and mobile applications.
## New Skills (1)
- **[stitch-ui-design](skills/stitch-ui-design/)** Expert guide for creating effective prompts for Google Stitch AI UI design tool. Covers prompt structure, specificity techniques, iteration strategies, design-to-code workflows, and 10+ practical examples for landing pages, mobile apps, and dashboards.
> **Try it:** `Use @stitch-ui-design to help me create a prompt for a mobile fitness app dashboard`
## Documentation Improvements
- **Clarified Starter Packs**: Updated README.md and GETTING_STARTED.md to explicitly state that installation means cloning the full repo once; Starter Packs are curated lists to help discover which skills to use by role, not a different installation method (fixes [#44](https://github.com/sickn33/antigravity-awesome-skills/issues/44))
## Registry Update
- **Total Skills**: 625 (from 624)
- **New Skills Added**: 1
- **Catalog**: Regenerated with all skills
## Credits
A huge shoutout to our community contributors:
- **[@ALEKGG1](https://github.com/ALEKGG1)** for `stitch-ui-design` skill (PR #45)
- **[@CypherPoet](https://github.com/CypherPoet)** for raising the documentation clarity issue (#44)
---
# Release v4.4.0: fp-ts skills for TypeScript
> **Three practical fp-ts skills for TypeScript functional programming**
This release adds 3 fp-ts skills sourced from [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills), bringing the total to 624 skills. These skills focus on practical, jargon-free patterns for pipe, Option, Either, TaskEither, React integration, and type-safe error handling.
## New Skills (3)
- **[fp-ts-pragmatic](skills/fp-ts-pragmatic/)** The 80/20 of functional programming: pipe, Option, Either, TaskEither without academic jargon
- **[fp-ts-react](skills/fp-ts-react/)** Patterns for using fp-ts with React 18/19 and Next.js 14/15 (state, forms, data fetching)
- **[fp-ts-errors](skills/fp-ts-errors/)** Type-safe error handling with Either and TaskEither; no more try/catch spaghetti
## Registry Update
- **Total Skills**: 624 (from 621)
- **New Skills Added**: 3
- **Catalog**: Regenerated with all skills
---
# Release v4.3.0: VoltAgent Integration & Context Engineering Suite
> **Massive expansion with 61 new skills from VoltAgent repository, including official team skills and comprehensive context engineering capabilities**
This release adds 61 high-quality skills sourced from the VoltAgent/awesome-agent-skills curated collection, bringing the total to 614 skills. Highlights include official skills from Sentry, Trail of Bits, Expo, Hugging Face, and a complete context engineering suite for building sophisticated AI agents.
## 🚀 New Skills
### Official Team Skills (27)
#### Sentry (4)
- **[commit](skills/commit/)** Create commits with best practices following Sentry conventions
- **[create-pr](skills/create-pr/)** Create pull requests with proper descriptions and review guidelines
- **[find-bugs](skills/find-bugs/)** Find and identify bugs in code systematically
- **[iterate-pr](skills/iterate-pr/)** Iterate on pull request feedback efficiently
#### Trail of Bits (3)
- **[culture-index](skills/culture-index/)** Index and search culture documentation
- **[fix-review](skills/fix-review/)** Verify fix commits address audit findings without new bugs
- **[sharp-edges](skills/sharp-edges/)** Identify error-prone APIs and dangerous configurations
#### Expo (2)
- **[expo-deployment](skills/expo-deployment/)** Deploy Expo apps to production
- **[upgrading-expo](skills/upgrading-expo/)** Upgrade Expo SDK versions safely
#### Hugging Face (2)
- **[hugging-face-cli](skills/hugging-face-cli/)** HF Hub CLI for models, datasets, repos, and compute jobs
- **[hugging-face-jobs](skills/hugging-face-jobs/)** Run compute jobs and Python scripts on HF infrastructure
#### Other Official (16)
- **[vercel-deploy-claimable](skills/vercel-deploy-claimable/)** Deploy projects to Vercel
- **[design-md](skills/design-md/)** Create and manage DESIGN.md files (Google Stitch)
- **[using-neon](skills/using-neon/)** Best practices for Neon Serverless Postgres
- **[n8n-code-python](skills/n8n-code-python/)** Python in n8n Code nodes
- **[n8n-mcp-tools-expert](skills/n8n-mcp-tools-expert/)** n8n MCP tools guide
- **[n8n-node-configuration](skills/n8n-node-configuration/)** n8n node configuration
- **[swiftui-expert-skill](skills/swiftui-expert-skill/)** SwiftUI best practices
- **[fal-audio](skills/fal-audio/)** Text-to-speech and speech-to-text using fal.ai
- **[fal-generate](skills/fal-generate/)** Generate images and videos using fal.ai AI models
- **[fal-image-edit](skills/fal-image-edit/)** AI-powered image editing with style transfer
- **[fal-platform](skills/fal-platform/)** Platform APIs for model management and usage tracking
- **[fal-upscale](skills/fal-upscale/)** Upscale and enhance image/video resolution using AI
- **[fal-workflow](skills/fal-workflow/)** Generate workflow JSON files for chaining AI models
- **[deep-research](skills/deep-research/)** Gemini Deep Research Agent for autonomous research
- **[imagen](skills/imagen/)** Generate images using Google Gemini
- **[readme](skills/readme/)** Generate comprehensive project documentation
### Community Skills (34)
#### Context Engineering Suite (7)
A complete suite for building sophisticated AI agents with advanced context management:
- **[context-fundamentals](skills/context-fundamentals/)** Understand what context is, why it matters, and the anatomy of context in agent systems
- **[context-degradation](skills/context-degradation/)** Recognize patterns of context failure: lost-in-middle, poisoning, distraction, and clash
- **[context-compression](skills/context-compression/)** Design and evaluate compression strategies for long-running sessions
- **[context-optimization](skills/context-optimization/)** Apply compaction, masking, and caching strategies
- **[multi-agent-patterns](skills/multi-agent-patterns/)** Master orchestrator, peer-to-peer, and hierarchical multi-agent architectures
- **[memory-systems](skills/memory-systems/)** Design short-term, long-term, and graph-based memory architectures
- **[evaluation](skills/evaluation/)** Build evaluation frameworks for agent systems
#### Development Tools (8)
- **[frontend-slides](skills/frontend-slides/)** Generate animation-rich HTML presentations with visual style previews
- **[linear-claude-skill](skills/linear-claude-skill/)** Manage Linear issues, projects, and teams
- **[skill-rails-upgrade](skills/skill-rails-upgrade/)** Analyze Rails apps and provide upgrade assessments
- **[terraform-skill](skills/terraform-skill/)** Terraform infrastructure as code best practices
- **[tool-design](skills/tool-design/)** Build tools that agents can use effectively, including architectural reduction patterns
- **[screenshots](skills/screenshots/)** Generate marketing screenshots with Playwright
- **[automate-whatsapp](skills/automate-whatsapp/)** Build WhatsApp automations with workflows and agents
- **[observe-whatsapp](skills/observe-whatsapp/)** Debug WhatsApp delivery issues and run health checks
#### Platform & Framework Skills (19)
- **[aws-skills](skills/aws-skills/)** AWS development with infrastructure automation
- **[ui-skills](skills/ui-skills/)** Opinionated constraints for building interfaces
- **[vexor](skills/vexor/)** Vector-powered CLI for semantic file search
- **[pypict-skill](skills/pypict-skill/)** Pairwise test generation
- **[makepad-skills](skills/makepad-skills/)** Makepad UI development for Rust apps
- **[threejs-skills](skills/threejs-skills/)** Three.js 3D experiences
- **[claude-scientific-skills](skills/claude-scientific-skills/)** Scientific research skills
- **[claude-win11-speckit-update-skill](skills/claude-win11-speckit-update-skill/)** Windows 11 management
- **[security-bluebook-builder](skills/security-bluebook-builder/)** Security documentation
- **[claude-ally-health](skills/claude-ally-health/)** Health assistant
- **[clarity-gate](skills/clarity-gate/)** RAG quality verification
- **[beautiful-prose](skills/beautiful-prose/)** Writing style guide
- **[claude-speed-reader](skills/claude-speed-reader/)** Speed reading tool
- **[skill-seekers](skills/skill-seekers/)** Skill conversion tool
- **[varlock-claude-skill](skills/varlock-claude-skill/)** Secure environment variable management
- **[superpowers-lab](skills/superpowers-lab/)** Superpowers Lab integration
- **[nanobanana-ppt-skills](skills/nanobanana-ppt-skills/)** PowerPoint presentation skills
- **[x-article-publisher-skill](skills/x-article-publisher-skill/)** X/Twitter article publishing
- **[ffuf-claude-skill](skills/ffuf-claude-skill/)** Web fuzzing with ffuf
---
## 📦 Registry Update
- **Total Skills**: 614 (from 553)
- **New Skills Added**: 61
- **Catalog**: Fully regenerated with all new skills
- **Sources**: All skills properly attributed in `docs/SOURCES.md`
## 🔧 Improvements
### Quality Assurance
- All new skills validated for frontmatter compliance
- "When to Use" sections added where missing
- Source attribution maintained for all skills
- Risk labels properly set
### Documentation
- Updated README.md with correct skill count (614)
- Updated package.json version to 4.3.0
- Comprehensive release notes created
## 📊 Statistics
- **Skills from VoltAgent Repository**: 61
- Official Team Skills: 27
- Community Skills: 34
- **Skills Analyzed**: 174 total from VoltAgent
- **Skills Already Present**: 32 (skipped as duplicates)
- **Skills with Similar Names**: 89 (analyzed, 12 implemented as complementary)
## 👥 Credits
A huge shoutout to our community contributors and the VoltAgent team:
- **VoltAgent/awesome-agent-skills** for curating an excellent collection
- **Official Teams**: Sentry, Trail of Bits, Expo, Hugging Face, Vercel Labs, Google Labs, Neon, fal.ai
- **Community Contributors**: zarazhangrui, wrsmith108, robzolkos, muratcankoylan, antonbabenko, and all other skill authors
---
_Upgrade now: `git pull origin main` to fetch the latest skills._

View File

@@ -292,7 +292,7 @@ jobs:
uses: softprops/action-gh-release@v1
with:
tag_name: ${{ steps.version.outputs.tag }}
body_path: RELEASE_NOTES.md
body_path: CHANGELOG.md
generate_release_notes: true
```
@@ -368,7 +368,7 @@ repo = "repo"
git cliff -o CHANGELOG.md
# Generate for specific range
git cliff v1.0.0..v2.0.0 -o RELEASE_NOTES.md
git cliff v1.0.0..v2.0.0 -o CHANGELOG.md
# Preview without writing
git cliff --unreleased --dry-run