Skip to content

PUBLISHING.md

Latest commit

 

History

History
66 lines (46 loc) · 2.9 KB

PUBLISHING.md

File metadata and controls

66 lines (46 loc) · 2.9 KB
Raw

Publishing skills

Skills live under skills/ (guides, tools, workflows, suite). There is no top-level references/ or plugins/ tree. Version is repo VERSION, injected into every skill via the @VERSION placeholder (make bundle / sync_skill_versions.py).

Version alignment: ClawHub skill versions and the GitHub release tag skills-v<VERSION> must match VERSION. Record release notes in CHANGELOG.md before tagging.

What “publish” means per channel

Channel Publish Consumers install
GitHub + skills CLI Push + tag skills-v<VERSION> npx skills add PrunaAI/pruna-skills@pruna -y
skills.sh Automatic after npx skills installs skills.sh discovery
Claude marketplace .claude-plugin/marketplace.json in repo /plugin install <name>@pruna-skills
ClawHub skills clawhub skill publish clawhub install @pruna-ai/<slug>

There is no plugins CLI path — install is skills-only. ./.maintainer/release/publish_all_skills.py automates ClawHub skill publish; GitHub tag is the source-of-truth for npx skills.

One-time setup

clawhub login
# or: export CLAWHUB_TOKEN=...
export CLAWHUB_OWNER=pruna-ai

Add secrets to GitHub Actions (CLAWHUB_TOKEN, optional CLAWHUB_OWNER) for .github/workflows/release-skills.yml (workflow_dispatch release).

PR / main CI runs .github/workflows/verify-skills.yml (make verify + validate). There is no separate publish-on-tag workflow — ClawHub upload is part of the release workflow when dry_run is false.

Makefile shortcuts: make publish (dry-run), make release (prints usage).

Local publish

# 1. Update CHANGELOG.md, then set VERSION and rebuild
./.maintainer/release/release.sh 1.0.2

# 2. Commit, tag (must match VERSION), push
git add -A && git commit -m "[release] skills v1.0.2"
git tag skills-v1.0.2
git push origin main && git push origin skills-v1.0.2

# 3. Always create the GitHub Release (notes from CHANGELOG)
./.maintainer/release/create_github_release.sh 1.0.2

# 4. Upload to ClawHub (or run release-skills.yml with dry_run=false)
./.maintainer/release/publish_all_skills.sh --execute --target clawhub,index

Consumer install

npx skills add PrunaAI/pruna-skills@pruna -y          # full suite (recommended)
npx skills add PrunaAI/pruna-skills@p-image -y        # one tool
npx skills add PrunaAI/pruna-skills@image-prompting -y # one guide
npx skills add PrunaAI/pruna-skills -l

Index: .maintainer/publish-index.json (generated by make bundle).

Maintainer checklist

  1. make bundle && make validate
  2. Update CHANGELOG
  3. Tag skills-v<VERSION> and create GitHub Release
  4. ClawHub publish if configured