Agent skill

Pre Release

by ZhuoZhuoCrayon in ZhuoZhuoCrayon/throttled-py

Automates release preparation for throttled-py. An agent skill from ZhuoZhuoCrayon/throttled-py.

MITAuto-check passedDevelopment

Install Pre Release

skills CLI
$ npx skills add ZhuoZhuoCrayon/throttled-py --skill pre-release -a claude-code

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

GitHub CLI
$ gh skill install ZhuoZhuoCrayon/throttled-py pre-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/ZhuoZhuoCrayon/throttled-py.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/pre-release .claude/skills/pre-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
pre-release
GitHub stars
651
Token cost
~1.1k tokens
SKILL.md length
267 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Automates release preparation for throttled-py. An agent skill from ZhuoZhuoCrayon/throttled-py.

  • Works in 7 steps: Parse Input → Get Release Changelog → Update Version Numbers → …
  • Sync CHANGELOGEN.rst and CHANGELOG.rst
  • SKILL.md covers Input Format, Workflow Overview, Step 1: Parse Input and Step 2: Get Release Changelog, plus 6 more sections
  • Calls uv

What it does

Pre Release is an agent skill from ZhuoZhuoCrayon/throttled-py. Automates release preparation for throttled-py. Triggers when user message contains: - "release vX.Y.Z" with a GitHub release draft URL - "release vX.Y.Z" followed by changelog content Tasks: update version numbers, sync CHANGELOGEN.rst and CHANGELOG.rst, run dependency sync.

Its SKILL.md is about 1.1k 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, Rate limiting and Translation. It works with GitHub, Redis and Python. The repository describes itself as: 🔧 High-performance Python rate limiting library with multiple algorithms (Fixed Window, Sliding Window, Token Bucket, Leaky Bucket & GCRA) and storage backends (Redis, In-Memory). The licence is MIT.

When your agent uses it

  • Sync CHANGELOGEN.rst and CHANGELOG.rst
  • Run dependency sync

Example prompts

  • “release vX.Y.Z”
  • “Use the pre-release skill to automate release preparation for throttled-py. An agent skill from ZhuoZhuoCrayon/throttled-py”
  • “/pre-release”

Workflow steps

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

  1. Parse Input
  2. Get Release Changelog
  3. Update Version Numbers
  4. Update CHANGELOG_EN.rst
  5. Translate & Update CHANGELOG.rst
  6. Sync Dependencies
  7. Verification

What it can do on your machine

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

    • uv

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

  • Network

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

Pre Release loads about 1.1k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 267 words of instructions outside code blocks.

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

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 ZhuoZhuoCrayon/throttled-py at commit 8626d3b, republished under its MIT licence (© ZhuoZhuoCrayon). 267 words, ~1,050 tokens.

