skill-release - SKILL.md Agent Skill

name: skill-release description: (project - Skill) Sync and publish skills from .agents/skills/ to skills/ directory with version bumping and git automation. Use when releasing or updating skills, triggered by "release skills", "publish skills", "sync skills", "deploy skills", or when skill development is complete.

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