upgrade-examples - SKILL.md Agent Skill

name: upgrade-examples description: This skill should be used when upgrading the cocoindex package version in all example pyproject.toml files. It uses regex-based sed commands to efficiently update version constraints across multiple files at once.

Upgrade Example Dependencies

Upgrade the cocoindex version in all example pyproject.toml files.

Usage

/upgrade-examples <version>

Example: /upgrade-examples 1.0.0a5

Instructions

To upgrade all example dependencies (replace VERSION with the actual version, e.g., 1.0.0a10):

Create a new branch for the changes:

git checkout -b ex-dep-VERSION

Run the following command to update all example pyproject.toml files.

Important: Use the literal version string directly in the sed command. Do not use shell variables as quoting issues can cause the version to be omitted.

find examples -name "pyproject.toml" -not -path "*/.venv/*" -exec grep -l "cocoindex" {} \; | xargs sed -i '' 's/cocoindex\([^>]*\)>=[0-9][0-9a-zA-Z.]*/cocoindex\1>=VERSION/g'

Verify the changes show the correct version:

grep -r "cocoindex.*>=" examples --include="pyproject.toml" | grep -v ".venv"

Commit and push the changes:

git add examples/*/pyproject.toml
git commit -m "chore: upgrade examples deps to cocoindex-VERSION"
git push -u origin ex-dep-VERSION

Create a PR using the gh CLI and capture the PR URL from its output:

gh pr create --base v1 --title "chore: upgrade examples deps to cocoindex-VERSION" --body ""

Switch back to the previous branch and delete the local branch:

git checkout v1
git branch -d ex-dep-VERSION

Report the number of files updated and provide the PR link from the gh pr create output to the user.