Agent skill

Release

by yoanbernabeu in yoanbernabeu/grepai

Create a new release for grepai. An agent skill from yoanbernabeu/grepai.

MITAuto-check passedDevelopment

Install Release

skills CLI
$ npx skills add yoanbernabeu/grepai --skill release -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yoanbernabeu/grepai release --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yoanbernabeu/grepai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/release .claude/skills/release && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
release
GitHub stars
1.9k
Token cost
~918 tokens
SKILL.md length
311 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Create a new release for grepai. An agent skill from yoanbernabeu/grepai.

  • Works in 8 steps: Verify CI on Main → Get Current Version and Changes → Determine Version Type → …
  • Tasks that involve Changelog and release notes
  • SKILL.md covers When to Use This Skill, Release Workflow, Contributor Credits and Checklist, plus 1 more section
  • Calls gh, git and make

What it does

Release is an agent skill from yoanbernabeu/grepai. Create a new release for grepai. Checks CI, determines version type, updates CHANGELOG and documentation, credits contributors, and creates GitHub release.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Changelog and release notes and Codebase onboarding. It works with GitHub, Model Context Protocol and Go. The repository describes itself as: Semantic Search & Call Graphs for AI Agents (100% Local). The licence is MIT.

When your agent uses it

  • Tasks that involve Changelog and release notes
  • Tasks that involve Codebase onboarding

Example prompts

  • “/release”

Requirements

  • Docker

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Verify CI on Main
  2. Get Current Version and Changes
  3. Determine Version Type
  4. Update Version Files
  5. Commit and Push
  6. Wait for CI
  7. Create GitHub Release
  8. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit eb941fe. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git
    • make

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Release loads about 918 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 311 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~918

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yoanbernabeu/grepai at commit eb941fe, republished under its MIT licence (© yoanbernabeu). 311 words, ~918 tokens.

