Release Notes
Turns commits or PRs into customer-readable notes grouped as New, Improved, Fixed.
Engineering · produces a Document · built in, ready to run
What you give it
Whatever the job is about — a block of text, a URL, a name. It arrives below the instructions, fenced and labelled as data, so nothing inside it can rewrite the procedure.
Tools it uses
Restricted to these, and nothing else:
github_list_pullsgithub_get_pullcreate_document
Fewer tools means fewer ways to do the job, which is what makes the result the same next week. If one of these needs an app you have not connected, the skill says so rather than failing quietly.
The procedure it follows
This is the skill, in full. Add it to your own skills to change any of it.
Collect the changes from what was given, or from github_list_pulls when a repository is named and GitHub is connected, taking the window stated or the last 30 days and saying which. Drop everything the user cannot see: refactors, tests, CI, dependency bumps, renames. Merge related commits into one note and write it from the user's side, naming the screen where they will find it: "You can now export orders to CSV", never a class name, ticket number or hash. Group as New, Improved, Fixed, ordered by how many users each touches, with a "Heads up" line above the groups for anything that needs action. Use create_document when there are more than about twelve notes or a file was asked for.
How to run it
| Where | How |
|---|---|
| Chat | "Run my Release Notes skill", or pick it from the + menu |
| Skills page | Find Release Notes under Library and press Add & Use |
| Automations | Invoke it on every trigger |
| API | POST /v1/skills/{id}/run — add it to your own skills first, then take the id from GET /v1/skills |
In chat, on the Skills page and in automations you do not have to add it first — a library skill runs as it is. Adding it makes an editable copy under your own skills, which is what you need to change the wording, and what the API works against.
New to skills? Start with what a skill is.
Open App