agentleFS
UsermuseUsermuse/em-plugin/skills/release-notes/SKILL.md

release-notes

Skill0 starsChanged 3 months agoMITView on GitHub

Generate user-facing release notes / changelogs from tickets, PRDs, or git logs — organized by new features, improvements, fixes — with a 'You asked, we built' angle that finds the real customers who requested each shipped item via Evermuse. Use when the user wants to 'write release notes', 'create a changelog', 'announce what shipped', 'draft product update notes', or 'you asked we built'. Trigger terms: release notes, changelog, product update, what shipped, announcement notes, you asked we built. Not for internal-only engineering changelogs with no customer-facing change.

176 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use brainstorm-experiments-existing, brainstorm-ideas-new and 7 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • skytiger6724Skill

    brainstorm-experiments-existing

    Design experiments to test assumptions for an existing product — prototypes, A/B tests, spikes, and other low-effort validation methods. Use when validating assumptions, testing feature ideas cheaply, or planning product experiments.

    Also in 6 projects that use this

  • skytiger6724Skill

    brainstorm-ideas-new

    Brainstorm feature ideas for a new product in initial discovery from PM, Designer, and Engineer perspectives. Use when starting product discovery for a new product, exploring features for a startup idea, or doing initial ideation.

    Also in 6 projects that use this

  • 45ckSkill

    pestle-analysis

    Also in 6 projects that use this

  • About-IntelligenceSkill

    positioning-ideas

    Brainstorm product positioning ideas differentiated from competitors.

    Also in 6 projects that use this

  • About-IntelligenceSkill

    product-name

    Brainstorm 5 unique, memorable product names with rationale aligned to brand values and target audience.

    Also in 6 projects that use this

  • +4 more from skytiger6724

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 162 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Required — one parallel batch of searches: Verify the product (Rule 1), then fire in a single parallel batch:

    line 29
  2. Distinctive:

    Extract from raw material: Read all provided tickets, PRDs, git logs, changelogs.

    line 39
  3. Distinctive:

    If nothing in the corpus maps to an item, ship it plainly (don't invent a requester).

    line 46
  4. Distinctive:

    Never send without explicit user go-ahead.

    line 48

“Common” is measured: kept by at least 6 in 10 of the 162 edited versions of this file we could read. “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

Release Notes ("You asked, we built") — grounded in customer requests

Turn tickets/PRDs/git logs for $ARGUMENTS into polished, user-facing release notes — and make them land harder by naming the customers who actually asked for each shipped item. Internally, quote the requesters; externally, count them ("requested by 12 accounts"). This closes the loop and turns a changelog into evidence that you listen.

Step 0 — Relevance & availability

Confirm these are customer-facing changes and Evermuse is present. If the MCP isn't connected, produce the notes from the raw material but label them ⚠ ungrounded (no "you asked" attribution) and tell the user to authorize the MCP. (See ${CLAUDE_PLUGIN_ROOT}/skills/using-evermuse/SKILL.md, Step 0.)

Evermuse Grounding (required)

Follow ${CLAUDE_PLUGIN_ROOT}/skills/using-evermuse/SKILL.md.

Required — one parallel batch of searches. Verify the product (Rule 1), then fire in a single parallel batch:

  • 3–4 evidence searches, each worded from a different angle (limit up to 50). Evidence comes back rich and varied — expect large, useful result sets.
  • one guidance search and one context search (limit up to 50). These are usually sparse or empty; run them anyway and note when they're thin.

Read each response's digest — it reports how many more results exist. Use judgment on whether a query is worth pulling deeper (raise limit toward the 100 max and/or page with next_offset to avoid repeats), weighing payload size, remaining context, task complexity, and the value of the data. For deep pulls, consider spawning sub-agents — instruct them to return every citation with the same metadata the tools return (url, who_said_it, meeting_name, created_at) so you can still cite.

Optional — considered use. Once grounded, reach for the other tools only when they add value: a quote-angled search for verbatim voice, read_source for a single deep dive, inline citations (references/citations.md), and add_source to save the deliverable. Sources, citations, and saving are optional — not required.

Instructions

  1. Extract from raw material. Read all provided tickets, PRDs, git logs, changelogs. For each: what changed, who it affects, why it matters (the user benefit). Replace the source skill's "web search for product context" with the Evermuse corpus.
  2. Categorize: New Features · Improvements · Bug Fixes · Breaking Changes (action required) · Deprecations.
  3. Write benefit-first, jargon-free. 1–3 sentences per entry; lead with the user outcome, not the technical change. (e.g. "Dashboards load 3× faster" not "added Redis caching layer".)
  4. Add the "You asked, we built" layer per item:
    • a quote-angled search + an evidence search on the item's topic → the customers who asked.
    • Internal cut: quote 1–2 requesters verbatim, attributed and cited. 1
    • External cut: aggregate to a number — "Requested by 12 accounts" — no names or quotes.
    • If nothing in the corpus maps to an item, ship it plainly (don't invent a requester).
  5. Flag follow-up opportunities (optional). For high-demand items, offer to notify the specific requesters that their ask shipped, with a ready-to-send draft + the requester list. Never send without explicit user go-ahead.
  6. Match the product's voice — B2B professional, consumer friendly, or developer-focused.

Output

Two cuts when grounded: an internal version (with requester quotes cited inline) and an external version (aggregated counts, publish-ready). Plus an optional follow-up list of requesters per item.


Further reading

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.