Skip to content
Back to search

human-release-notes

SkillWorks with Claude CodeGitHub

Turns commits, a diff, or a technical change list into end-user release notes in three sections: New, Improved, and Fixed. Filters out purely internal changes (refactors, dependencies). Use when the user asks for "release notes", "changelog for users", or "what's new" built from commits, diffs, or change lists.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/plaf-labs--human-release-notes/badge.svg)](/listings/plaf-labs--human-release-notes)

HTML

<a href="/listings/plaf-labs--human-release-notes"><img src="/api/listings/plaf-labs--human-release-notes/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

`SKILL.md` is the only file the AI needs. It is plain Markdown with no tool-specific dependencies.

Any AI chat

Paste the contents of `SKILL.md` as the system prompt, custom instructions, or first message.

Coding agents and IDEs

Put `SKILL.md` where your tool reads project instructions:

| Tool | Location | | --------------------------------------------- | ------------------------------------------------------------------------------ | | Claude Code | `~/.claude/skills/human-release-notes/SKILL.md` (or project `.claude/skills/`) | | Codex, Gemini CLI, others reading `AGENTS.md` | Append contents to `AGENTS.md` | | Cursor | Copy into `.cursor/rules/human-release-notes.mdc` | | GitHub Copilot | Append contents to `.github/copilot-instructions.md` |

Claude Code, command line:

mkdir -p ~/.claude/skills/human-release-notes
cp SKILL.md ~/.claude/skills/human-release-notes/

PowerShell:

New-Item -ItemType Directory -Force "$HOME\.claude\skills\human-release-notes" | Out-Null
Copy-Item SKILL.md "$HOME\.claude\skills\human-release-notes\"

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 53 lines
  1. ---
  2. name: human-release-notes
  3. description: Turns commits, a diff, or a technical change list into end-user release notes in three sections: New, Improved, and Fixed. Filters out purely internal changes (refactors, dependencies). Use when the user asks for "release notes", "changelog for users", or "what's new" built from commits, diffs, or change lists.
  4. ---
  5. # human-release-notes
  6. ## Input
  7. Accept any of:
  8. - Commit list (`git log` output, pasted messages).
  9. - Diff (`git diff`, patch).
  10. - Hand-written technical change list.
  11. If the input is empty or does not show what changed for the user, ask for more context before writing.
  12. ## Steps
  13. 1. Read the full input.
  14. 2. Drop purely internal changes: refactors, dependency changes, internal renames, tests, CI, formatting, code cleanup, version bumps.
  15. 3. Rewrite each remaining change from the user's point of view: what they can do now, what looks different, what no longer fails. No function, file, module, or technical jargon names.
  16. 4. Assign each change to exactly one section:
  17. - **New**: functionality that did not exist before.
  18. - **Improved**: something that existed and now works better, faster, or clearer.
  19. - **Fixed**: a bug the user could notice that no longer happens.
  20. 5. If a change does not clearly fit a section, or it is unclear whether users can see it, ask before including it.
  21. ## Output format
  22. Write the output in neutral Latin American Spanish.
  23. ```
  24. ## Nuevo
  25. - ...
  26. ## Mejorado
  27. - ...
  28. ## Corregido
  29. - ...
  30. ```
  31. - One bullet per change, one sentence, plain language.
  32. - Omit empty sections.
  33. - No version header or date unless the user asks for one.
  34. - No closing or summary.
  35. ## Rules
  36. - Output language: neutral Latin American Spanish (es-419), unless the user asks for another language. Avoid regional slang (voseo, "vos", "ustedes" forms specific to one country).
  37. - Do not invent features or benefits that are not in the input.
  38. - If a commit mixes a visible change with an internal one, include only the visible part.
  39. - If unsure, ask before generating the final document. Ask at most three questions at a time.
README.md · README · 79 lines
  1. # human-release-notes — AI release notes & changelog generator (Spanish)
  2. Turn git commits and diffs into clear, user-facing release notes in Spanish (es-419) with any AI assistant: Claude Code, Cursor, GitHub Copilot, Codex or ChatGPT.
  3. A skill that turns commits, diffs, or technical change lists into end-user release notes. Works with any AI assistant.
  4. Output has three sections: **New**, **Improved**, and **Fixed**. Purely internal changes (refactors, dependency bumps, tests, CI) are filtered out.
  5. Output language: neutral Latin American Spanish (es-419). Input can be in any language.
  6. ## Install
  7. `SKILL.md` is the only file the AI needs. It is plain Markdown with no tool-specific dependencies.
  8. ### Any AI chat
  9. Paste the contents of `SKILL.md` as the system prompt, custom instructions, or first message.
  10. ### Coding agents and IDEs
  11. Put `SKILL.md` where your tool reads project instructions:
  12. | Tool | Location |
  13. | --------------------------------------------- | ------------------------------------------------------------------------------ |
  14. | Claude Code | `~/.claude/skills/human-release-notes/SKILL.md` (or project `.claude/skills/`) |
  15. | Codex, Gemini CLI, others reading `AGENTS.md` | Append contents to `AGENTS.md` |
  16. | Cursor | Copy into `.cursor/rules/human-release-notes.mdc` |
  17. | GitHub Copilot | Append contents to `.github/copilot-instructions.md` |
  18. Claude Code, command line:
  19. ```bash
  20. mkdir -p ~/.claude/skills/human-release-notes
  21. cp SKILL.md ~/.claude/skills/human-release-notes/
  22. ```
  23. PowerShell:
  24. ```powershell
  25. New-Item -ItemType Directory -Force "$HOME\.claude\skills\human-release-notes" | Out-Null
  26. Copy-Item SKILL.md "$HOME\.claude\skills\human-release-notes\"
  27. ```
  28. ## Usage
  29. Ask your AI for release notes and paste or point to the source:
  30. ```
  31. Write release notes for users from these commits:
  32. <git log --oneline v1.2.0..HEAD>
  33. ```
  34. ```
  35. Release notes from this diff: <git diff v1.2.0..HEAD>
  36. ```
  37. If the input is unclear, the skill asks up to three questions before writing.
  38. ## Example output
  39. ```
  40. ## New
  41. - You can export your reports to CSV from the Reports screen.
  42. ## Improved
  43. - Search results load faster on large accounts.
  44. ## Fixed
  45. - Dates no longer show one day off for users in UTC-3.
  46. ```
  47. ## License
  48. MIT. See [LICENSE](LICENSE).
  49. ---
  50. Made by [PLAF Labs](https://github.com/plaf-labs) · Software, automation and web development for SMEs and
  51. industrial companies · [plaf.agency](https://plaf.agency)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.