Download SKILL.mdSave it as .claude/skills/release/SKILL.md (or your agent's skills folder).
name
release
description
Create a new release for grepai. Checks CI, determines version type, updates CHANGELOG and documentation, credits contributors, and creates GitHub release.

Release Process for grepai

This skill guides you through creating a new release. All output must be in English.

When to Use This Skill

Invoke this skill when:

  • User asks to "create a release"
  • User asks to "publish a new version"
  • User asks to "bump the version"
  • User mentions "release" in the context of versioning

Release Workflow

Step 1: Verify CI on Main

Check that all CI checks pass on main:

bash
gh run list --branch main --limit 1 --json status,conclusion,name

STOP if CI is not green. Ask the user to fix issues first.

Step 2: Get Current Version and Changes

Get the latest release:

bash
gh release list --limit 1

List merged PRs since last release:

bash
gh pr list --state merged --base main --json number,title,author,mergedAt,labels --limit 50

Display a summary of changes categorized by type (feat, fix, docs, etc.).

Step 3: Determine Version Type
Change TypeVersion Bump
Breaking changesMajor (vX+1.0.0)
New features (feat)Minor (vX.Y+1.0)
Bug fixes (fix)Patch (vX.Y.Z+1)
Docs/chore onlyUsually no release needed

Ask user confirmation before proceeding.

Step 4: Update Version Files
4.1 CHANGELOG.md

Add new section after ## [Unreleased]:

markdown
## [X.Y.Z] - YYYY-MM-DD

### Added
- **Feature Name**: Description (#PR) - @author

### Fixed
- **Fix Name**: Description (#PR) - @author

Update comparison links at bottom:

markdown
[Unreleased]: https://github.com/yoanbernabeu/grepai/compare/vX.Y.Z...HEAD
[X.Y.Z]: https://github.com/yoanbernabeu/grepai/compare/vPREVIOUS...vX.Y.Z
4.2 Documentation Hero

Update version in docs/src/components/homepage/HeroAnimated.astro line 6:

astro
const { version = "X.Y.Z" } = Astro.props;
4.3 Nix Flake

Update flake.nix:

  1. Update version (line 13):
nix
version = "X.Y.Z";
  1. Update vendorHash:
    • Set vendorHash = ""; temporarily in flake.nix
    • Run make nix-hash to compute the correct hash (requires Docker)
    • Replace with the new hash: vendorHash = "sha256-XXXXX";
    • If Docker is not available, ask the user to provide the hash or skip this step
Step 5: Commit and Push
bash
git add CHANGELOG.md docs/src/components/homepage/HeroAnimated.astro flake.nix
git commit -m "chore(release): bump version to X.Y.Z

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
git push origin main
Step 6: Wait for CI
bash
gh run list --branch main --limit 1 --json status,conclusion --watch
Step 7: Create GitHub Release
bash
gh release create vX.Y.Z --generate-notes --title "vX.Y.Z"
Step 8: Verify
bash
gh release view vX.Y.Z

Contributor Credits

IMPORTANT: Always credit PR authors in CHANGELOG:

markdown
- **Pascal/Delphi Support**: Add `.pas` and `.dpr` file support (#71) - @yoanbernabeu

GitHub --generate-notes automatically credits contributors in release notes.

Checklist

  • CI green on main before starting
  • Version type matches changes (major/minor/patch)
  • CHANGELOG.md updated with all PRs
  • All contributors credited with @username
  • Hero version updated in docs
  • Nix flake version and vendorHash updated in flake.nix
  • CI passed after version commit
  • GitHub release created

Keywords

release, version, bump, publish, changelog, semver, semantic versioning

© yoanbernabeu, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/release of yoanbernabeu/grepai.

Open the folder on GitHubat commit eb941fe

Compare with similar skills

Release next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Release this skillyoanbernabeu/grepai1.9k—~918Automated safety check: PassMIT
Go-Redis Release Preparationredis/go-redis22k—~1.1kAutomated safety check: PassBSD-2-Clause
GitDiagram Repository Overviewahmedkhaleel2004/gitdiagram18k—~427Automated safety check: PassMIT
Plane Release Notes Generatormakeplane/plane60k—~2.5kAutomated safety check: PassAGPL-3.0
Release Prepjohnhuang316/code-index-mcp1k—~680Automated safety check: PassMIT
Store Submitzhitongblog/solomd1.2k—~1.7kAutomated safety check: NotesMIT

Similar skills

  • Official

    Prepares a go-redis release locally: picks the next semver, gathers merged PRs, writes the RELEASE-NOTES entry and bumps versions, without publishing.

    22k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • GitDiagram Repository Overview

    ahmedkhaleel2004/gitdiagram

    Explains the architecture of a public GitHub repository through GitDiagram: how the code is organized, the main components with paths, and a Mermaid diagram.

    18k GitHub stars~427 tokensUpdated today
    DevelopmentAuto-check passed
  • Builds categorized release notes for a Plane release pull request from its commits and writes them into the PR description, for both the plane-cloud and plane-ee repos.

    60k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Release Prep

    johnhuang316/code-index-mcp

    A skill your agent uses when code-index-mcp implementation is complete and a version bump, release notes, tag, package publication, or GitHub release is being prepared.

    1k GitHub stars~680 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Store Submit

    zhitongblog/solomd

    Publish a SoloMD release to the stores that have no usable submission API — Google Play Console and Microsoft Partner Center — by driving them through the local Unzoo Browser REST API.

    1.2k GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Octocode Code Research

    bgauryy/octocode

    Researches code with evidence: traces callers, imports and cross-repo links, diagnoses failures and reports findings with exact file and line references and a confidence label.

    946 GitHub stars~1.5k tokensUpdated 4 days ago
    DevelopmentAuto-check passed

More from yoanbernabeu/grepai

  • Grepai

    yoanbernabeu/grepai

    Semantic code search and call-graph tracing. An agent skill from yoanbernabeu/grepai.

    1.9k GitHub stars~1.1k tokensUpdated 16 days ago
    Auto-check passed

Categories

Questions about Release

What does Release do?

Create a new release for grepai. An agent skill from yoanbernabeu/grepai. Release is an agent skill from yoanbernabeu/grepai. Create a new release for grepai.

When should I use Release?

Release fits situations like: tasks that involve Changelog and release notes; tasks that involve Codebase onboarding.

How do I install Release in Claude Code?

Run `npx skills add yoanbernabeu/grepai --skill release -a claude-code`. Or copy the skill folder (.claude/skills/release in yoanbernabeu/grepai) into .claude/skills/release in your project. Claude Code loads it when a task matches its description.

How do I install Release in Codex?

Run `npx skills add yoanbernabeu/grepai --skill release -a codex`. Or copy the skill folder (.claude/skills/release in yoanbernabeu/grepai) into .agents/skills/release in your project. Codex loads it when a task matches its description.

Can I use Release in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yoanbernabeu/grepai --skill release -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/release, .gemini/skills/release, .github/skills/release and .opencode/skills/release in your project.

What does Release need to run?

Going by SKILL.md and its folder, Release needs the command-line tools its instructions call (gh, git and make). Our summary lists: Docker.

Does Release access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Release safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Release use?

Release is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Release use?

About 918 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Release?

Skills that share tags, products or a category with Release: Go-Redis Release Preparation (redis/go-redis, 22k stars), GitDiagram Repository Overview (ahmedkhaleel2004/gitdiagram, 18k stars), Plane Release Notes Generator (makeplane/plane, 60k stars) and Release Prep (johnhuang316/code-index-mcp, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Release?

yoanbernabeu (a GitHub user) maintains it in yoanbernabeu/grepai, which has 1,903 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 21, 2026.

Source: yoanbernabeu/grepai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.