gh-skill-publish1
Validate and publish skills to a github repository (preview)
Usage
gh skill
publish
[<directory>]
[flags]
Overview
Validate a local repository's skills against the Agent Skills specification and publish them by creating a GitHub release.
Skills are discovered using the same conventions as install:
•
|
|
|---|---|
•
|
|
•
|
|
•
|
|
Validation checks include:
•
|
Skill names match the strict agentskills.io naming rules |
|---|---|
•
|
Each skill name matches its directory name |
•
|
Required frontmatter fields (name, description) are present |
•
|
allowed-tools is a string, not an array |
•
|
Install metadata ( |
After validation passes, publish will interactively guide you through:
•
|
Adding the |
|---|---|
•
|
Choosing a version tag (semver recommended) |
•
|
Creating a GitHub release with auto-generated notes |
Use --dry-run to validate without publishing. Use --tag to publish non-interactively with a specific tag. Use --fix to automatically strip install metadata from committed files without publishing. Review and commit the changes, then run publish again.
Options
-
--dry-run -
Validate without publishing
-
--fix -
Auto-fix issues where possible without publishing (e.g. strip install metadata)
-
--tag <string> -
Version tag for the release (e.g. v1.0.0)
Exit status
0: Successful execution
1: Error
2: Command canceled
4: Authentication required
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.
Examples
# Validate and publish interactively $ gh skill publish # Publish with a specific tag (non-interactive) $ gh skill publish --tag v1.0.0 # Validate only (no publish) $ gh skill publish --dry-run # Strip install metadata without publishing $ gh skill publish --fix