agentleFS
ZhuoZhuoCrayonZhuoZhuoCrayon/throttled-py/.agents/skills/pre-release/SKILL.md

pre-release

Skill656 starsChanged 7 months agoMITView on GitHub

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.

6 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions6 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 6

    1. mattpocock/sandcastle★ 9.1ksame name
    2. rusq/slackdump★ 2.9ksame name
    3. Cosmian/kms★ 378same name
    4. paiml/aprender★ 141same name
    5. marcfargas/skills★ 4same name
    6. nrflo/nrflo★ 2same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository2 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 4 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Release Date: Use today's date (YYYY-MM-DD)

    line 41
  2. Distinctive:

    If URL provided: Fetch content from the release draft URL

    line 46
  3. Distinctive:

    If content provided: Use the changelog content directly

    line 47
  4. Distinctive:

    If neither accessible: Ask user to provide the content

    line 48
  5. Distinctive:

    Update version string in these files:

    line 52
  6. Very specific:

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

    line 77
  7. Very specific:

    Run the following command to update uv.lock:

    line 126

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

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:

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:

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:

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.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.