Home / khaledsaeed18 / dotclaude · skills/version-control/release-tag/SKILL.md · GitHub

release-tag skillA

release-tag is agent-read markdown (skill) from khaledsaeed18/dotclaude: Cut a release by determining the SemVer bump from history, updating version files across any stack, refreshing the changelog, creating an annotated (optionally signed) Git tag, and pushing the release safely after pre-flight checks. Use when tagging a version, bumping the version, or preparing a release..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

Take the repo from "ready" to a clean, tagged, pushed release. Releases are outward-facing and effectively irreversible once published, so every step is gated by pre-flight checks and explicit confirmation.

## Hard rules: never break these

- **Never release a dirty or unverified tree.** Working tree clean, on the correct branch, up to date with the remote, and tests/CI green; all true before tagging.
- **Tags are immutable once published.** Never move or overwrite a pushed tag; if a release is wrong, cut a new patch version. Force-retagging breaks everyone who already pulled.
- **Follow SemVer honestly.** The bump must reflect what actually changed (see Step 2), not a convenient number.
- **Confirm before the commit, the tag, and the push.** These are the irreversible, outward-facing actions.
- **No AI/co-author trailers** in the release commit or tag message.
- **Publishing is downstream.** Tagging ≠ publishing to a registry. Don't run `npm publish` / `cargo publish` / etc. unless explicitly asked; most pipelines publish from CI on tag.

## Step 1: Pre-flight

- `git status` → clean tree (or stash/commit deliberate changes first).
…

Read the whole file at its exact version.

How to install

Latest version
mdr add khaledsaeed18/dotclaude/release-tag@git:20260608.0cc2133
Exact content
mdr add khaledsaeed18/dotclaude/release-tag@sha256:90ee5db569740715

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tb5ta6awlvibv3lp.svg)](https://markdownregistry.com/a/art_tb5ta6awlvibv3lp)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260608.0cc2133 latest2026-06-08 0cc2133 5,140 BA view · diff
git:20260606.7d504a82026-06-06 7d504a8 5,183 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5140 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

khaledsaeed18/dotclaude · 5 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tb5ta6awlvibv3lp
GET https://markdownregistry.com/api/v1/resolve?ref=khaledsaeed18/dotclaude/release-tag
GET https://markdownregistry.com/api/v1/blob/90ee5db569740715e3de5f3ff0d7e5a5d94c46fae24b885a4b37a4bd453b941d

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from khaledsaeed18/dotclaude

improve skill
khaledsaeed18/dotclaude · .agents/skills/improve/SKILL.md · Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER…
v1.0.0 · audit B · 5 stars
adr-writing skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/docs/skills/adr-writing/SKILL.md · Write Architecture Decision Records that a future engineer can act on: a numbered, immutable record with the context…
git:20260921.b628018 · audit A · 5 stars
openapi-spec skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/docs/skills/openapi-spec/SKILL.md · Write, generate, or review an OpenAPI 3.1 specification for an HTTP API so that it is accurate to the implementation…
git:20260921.b628018 · audit A · 5 stars
readme-writing skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/docs/skills/readme-writing/SKILL.md · Write or restructure a README that gets a reader from landing to first success in minutes: a one-line purpose, a…
git:20260921.b628018 · audit A · 5 stars
technical-writing skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/docs/skills/technical-writing/SKILL.md · Write and edit developer documentation, guides, design notes, and engineering blog posts with a working writer's…
git:20260921.b628018 · audit A · 5 stars
adversarial-reviewer skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/engineering/skills/adversarial-reviewer/SKILL.md · Review code through three hostile personas - the Saboteur, the New Hire, and the Security Auditor - each required to…
git:20260704.5149f4c · audit A · 5 stars
api-design-review skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/engineering/skills/api-design-review/SKILL.md · Review an API contract (REST or GraphQL) before or while it is implemented, checking resource naming, HTTP semantics…
git:20260921.b1a4652 · audit A · 5 stars
code-review-response skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/engineering/skills/code-review-response/SKILL.md · Process code-review feedback with technical rigour. Understand each point, check it against the actual codebase, and…
git:20260921.36d6832 · audit A · 5 stars
db-migration-safety skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/engineering/skills/db-migration-safety/SKILL.md · Review or write a database schema migration with production safety as the bar, checking locks, table rewrites…
git:20260921.4ccfb75 · audit A · 5 stars
dependency-upgrade skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/engineering/skills/dependency-upgrade/SKILL.md · Upgrade dependencies without breaking the project: audit what is outdated and why it matters (security, EOL, features)…
git:20260921.8d3f9eb · audit A · 5 stars
dockerfile-best-practices skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/engineering/skills/dockerfile-best-practices/SKILL.md · Write or review a Dockerfile and compose setup for a production service: multi-stage builds that ship only the runtime…
git:20260921.8d3f9eb · audit A · 5 stars
error-handling-patterns skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/engineering/skills/error-handling-patterns/SKILL.md · Design and review error handling in a codebase: which errors are expected results versus bugs, typed error hierarchies…
git:20260921.8d3f9eb · audit A · 5 stars

Every file in khaledsaeed18/dotclaude

Other files named release-tag

release-tag skill
khaledsaeed18/dotclaude · .claude-plugin/plugins/git/skills/release-tag/SKILL.md · Cut a release by determining the SemVer bump from history, updating version files across any stack, refreshing the…
git:20260704.5149f4c · audit A · 5 stars

Browse by kind, by grade A, or by owner.