Download SKILL.mdSave it as .claude/skills/pre-release/SKILL.md (or your agent's skills folder).
name
pre-release
description
Automates release preparation for throttled-py. Triggers when user message contains: - "release vX.Y.Z" with a GitHub release draft URL - "release vX.Y.Z" followed by changelog content Tasks: update version numbers, sync CHANGELOG_EN.rst and CHANGELOG.rst, run dependency sync.

Pre-Release Workflow

{REPO} = https://github.com/ZhuoZhuoCrayon/throttled-py

Input Format

# With release draft URL
release v3.2.0 {REPO}/releases/tag/untagged-xxxxx

# With changelog content directly
release v3.2.0
<paste release draft content here>

Workflow Overview

mermaid
flowchart TD
    A[Parse Input] --> B[Get Release Changelog]
    B --> C[Update Version Numbers]
    C --> D[Update CHANGELOG_EN.rst]
    D --> E[Translate & Update CHANGELOG.rst]
    E --> F[Sync Dependencies]
    F --> G[Verification]

Step 1: Parse Input

Extract from user input:

  • Version: vX.Y.Z → X.Y.Z
  • Release Date: Use today's date (YYYY-MM-DD)
  • Changelog: From URL or directly provided content

Step 2: Get Release Changelog

  • If URL provided: Fetch content from the release draft URL
  • If content provided: Use the changelog content directly
  • If neither accessible: Ask user to provide the content

Step 3: Update Version Numbers

Update version string in these files:

FileLocation
pyproject.tomlversion = "X.Y.Z"
throttled/__init__.py__version__ = "X.Y.Z"
throttled/asyncio/__init__.py__version__ = "X.Y.Z"

Step 4: Update CHANGELOG_EN.rst

Insert new entry after the title section:

rst
vX.Y.Z - YYYY-MM-DD
---------------------

`简体中文 (vX.Y.Z) <{GITHUB_REPOSITORY}/blob/main/CHANGELOG.rst#vxyz---YYYY-MM-DD>`_ | English

**{emoji} {category_title}**

- {change_entries}

**Full Changelog**: {GITHUB_REPOSITORY}/compare/vPREV...vX.Y.Z

Reference: Read .github/release-drafter-config.yml for:

  • Category titles and their emojis
  • Entry format template

Step 5: Translate & Update CHANGELOG.rst

Insert translated entry after the title section:

rst
vX.Y.Z - YYYY-MM-DD
---------------------

`English Documents Available (vX.Y.Z) <{GITHUB_REPOSITORY}/blob/main/CHANGELOG_EN.rst#vxyz---YYYY-MM-DD>`_ | 简体中文

**{emoji} {category_title_zh}**

- {translated_change_entries}

**完整更新日志**: {GITHUB_REPOSITORY}/compare/vPREV...vX.Y.Z
Translation Reference
EN CategoryZH Category
Breaking Changes破坏性变更
New Features功能
Improvements优化
Bug FixesBug 修复
Dependencies依赖项更新
Documentation文档
Tests测试
Maintenance维护工作
Common Translations
EnglishChinese
add / add support for添加 / 添加对 ... 的支持
fix / resolve修复
update / improve / optimize更新 / 改进 / 优化
implement实现
remove移除
refactor重构

Note: Preserve technical terms, @author mentions, and PR numbers.

Step 6: Sync Dependencies

Run the following command to update uv.lock:

bash
uv lock

This ensures uv.lock reflects the updated version in pyproject.toml.

Step 7: Verification

  • Version numbers consistent across all 3 files
  • uv.lock updated successfully
  • Cross-references between EN/ZH changelogs are correct
  • RST anchor format: #vxyz---YYYY-MM-DD (no dots, lowercase)
  • All categories from release draft included
  • Only include sections that have content
  • CRITICAL At the beginning of the verification summary, include:

    ✓ Conducted skill defined in .agents/skills/pre-release/SKILL.md.

Format Reference

Refer to existing entries in CHANGELOG.rst and CHANGELOG_EN.rst for exact formatting.

© ZhuoZhuoCrayon, 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 .agents/skills/pre-release of ZhuoZhuoCrayon/throttled-py.

Open the folder on GitHubat commit 8626d3b

Compare with similar skills

Pre 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.

Pre Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pre Release this skillZhuoZhuoCrayon/throttled-py651—~1.1kAutomated safety check: PassMIT
Release Changelogpipeshub-ai/pipeshub-ai3.8k—~2.7kAutomated safety check: PassApache-2.0
Go-Redis Release Preparationredis/go-redis22k—~1.1kAutomated safety check: PassBSD-2-Clause
pybind11 Release Publicationpybind/pybind1118k—~2.5kAutomated safety check: PassCustom licence
EverOS Release WorkflowEverMind-AI/EverOS13k—~1.3kAutomated safety check: PassApache-2.0
Rocketpy ReleaseRocketPy-Team/RocketPy1.1k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Release Changelog

    pipeshub-ai/pipeshub-ai

    Generate an enterprise-style changelog for a PipesHub GitHub release.

    3.8k GitHub stars~2.7k tokensUpdated today
    DevelopmentAuto-check passed
  • 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
  • Walks a maintainer through publishing a pybind11 release after the preparation PR merges, with preflight checks, confirmations before each push and a GitHub release.

    18k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • EverOS Release Workflow

    EverMind-AI/EverOS

    Walks through cutting a versioned everos release: bump the version, update the changelog, tag it, and review the drafted GitHub Release page before publishing.

    13k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Rocketpy Release

    RocketPy-Team/RocketPy

    Cut a new RocketPy release: prepare the version-bump branch, update the changelog and all version references, and guide the PR-to-master + PyPI flow.

    1.1k GitHub stars~1.3k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Release

    zmievsa/cadwyn

    Prepare and publish Cadwyn releases. An agent skill from zmievsa/cadwyn.

    309 GitHub stars~522 tokensUpdated yesterday
    DevelopmentAuto-check passed

Categories

Questions about Pre Release

What does Pre Release do?

Automates release preparation for throttled-py. An agent skill from ZhuoZhuoCrayon/throttled-py. Pre Release is an agent skill from ZhuoZhuoCrayon/throttled-py. Automates release preparation for throttled-py.

When should I use Pre Release?

Pre Release fits situations like: sync CHANGELOGEN.rst and CHANGELOG.rst; run dependency sync.

How do I install Pre Release in Claude Code?

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

How do I install Pre Release in Codex?

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

Can I use Pre 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 ZhuoZhuoCrayon/throttled-py --skill pre-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/pre-release, .gemini/skills/pre-release, .github/skills/pre-release and .opencode/skills/pre-release in your project.

What does Pre Release need to run?

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

Does Pre Release access the network?

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

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

Pre 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 Pre Release use?

About 1.1k tokens (SKILL.md is roughly 4.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 Pre Release?

Skills that share tags, products or a category with Pre Release: Release Changelog (pipeshub-ai/pipeshub-ai, 3.8k stars), Go-Redis Release Preparation (redis/go-redis, 22k stars), pybind11 Release Publication (pybind/pybind11, 18k stars) and EverOS Release Workflow (EverMind-AI/EverOS, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pre Release?

ZhuoZhuoCrayon (a GitHub user) maintains it in ZhuoZhuoCrayon/throttled-py, which has 651 GitHub stars. The repository was last updated on August 30, 2026.

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