agentleFS
victorhqcvictorhqc/filbert/.agents/skills/release-highlights/SKILL.md

release-highlights

Skill4 starsChanged 12 days agoMITView on GitHub

Write the in-app "What's New" highlights for a Filbert release — add the version's entry to Sources/App/Resources/ReleaseHighlights.json, with one plain sentence per feature or fix in every supported language. Use this after the release-notes skill, or whenever the user asks for "highlights", "what's new text", or the release workflow fails because the version has no highlights entry.

  • Commits and pushes

4 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions4 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 4

    1. leanprover/lean4★ 10ksame name
    2. Lingyan000/fluxdo★ 2.6ksame name
    3. muxy-app/muxy★ 2.4ksame name
    4. garfiec/Librechat-Mobile★ 160same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository4 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

11 rules. 0 are common, 3 are distinctive, and 8 are very specific to this project.

  • 0

    Common

    Most of the 3 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 8

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    After an update, Filbert shows a short list of what is new in each version.

    line 8
  2. Distinctive:

    Never touch git. Edit the file, validate it, and give the user the commands.

    line 14
  3. Very specific:

    Ask for the version, or read it from the draft release: gh release list --limit 5.

    line 18
  4. Very specific:

    Read the source text: gh release view v<version> --json isDraft,body.

    line 20
  5. Distinctive:

    Use only the Overview, Features, and Bug Fixes sections.

    line 22
  6. Very specific:

    If there is no Features and no Bug Fixes section, write an entry with an empty items list.

    line 26
  7. Very specific:

    Write a value for every language in Sources/App/SupportedLanguage.swift.

    line 49
  8. Very specific:

    Read docs/localization-glossary.md first.

    line 52
  9. Very specific:

    Add the entry at the top of the list.

    line 64
  10. Very specific:

    Keep the existing format: two-space indent, kind then text, languages in the order above.

    line 65
  11. Distinctive:

    Run both. Fix the entry until they pass.

    line 79

“Common” is measured: kept by at least 6 in 10 of the 3 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 highlights

After an update, Filbert shows a short list of what is new in each version. Sparkle's update dialog shows the same list in English. The text comes from Sources/App/Resources/ReleaseHighlights.json, which ships inside the app. So the entry must be merged to main before the release is published. The release workflow fails when the entry is missing.

Never touch git. Edit the file, validate it, and give the user the commands.

1. Find the version and the source text

  1. Ask for the version, or read it from the draft release: gh release list --limit 5. The version is the tag without the v, for example 0.26.0.
  2. Read the source text: gh release view v<version> --json isDraft,body. If the user just ran the release-notes skill, use that text.
  3. Use only the Overview, Features, and Bug Fixes sections. Do not read the Changes list, commits, or PRs. The highlights say less than the release notes, never more.

If there is no Features and no Bug Fixes section, write an entry with an empty items list. That tells the app that this release has nothing to show.

2. Write the English items

At most 5 items. Pick what a user notices. Merge small related changes into one item.

Each item:

  • has kind feature (something new the user can do or see) or fix (something that was broken and now works);
  • is one sentence, at most 140 characters, ending with .;
  • says what the user sees, not how the code works;
  • uses plain words. No Markdown, links, HTML, emoji, or version numbers;
  • names a provider the way the app does: Claude Code, Codex, Cursor, DeepSeek, Gemini CLI, Kimi API, Kimi Code, OpenCode Go, Z.ai;
  • claims nothing that the source text does not say.

Good: Kimi Code's weekly and monthly rows now show when the allowance runs out. Bad: Refactored KimiCodeForecast to use the shared pacing engine (#108).

3. Translate

Write a value for every language in Sources/App/SupportedLanguage.swift. Today: en, de-DE, es-MX, es-ES, pt-BR, pt-PT, ru, zh-Hans, zh-Hant, ja.

  • Read docs/localization-glossary.md first. Use its terms and follow its deny lists. The tests fail on a denied term.
  • Carry the meaning in the language's own idiom, not word for word.
  • es-MX and es-ES, and pt-BR and pt-PT, are separate. Write each one for its region, even when the words come out the same.
  • zh-Hant uses Taiwan terms, with no space between Han characters and Latin letters or digits. ja has no space between kana or kanji and Latin letters or digits.
  • "Filbert" and provider names stay in Latin letters.
  • Each value is one line, with no Markdown.

4. Edit the file

Add the entry at the top of the list. If the version is already there, replace it. Keep the existing format: two-space indent, kind then text, languages in the order above.

{
  "version": "0.26.0",
  "items": [
    { "kind": "feature", "text": { "en": "…", "de-DE": "…", "…": "…" } }
  ]
}

5. Validate

Run both. Fix the entry until they pass.

python3 scripts/validate-release-highlights.py --require-version <version>
swift test --filter AppTests.ReleaseHighlightsTests

The first checks the shape, the languages, and the English rules. The second checks the glossary deny lists and the Traditional Chinese characters.

6. Hand off

Show the user:

  1. The English items, as a list with their kind.
  2. A note that the translations need a native review before the merge.
  3. The commands to run. Do not run them:
git switch -c release-highlights/v<version>
git add Sources/App/Resources/ReleaseHighlights.json
git commit -m "chore: add release highlights for <version>"
git push -u origin release-highlights/v<version>
gh pr create --fill --base main

Then remind the user of the order: merge this PR, then publish the release.

Before you hand it back

  • The entry is at the top, and its version matches the release.
  • Every item comes from the Overview, Features, or Bug Fixes text.
  • At most 5 items. Each English text is one sentence of 140 characters or fewer.
  • Every supported language has a value.
  • Both validation commands pass.
  • You gave the git commands and did not run them.

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.