oss-release

Enforce CHANGELOG.md release-note structure with a 10-block rolling window.

2|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/jonaseck2/slaktforskning --skill oss-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oss-release
Source: https://github.com/jonaseck2/slaktforskning/tree/main/.claude/skills/oss-release
Command: npx skills add https://github.com/jonaseck2/slaktforskning --skill oss-release

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents inconsistent, bloated, or forgotten release documentation by enforcing a strict CHANGELOG.md block structure that matches the automated CI-based release flow.

Core Features & Use Cases

  • Versioned release blocks: Ensures each version-bumped commit prepends exactly one correctly formatted block.
  • 10-block rolling window: Keeps only the most recent 10 version blocks in CHANGELOG.md and archives older ones.
  • Stable footer pointer: Maintains the bottom-of-file archive pointer linking to the archived changelog and plan history.
  • Release-discipline guidance: Provides bullet-style rules that keep entries readable for non-developers and avoids engineering-detail bloat.

Quick Start

Use oss-release while editing CHANGELOG.md during a version-bumped commit to produce a correctly formatted, rolling-window release entry.

Frequently Asked Questions about oss-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep CHANGELOG release notes consistent for automated GitHub releases?

To keep CHANGELOG release notes consistent for automated GitHub releases, enforce a strict block structure that matches your CI-driven flow, ensuring each version-bumped commit prepends exactly one correctly formatted, readable block.

What is the best way to format a CHANGELOG.md entry for a version bump?

The best way to format a CHANGELOG.md entry for a version bump is using bullet-style constraints that maintain readability for non-developers, intentionally avoiding engineering-detail bloat while adhering to one block per commit.

How do I archive older changelog entries without breaking CI versioning?

To archive older changelog entries without breaking CI versioning, maintain a 10-block rolling window in your primary CHANGELOG.md and move older entries to an archive file, keeping a stable footer pointer linking to the archived history.

Why does my automated OSS release process produce inconsistent documentation?

Your automated OSS release process produces inconsistent documentation because it lacks strict structural enforcement, allowing unregulated entries; applying release-discipline rules ensures documentation matches the CI-driven GitHub Release process consistently.

Can I use a rolling window approach for CHANGELOG management in open source projects?

Yes, you can use a rolling window approach for CHANGELOG management in open source projects by keeping only the 10 most recent version blocks active and archiving the rest, which prevents file bloat while preserving historical accessibility.

When should I not use bullet-style constraints for changelog entries?

You should not use bullet-style constraints for changelog entries if your audience requires detailed engineering logs, as these constraints specifically filter out engineering-detail bloat to keep release notes readable for non-developers.