make-change-file

Create or update Remix repo change files under packages/*/.changes.

33.3k|2.8k|Updated Oct 26, 2020
One-click install
npx skills add https://github.com/remix-run/remix --skill make-change-file
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-change-file
Source: https://github.com/remix-run/remix/tree/main/.agents/skills/make-change-file
Command: npx skills add https://github.com/remix-run/remix --skill make-change-file

SYSTEM DOCUMENTATION & REQUIREMENTS

Create or update Remix repo change files under packages/*/.changes. Use when a user asks for release notes, a change file, a missing changelog entry, a prerelease note, or an update to existing unpublished release notes.

What problem does it solve?

Centralizes and standardizes release notes by generating or updating package change files to align with the repo's conventions, reducing manual effort and ensuring consistency across releases.

Core Features & Use Cases

  • Detect unpublished change files and update them in place to avoid duplicates.
  • Determine appropriate bump types (major, minor, patch) based on changes and user input.
  • Produce concise, user-facing release notes describing shipped behavior, APIs, or exports.
  • Validate notes against repository lint rules and render preview.

Quick Start

Create or update a package's change file under packages/*/.changes with a concise, user-facing note describing the release.

Frequently Asked Questions about make-change-file

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

FAQPage Schema
How do I create release notes for Remix packages?

To create release notes for Remix packages, you generate or update change files under packages/*/.changes. This standardizes entries into concise, user-facing notes describing shipped behavior, APIs, or exports.

How do I update existing unpublished change files without creating duplicates?

To update unpublished change files without duplicates, the system detects existing notes under packages/*/.changes and updates them in place. This prevents redundant entries while maintaining repo conventions.

How does a change file determine the correct bump type for a package release?

A change file determines the correct bump type by analyzing the targeted package changes and user input. It enforces the appropriate version bump—major, minor, or patch—based on repository conventions.

How are package change files validated against repository lint rules?

Package change files are validated by checking formatting and content against repository-specific lint rules. This ensures the output is a ready-to-render changelog entry that aligns with repo standards.

When do I need to generate a prerelease note or changelog entry?

You generate a prerelease note or changelog entry when a user requests release notes, a missing changelog entry, or updates to existing unpublished release notes. This centralizes and standardizes the documentation process.