ring:generating-release-guides

ring:generating-release-guides is a skill for Claude Code, Codex from LerianStudio/ring. It costs 85 tokens per session (1,744 once invoked), scanned A, original, Apache-2.0.

A read-only tool that creates an internal update and migration guide from the differences between two Git versions. The guide can describe operational impact, deployment order, monitoring, and rollback notes in English, Brazilian Portuguese, or both.

In plain words
What is it for?
Use it to compare branches or tags, document release changes, explain client impact, and prepare deployment and rollback guidance.
Why use it?
It turns code changes into information an operations team can use during a release. Its safety modes help avoid changing the current repository while collecting the needed details.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/lerianstudio/ring/generating-release-guides
Any agent
npx skills add LerianStudio/ring --skill generating-release-guides
Clone the repo
git clone --depth 1 https://github.com/LerianStudio/ring

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ring:generating-release-guides

README.md
[![agentmods](https://agentmods.dev/badge/skills/lerianstudio/ring/generating-release-guides.svg)](https://agentmods.dev/skills/lerianstudio/ring/generating-release-guides)
Your own site
<a href="https://agentmods.dev/skills/lerianstudio/ring/generating-release-guides"><img src="https://agentmods.dev/badge/skills/lerianstudio/ring/generating-release-guides.svg" alt="Measured on agentmods" height="20"></a>
Per session 85 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,744 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00085 $0.01744
Opus 5 $0.00043 $0.00872
Sonnet 5 $0.00017 $0.00349
Haiku 4.5 $0.00009 $0.00174

Measured 6d ago against content hash e464796dc41f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

ring:generating-release-guides scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

default/skills/generating-release-guides/SKILL.md · 158 lines

How it starts

The opening of the file, as written. The whole thing — 158 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Release Guide — Ops Update Guide Generator

When to use

  • Preparing to release a new version
  • Need to document what changed between refs
  • Creating operational update guide
  • Communicating version updates to Ops team

Skip when

  • No git repository available
  • Single file change (too small for formal guide)
  • Customer-facing release notes only (use simpler template)

Inputs

  • BASE_REF (string, required): e.g. main, v1.0.0
  • TARGET_REF (string, required): e.g. HEAD, v1.1.0
  • VERSION (string, optional): auto-detected from tags if not provided
  • LANGUAGE (enum, optional, default en): en, pt-br, both
  • MODE (enum, optional, default STRICT_NO_TOUCH): STRICT_NO_TOUCH, TEMP_CLONE_FOR_FRESH_REFS

Produce an internal Operations-facing update/migration guide from git diff analysis.

Safety Modes

STRICT_NO_TOUCH (default): Read-only git commands only. Forbidden: fetch, pull, push, checkout, switch, reset, commit, merge, rebase. If ref doesn't exist locally → STOP and suggest TEMP_CLONE mode.

TEMP_CLONE_FOR_FRESH_REFS: Clone to temp dir, fetch refs there, run all analysis in clone, cleanup after. Never touches current repo.

Process

Step 0: Execution Location

Determine mode. In TEMP_CLONE mode, create isolated clone before proceeding.

Step 1: Resolve Refs

git rev-parse --verify BASE_REF^{commit}   # verify both refs exist
git rev-parse --verify TARGET_REF^{commit}
BASE_SHA=$(git rev-parse --short BASE_REF)
TARGET_SHA=$(git rev-parse --short TARGET_REF)

Step 1.5: Version Detection

# If TARGET_REF is a tag, extract version
# Note: avoid /i flag (GNU-specific); use explicit case alternation for portability (macOS + Linux)
if git tag -l "$TARGET_REF" | grep -q .; then
    AUTO_VERSION=$(echo "$TARGET_REF" | sed -E 's/^[Vv]//;s/^[Rr]elease[-_]?//;s/^[Vv]ersion[-_]?//')
fi
# Priority: explicit VERSION > auto-detected > none (omit from title)

Step 1.6: Commit Log Analysis

git log --oneline --no-merges BASE_REF...TARGET_REF
git log --pretty=format:"%h %s%n%b" --no-merges BASE_REF...TARGET_REF

Parse commit prefixes: feat: → Feature, fix: → Bug Fix, refactor: → Improvement, breaking: / BREAKING CHANGE: → Breaking.

Read the full file on GitHub · 158 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 158 lines · 85 tokens per session scan A e464796dc41f

Subscribe to this mod's changes

ring:generating-release-guides is a skill published in the GitHub repository LerianStudio/ring (211 stars, last pushed 16d ago), licensed Apache-2.0. It adds 85 tokens to every session and 1,744 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.