agentleFS
haruharu/redmine_ai_helper/.claude/skills/create-release-notes/SKILL.md

create-release-notes

Skill107 starsChanged 9 months agoMITView on GitHub

Generate Redmine.org release notes from a GitHub release tag. Fetches the release, strips emojis/issue numbers/author names, and outputs Textile-formatted text ready to paste into redmine.org.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Add a download section at the top:

    line 60
  2. Distinctive:

    Never include emoji — redmine.org does not support them.

    line 99
  3. Very specific:

    Never include GitHub issue/PR numbers (#123) — they would be interpreted as redmine.org issue numbers.

    line 100
  4. Distinctive:

    Never include author names — GitHub usernames are irrelevant on redmine.org.

    line 101
  5. Distinctive:

    Do not write the output to any file.

    line 102

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Create Redmine.org Release Notes

Fetch the GitHub release notes for a given version and convert them into Textile format suitable for posting on redmine.org.

User Input

$ARGUMENTS

The user input should contain the release version (e.g. 3.3.0). If no version is provided, ask the user which version to use before proceeding.

Procedure

Step 1: Determine the Version

Extract the version from $ARGUMENTS. If absent, ask the user for the target version.

Step 2: Fetch the GitHub Release Notes

Run:

gh release view <version> --repo haru/redmine_ai_helper

Parse the Markdown body from the output.

Step 3: Convert to Textile

Transform the Markdown release notes into Textile following these rules:

MarkdownTextile
## What's Changedh3. What's Changed
### New Features …h4. New Features
### Bug Fixes …h4. Bug Fixes
### Other Changes …h4. Other Changes
* item / - item* item

Cleanup rules (apply in order):

  1. Remove emojis — strip all emoji characters (e.g. :tada:, Unicode emoji such as 🎉, 🐛, 📝).
  2. Remove GitHub issue/PR references — delete patterns like by @author in https://github.com/.../pull/123 or by @author in https://github.com/.*/issues/\d+. Also remove standalone by @username suffixes.
  3. Remove author names — delete any remaining by @username patterns.
  4. Remove hyperlinks — delete bare GitHub URLs that appear after cleanup (e.g. https://github.com/...).
  5. Remove the "Full Changelog" line — drop the line starting with **Full Changelog**.
  6. Trim trailing whitespace from each bullet.

Step 4: Prepend the Download Section

Add a download section at the top:

h3. Download

https://github.com/haru/redmine_ai_helper/releases/tag/<version>

Step 5: Output the Result

Print the complete Textile text to the user so they can copy and paste it into redmine.org. Do not write it to any file.

Expected Output Format

h3. Download

https://github.com/haru/redmine_ai_helper/releases/tag/<version>

h3. What's Changed

h4. New Features

* <feature description>
* <feature description>

h4. Bug Fixes

* <fix description>

h4. Other Changes

* <change description>
* <change description>

Notes

  • Output must be Textile, not Markdown. redmine.org does not render Markdown.
  • Never include emoji — redmine.org does not support them.
  • Never include GitHub issue/PR numbers (#123) — they would be interpreted as redmine.org issue numbers.
  • Never include author names — GitHub usernames are irrelevant on redmine.org.
  • Do not write the output to any file; display it in the conversation only.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.