writing-modpack-changelog
Use when cutting a modpack release. Creates <project>/docs/release-changelog.md if absent; appends a new version section with grouped changes. Triggers - 'cut a release', 'release notes', 'changelog', 'v1.2.3 changes', 'what changed since last version'.
Install / Use
npx skills add hashgraph-online/awesome-codex-plugins --skill writing-modpack-changelogInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Tags
Our assessment of writing-modpack-changelog
writing-modpack-changelog scores 90/100 on our quality scale, 451st of 1,153 Content & Media skills we index (top 40%).
Its SKILL.md is 9.0 KB long, well organised into 22 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 1,075 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so writing-modpack-changelog is actively maintained.
- Our last check on 2026-10-30 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
writing-modpack-changelog compared with similar skills
All 4 of these similar skills score higher than writing-modpack-changelog; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| writing-modpack-changelog (this skill)by hashgraph-online | 90 | 1.1k | 53d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install writing-modpack-changelog?
- Run
npx skills add hashgraph-online/awesome-codex-plugins --skill writing-modpack-changelog. The install tabs above show the steps for each supported agent. - Which AI agents does writing-modpack-changelog work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is writing-modpack-changelog safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is writing-modpack-changelog still maintained?
- The repository was last updated about 2 months ago, so writing-modpack-changelog is actively maintained.
Skill content
View source on GitHubname: writing-modpack-changelog description: "Use when cutting a modpack release. Creates <project>/docs/release-changelog.md if absent; appends a new version section with grouped changes. Triggers - 'cut a release', 'release notes', 'changelog', 'v1.2.3 changes', 'what changed since last version'."
Overview
The modpack release changelog is the user-visible record of what changed between releases, grouped by semantic category: Added, Changed, Fixed, Removed, and Compatibility. This skill replaces the deleted templates/modpack/release-changelog.md template by creating <project>/docs/release-changelog.md at runtime, then inserting a new version section whenever the curator cuts a release.
When to Use
| Use this skill when... | Result | | --- | --- | | The user says "cut a release", "release notes", "changelog", or "what changed since last version" | Create or update the release changelog. | | A target version is being prepared for Nexus, ModDB, a Discord post, a GitHub release, or another player-facing surface | Produce grouped, readable release notes. | | The user wants changes since the last tag, version, or release section | Summarize those changes into semantic buckets. | | The user has finished a modpack milestone | Insert a new version section newest-first. | | The user asks whether the release is major, minor, or patch | Suggest a version bump based on modpack impact. |
When NOT to Use
| Do not use this skill when... | Use instead |
| --- | --- |
| The user made a random working change and wants to remember it later | writing-modpack-devlog |
| The user wants a single-mod curator note | writing-modpack-devlog |
| The user asks for plugin inspection or conflict resolution | xedit-automation or xedit-conflict-audit first. |
| There is no release boundary, version, tag, or player-facing summary intent | Keep working; do not invent a release. |
| The user needs to set up the modpack project structure first | setting-up-bgs-modding-environment |
Rules
<EXTREMELY-IMPORTANT> This skill writes release notes for humans. It does not install mods, alter game files, change load order, publish to Nexus, or open a release page. Draft the changelog locally; any public posting or release publication requires explicit user confirmation outside this skill. </EXTREMELY-IMPORTANT>- Detect the modpack project root before writing.
- If the user provides
<modpack_project_root>, use it. - If the current working directory looks like a modpack directory because it already has
Data/,profiles/, ordocs/, default topwdand tell the user what default you used. - Otherwise ask once: "Which modpack project root should I use? I can default to the current directory if this is the project root."
- If the user provides
- Locate
<project>/docs/release-changelog.md.- If
<project>/docs/does not exist, create it. - If
release-changelog.mdis missing, create it before inserting the version.
- If
- On first creation, use this header shape:
# <Project Name> Release Changelog- One-line intro:
Player-facing release notes for <Project Name>. Newest releases are listed first. ## Releases
- Determine the target version.
- If the user provides a version, use it exactly after checking that it is not already present.
- If the user does not provide a version, read the newest release heading and ask for the new version once.
- Suggest a semver bump: major for load-order-breaking or save-breaking changes, minor for added mods or compatibility tweaks, patch for fixes only.
- Use the current local date for the release date unless the user provides a specific release date.
- Version headings use
## <version> (<release-date>). - Use
YYYY-MM-DDfor release dates.
- Version headings use
- Each version section must use semantic buckets:
### Added### Changed### Fixed### Removed### Compatibility
- Omit empty buckets.
- Do not leave placeholder headings such as
### Removedwith "None" under them unless the user explicitly wants a full template.
- Do not leave placeholder headings such as
- Insert versions newest-first under
## Releases.- Insert the new version immediately below
## Releases. - If the file already uses oldest-first and the user wants to preserve it, follow the existing convention and note that choice.
- Insert the new version immediately below
- Optionally consume the dev-log.
- If
<project>/docs/dev-log.mdexists, offer to summarize entries since the last release into the appropriate buckets. - The user must confirm or edit the proposed summary before you write it into the changelog.
- Do not blindly convert every dev-log entry into player-facing copy; curator noise stays in the dev-log.
- If
- Write for players, not for internal tooling.
- Keep entries concrete and readable.
- Avoid private debugging details, raw conflict jargon, and internal agent process notes.
- Mention mod names when they help users understand compatibility or upgrade risk.
- Do not duplicate an existing version.
- If the target version heading already exists, ask whether to amend that section or choose a new version.
- Do not insert a second
## <version>heading.
- After writing, report the file path, version, release date, buckets included, and whether dev-log entries were consumed.
Quick Reference
| Field | Canonical shape | Example |
| --- | --- | --- |
| File | <project>/docs/release-changelog.md | docs/release-changelog.md |
| Version heading | ## <version> (<release-date>) | ## v1.4.0 (2026-06-01) |
| Bucket heading | ### Added, ### Changed, ### Fixed, ### Removed, ### Compatibility | ### Compatibility |
| Entry style | Short player-facing bullet | - Added a patch for Example Weather and Example Lighting. |
| Ordering | Newest release first under ## Releases | v1.4.0 above v1.3.2 |
Canonical version shape:
## v1.4.0 (2026-06-01)
### Added
- Added Example Weather Overhaul and its modpack patch.
### Changed
- Rebalanced the early-game survival settings for slower hunger and thirst gain.
### Fixed
- Fixed missing workshop keywords in the settlement compatibility patch.
### Compatibility
- Added compatibility notes for Example Lighting Overhaul users upgrading from v1.3.x.
Examples
Bad
Changed a bunch of stuff:
- new weather
- fixed bugs
- removed old patch
This has no version, no release date, no grouping, and no signal about compatibility risk.
Good
## v1.4.0 (2026-06-01)
### Added
- Added Example Weather Overhaul with a curated modpack patch.
### Changed
- Updated settlement lighting balance in the downtown cells.
### Fixed
- Fixed missing workshop keywords caused by the lighting compatibility patch.
### Removed
- Removed the obsolete Example Weather Hotfix; its changes are now included upstream.
### Compatibility
- Save-compatible for existing v1.3.x users, but users with custom lighting patches should rebuild their conflict patch.
This section gives players the version, date, grouped changes, and upgrade risk in one place.
Common Mistakes
- Using the changelog for rough working notes that belong in the dev-log.
- Forgetting the version or release date.
- Dumping ungrouped bullets under one heading.
- Leaving empty bucket headings in the final changelog.
- Copying raw dev-log text without translating it for players.
- Hiding compatibility or save-risk information because it sounds negative.
- Creating duplicate version headings.
- Asking repeated version questions instead of suggesting a semver bump.
- Publishing release notes directly instead of drafting them for user review.
- Overstating changes with marketing language instead of concrete release facts.
Rationalizations
| Excuse | Reality | | --- | --- | | "The dev-log already says what changed." | The dev-log is curator history. The changelog is player-facing release communication. They need different detail and tone. | | "A single bullet list is faster." | Grouped buckets let users scan for added content, fixes, removals, and compatibility risk. | | "Empty headings show that we considered every category." | Empty headings are noise in release notes. Omit empty buckets unless the user asked for a full template. | | "I do not know the version, so I will invent one." | Ask once and suggest a bump. Version numbers are release authority, not filler text. | | "The conflict details are important, so I will paste them all." | Players need the effect and upgrade risk. Keep raw conflict evidence in the dev-log or artifacts. | | "This is just a patch release, so no changelog is needed." | Patch releases still need a record of what was fixed and whether users should update. | | "Compatibility notes make the release look risky." | Hidden risk is worse. Clear compatibility notes reduce support burden. | | "The user said release notes, so I can post them." | This skill drafts local changelog text. Public posting is a separate confirmed action. |
See also
writing-modpack-devlog- use for curator-facing chronological work records.setting-up-bgs-modding-environment- use when the modpack project root or docs structure must be established first.
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
