docs-and-changelogs

Generate CHANGELOG.md entries from Conventional Commits and scaffold ADR and PRD templates.

6|Updated Nov 11, 2025
One-click install
npx skills add https://github.com/hopeoverture/worldbuilding-app-skills --skill docs-and-changelogs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-and-changelogs
Source: https://github.com/hopeoverture/worldbuilding-app-skills/tree/main/skills/documentation/docs-and-changelogs
Command: npx skills add https://github.com/hopeoverture/worldbuilding-app-skills --skill docs-and-changelogs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Automatically generate CHANGELOG.md entries from Conventional Commits, keep release notes, and scaffold ADRs, PRDs, and other essential docs for project governance.

Core Features & Use Cases

  • Generate CHANGELOG.md from git history using Conventional Commits
  • Maintain CHANGELOG with semantic versioning
  • Scaffold ADRs (Architectural Decisions) and PRDs
  • Load and update project documentation templates

Quick Start

Use the scripts to generate changelog sections and skeleton docs for your next release.

Frequently Asked Questions about docs-and-changelogs

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

FAQPage Schema
How do I generate a CHANGELOG.md from git commit history?

Generate CHANGELOG.md automatically by parsing your repository's Conventional Commits, categorizing entries by type (feat, fix, breaking changes), and formatting them according to Keep a Changelog standards. This Skill applies commit history directly to produce structured release notes without manual formatting.

What's the best way to maintain release notes with semantic versioning?

Maintain release notes by integrating Conventional Commits with semantic versioning workflows. This Skill automates changelog updates tied to version bumps, ensuring each release entry reflects breaking changes, features, and fixes in a consistent, versioned format.

Can I scaffold ADR and PRD templates for project governance?

Yes. This Skill scaffolds Architecture Decision Records (ADRs) and Product Requirements Documents (PRDs) as templates, providing structured starting points for documentation governance and decision tracking across your project lifecycle.

Do I need Conventional Commits to use this for changelog automation?

Yes. This Skill requires repositories using Conventional Commits format to parse commit history accurately, categorize changes by type, and detect breaking changes needed for automated changelog generation and semantic versioning.

How do Conventional Commits improve changelog quality?

Conventional Commits enforce a structured commit message format that signals intent—feat, fix, breaking changes—enabling automated parsing, accurate categorization, and consistent changelog output without manual review or reformatting.

What happens if my repository doesn't follow Keep a Changelog format?

This Skill formats changelog outputs according to Keep a Changelog standards automatically. If your existing CHANGELOG doesn't follow this format, the Skill scaffolds compliant entries; migration of legacy entries would require manual alignment or preprocessing.