Agent skill

Create New Release

by ClickHouse in ClickHouse/pg_stat_ch

Create and push a new semver release tag. An agent skill from ClickHouse/pg_stat_ch.

Apache-2.0Auto-check passedDatabases

Install Create New Release

skills CLI
$ npx skills add ClickHouse/pg_stat_ch --skill create-new-release -a claude-code

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

GitHub CLI
$ gh skill install ClickHouse/pg_stat_ch create-new-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/ClickHouse/pg_stat_ch.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/create-new-release .claude/skills/create-new-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
create-new-release
GitHub stars
124
Token cost
~488 tokens
SKILL.md length
221 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Create and push a new semver release tag. An agent skill from ClickHouse/pg_stat_ch.

  • Works in 8 steps: Ask release type: Use AskUserQuestion to… → Fetch latest tags from remote → Get the latest semver tag (assumes v… → …
  • Databases work in your project
  • SKILL.md covers Steps, Version Parsing and Error Handling
  • Calls git

What it does

Create New Release is an agent skill from ClickHouse/pg_stat_ch. Create and push a new semver release tag. Asks for release type (patch/minor/major), validates commit exists on remote, bumps version, and pushes the tag.

Its SKILL.md is about 490 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 Databases. It works with ClickHouse and PostgreSQL. The licence is Apache-2.0.

When your agent uses it

  • Databases work in your project

Example prompts

  • “/create-new-release”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Ask release type: Use AskUserQuestion to ask if this is a patch, minor, or major release.
  2. Fetch latest tags from remote
  3. Get the latest semver tag (assumes v prefix like v1.2.3)
  4. Parse and bump version based on user selection
  5. Verify META.json version matches the new tag
  6. Validate current commit exists on remote
  7. Create and push the tag
  8. Report success with the new tag name.

What it can do on your machine

Read from SKILL.md and the folder at commit 89afc40. 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:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use 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

Create New Release loads about 488 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 221 words of instructions outside code blocks.

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

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 ClickHouse/pg_stat_ch at commit 89afc40, republished under its Apache-2.0 licence (© ClickHouse). 221 words, ~488 tokens.

Download SKILL.mdSave it as .claude/skills/create-new-release/SKILL.md (or your agent's skills folder).
name
create-new-release
description
Create and push a new semver release tag. Asks for release type (patch/minor/major), validates commit exists on remote, bumps version, and pushes the tag.

Create New Release

Create and push a new semantic version release tag.

Steps

  1. Ask release type: Use AskUserQuestion to ask if this is a patch, minor, or major release.

  2. Fetch latest tags from remote:

    bash
    git fetch --tags origin
  3. Get the latest semver tag (assumes v prefix like v1.2.3):

    bash
    git tag --sort=-version:refname -l 'v*' | head -1
  4. Parse and bump version based on user selection:

    • patch: v1.2.3 → v1.2.4
    • minor: v1.2.3 → v1.3.0
    • major: v1.2.3 → v2.0.0
  5. Verify META.json version matches the new tag: Read META.json and check that both version and provides.pg_stat_ch.version match the new version (without the v prefix). If they don't match, abort and tell the user to update META.json first — PGXN uses this file for the release version.

  6. Validate current commit exists on remote:

    bash
    git fetch origin
    git branch -r --contains HEAD

    If no remote branch contains HEAD, abort with an error asking the user to push their commits first.

  7. Create and push the tag:

    bash
    git tag -a <new_version> -m "Release <new_version>"
    git push origin <new_version>
  8. Report success with the new tag name.

Version Parsing

Parse version from tag like v1.2.3:

  • Extract numbers after v prefix
  • Split by . to get major, minor, patch components
  • Handle edge case: if no tags exist, start at v0.1.0

Error Handling

  • If current commit is not on remote: "Current commit is not pushed to remote. Please push your changes first."
  • If tag already exists: "Tag already exists. Please check existing tags."
  • If git operations fail: Report the specific error.

© ClickHouse, Apache-2.0. 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/create-new-release of ClickHouse/pg_stat_ch.

Open the folder on GitHubat commit 89afc40

Compare with similar skills

Create New 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.

Create New Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Create New Release this skillClickHouse/pg_stat_ch124—~488Automated safety check: PassApache-2.0
Clickhouse Logs Queriessupabase/supabase111k—~2.4kAutomated safety check: PassApache-2.0
Chdb SQLvemetric/vemetric3941 repos~1.2kAutomated safety check: PassApache-2.0
Observal AdminObserval/Observal4.2k—~774Automated safety check: PassApache-2.0
Querying Tempotempoxyz/tidx107—~3.1kAutomated safety check: PassMIT
Local Platform E2Ecomputesdk/benchmarks126—~3kAutomated safety check: NotesMIT

Similar skills

  • Clickhouse Logs Queries

    supabase/supabase

    Official

    Write, review, and migrate Supabase logs queries against the ClickHouse-backed logs table (the logs.all.otel analytics endpoint).

    111k GitHub stars~2.4k tokensUpdated today
    DatabasesAuto-check passed
  • Chdb SQL

    vemetric/vemetric

    A skill your agent uses when the user wants to run SQL — especially analytical SQL — on local files (parquet/csv/json), URLs, S3 paths, or remote databases (Postgres, MySQL, MongoDB, ClickHouse…

    394 GitHub starsUsed in 1 repo~1.2k tokens
    DatabasesAuto-check passed
  • Observal Admin

    Observal/Observal

    Administers Observal users, settings, diagnostics, review queues, security events, audit logs, SAML, SCIM, the local Observal server, its upgrades and rollback, and its own PostgreSQL and ClickHouse…

    4.2k GitHub stars~774 tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Querying Tempo

    tempoxyz/tidx

    Query indexed Tempo chain data via tidx HTTP API and CLI. An agent skill from tempoxyz/tidx.

    107 GitHub stars~3.1k tokensUpdated today
    DatabasesAuto-check passed
  • Local Platform E2E

    computesdk/benchmarks

    Stand up benchmarks-platform locally (Postgres + MinIO + ClickHouse in docker) and run a real @benchsdk/runner benchmark against it, with no cloud or provider credentials.

    126 GitHub stars~3k tokensUpdated yesterday
    DatabasesAuto-check: notes
  • Clickhouse Managed Postgres Rca

    ClickHouse/agent-skills

    MUST USE when investigating performance issues on a ClickHouse-managed Postgres instance.

    544 GitHub stars~1.2k tokensUpdated 9 days ago
    DatabasesAuto-check passed

More from ClickHouse/pg_stat_ch

  • Cpp Header Template

    ClickHouse/pg_stat_ch

    Generate C++ header files following Google Style Guide. An agent skill from ClickHouse/pg_stat_ch.

    124 GitHub stars~772 tokensUpdated today
    Auto-check passed
  • Cpp Naming Check

    ClickHouse/pg_stat_ch

    Check C++ naming conventions against Google Style Guide. An agent skill from ClickHouse/pg_stat_ch.

    124 GitHub stars~701 tokensUpdated today
    Auto-check passed
  • Cpp Review

    ClickHouse/pg_stat_ch

    Review C++ code against Google C++ Style Guide. An agent skill from ClickHouse/pg_stat_ch.

    124 GitHub stars~609 tokensUpdated today
    Auto-check passed
  • Google Cpp Style

    ClickHouse/pg_stat_ch

    Google C++ Style Guide rules for writing clean, maintainable C++ code.

    124 GitHub stars~951 tokensUpdated today
    Auto-check passed

Categories

Questions about Create New Release

What does Create New Release do?

Create and push a new semver release tag. An agent skill from ClickHouse/pg_stat_ch. Create New Release is an agent skill from ClickHouse/pg_stat_ch. Create and push a new semver release tag.

When should I use Create New Release?

Create New Release fits situations like: databases work in your project.

How do I install Create New Release in Claude Code?

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

How do I install Create New Release in Codex?

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

Can I use Create New 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 ClickHouse/pg_stat_ch --skill create-new-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/create-new-release, .gemini/skills/create-new-release, .github/skills/create-new-release and .opencode/skills/create-new-release in your project.

What does Create New Release need to run?

Going by SKILL.md and its folder, Create New Release needs the command-line tools its instructions call (git).

Does Create New Release access the network?

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

Is Create New 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 Create New Release use?

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

How many tokens does Create New Release use?

About 488 tokens (SKILL.md is roughly 2k 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 Create New Release?

Skills that share tags, products or a category with Create New Release: Clickhouse Logs Queries (supabase/supabase, 111k stars), Chdb SQL (vemetric/vemetric, 394 stars), Observal Admin (Observal/Observal, 4.2k stars) and Querying Tempo (tempoxyz/tidx, 107 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Create New Release?

ClickHouse (a GitHub organization) maintains it in ClickHouse/pg_stat_ch, which has 124 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 8, 2026.

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