Skill Release

Sync skills from .agents/skills/ to skills/ directory, bump version numbers, and push to git.

Quick Start

Release all skills with changes

scripts/release_skill.py

Preview changes without executing

scripts/release_skill.py --dry-run

Release specific skill only

scripts/release_skill.py --skill jimeng-api-image-gen

Workflow

• Scan .agents/skills/ for all skills with SKILL.md

• Compare with skills/ directory using content hash

• Copy changed skills, updating version (patch bump)

• Commit with git add . && git commit -m "chore: release skills"

• Push to remote repository

Version Management

Version is stored in package.json at skill root:

skill-name/ ├── SKILL.md ├── package.json # contains "version": "1.2.3" └── scripts/

• First release: 1.0.0

• Updates: patch bump (1.2.3 → 1.2.4 )

• Semver format: major.minor.patch

Command Options

Option Description

--dry-run

Preview changes without executing

--skill NAME

Process only the specified skill

Project Structure

project/ ├── .agents/skills/ # Development source │ ├── skill-a/ │ │ └── SKILL.md │ └── skill-b/ │ └── SKILL.md └── skills/ # Release destination ├── skill-a/ │ └── SKILL.md # Version added/updated └── skill-b/ └── SKILL.md

Requirements

• Python 3.8+

• Git repository with push access

• .agents/skills/ and skills/ directories

Notes

• Only skills with SKILL.md are processed

• Unchanged skills are skipped

• Git operations require clean working directory