mirror of
https://github.com/walter-base/common-workflow.git
synced 2026-09-08 19:26:46 -04:00
feat: publish generic agent marketplace workflows
This commit is contained in:
Walter Cheng
@@ -0,0 +1,46 @@
|
||||
name: Agent marketplace CI
|
||||
|
||||
on:
|
||||
workflow_call:
|
||||
inputs:
|
||||
skill_root:
|
||||
description: Canonical skill directory relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
default: skills
|
||||
claude_marketplace_file:
|
||||
description: Claude marketplace manifest relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
default: .claude-plugin/marketplace.json
|
||||
claude_plugin_file:
|
||||
description: Claude plugin manifest relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
default: .claude-plugin/plugin.json
|
||||
codex_plugin_root:
|
||||
description: Codex plugin root relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
cursor_plugin_root:
|
||||
description: Cursor plugin root relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
jobs:
|
||||
validate:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Check out repository
|
||||
uses: actions/checkout@v4
|
||||
- name: Validate agent marketplace
|
||||
uses: walter-base/common-workflow/actions/validate-agent-marketplace@master
|
||||
with:
|
||||
skill_root: ${{ inputs.skill_root }}
|
||||
claude_marketplace_file: ${{ inputs.claude_marketplace_file }}
|
||||
claude_plugin_file: ${{ inputs.claude_plugin_file }}
|
||||
codex_plugin_root: ${{ inputs.codex_plugin_root }}
|
||||
cursor_plugin_root: ${{ inputs.cursor_plugin_root }}
|
||||
@@ -0,0 +1,91 @@
|
||||
name: Agent marketplace preview
|
||||
|
||||
on:
|
||||
workflow_call:
|
||||
inputs:
|
||||
skill_root:
|
||||
description: Canonical skill directory relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
default: skills
|
||||
claude_marketplace_file:
|
||||
description: Claude marketplace manifest relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
default: .claude-plugin/marketplace.json
|
||||
claude_plugin_file:
|
||||
description: Claude plugin manifest relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
default: .claude-plugin/plugin.json
|
||||
codex_plugin_root:
|
||||
description: Codex plugin root relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
cursor_plugin_root:
|
||||
description: Cursor plugin root relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
package_paths:
|
||||
description: Space-separated paths to package into the preview archive.
|
||||
required: false
|
||||
type: string
|
||||
default: skills .claude-plugin .cursor-plugin .agents plugins README.md CHANGELOG.md
|
||||
archive_name:
|
||||
description: Prefix used for the preview archive.
|
||||
required: false
|
||||
type: string
|
||||
default: agent-marketplace
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
jobs:
|
||||
preview:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Check out pull request
|
||||
uses: actions/checkout@v4
|
||||
- name: Validate agent marketplace
|
||||
uses: walter-base/common-workflow/actions/validate-agent-marketplace@master
|
||||
with:
|
||||
skill_root: ${{ inputs.skill_root }}
|
||||
claude_marketplace_file: ${{ inputs.claude_marketplace_file }}
|
||||
claude_plugin_file: ${{ inputs.claude_plugin_file }}
|
||||
codex_plugin_root: ${{ inputs.codex_plugin_root }}
|
||||
cursor_plugin_root: ${{ inputs.cursor_plugin_root }}
|
||||
- name: Build preview archive
|
||||
env:
|
||||
PR_NUMBER: ${{ github.event.pull_request.number }}
|
||||
SHA: ${{ github.event.pull_request.head.sha }}
|
||||
PACKAGE_PATHS: ${{ inputs.package_paths }}
|
||||
ARCHIVE_NAME: ${{ inputs.archive_name }}
|
||||
shell: bash
|
||||
run: |
|
||||
short_sha="${SHA:0:7}"
|
||||
dir="${ARCHIVE_NAME}-pr-${PR_NUMBER}-${short_sha}"
|
||||
mkdir -p "dist/${dir}"
|
||||
for path in ${PACKAGE_PATHS}; do
|
||||
cp -R "$path" "dist/${dir}/"
|
||||
done
|
||||
tar -czf "dist/${dir}.tar.gz" -C dist "${dir}"
|
||||
echo "PREVIEW_ARCHIVE=dist/${dir}.tar.gz" >> "$GITHUB_ENV"
|
||||
- name: Upload preview artifact
|
||||
uses: actions/upload-artifact@v4
|
||||
with:
|
||||
name: ${{ inputs.archive_name }}-pr-${{ github.event.pull_request.number }}-${{ github.event.pull_request.head.sha }}
|
||||
path: ${{ env.PREVIEW_ARCHIVE }}
|
||||
retention-days: 14
|
||||
- name: Write preview summary
|
||||
env:
|
||||
PR_NUMBER: ${{ github.event.pull_request.number }}
|
||||
SHA: ${{ github.event.pull_request.head.sha }}
|
||||
ARCHIVE_NAME: ${{ inputs.archive_name }}
|
||||
run: |
|
||||
cat >> "$GITHUB_STEP_SUMMARY" <<EOF
|
||||
# ${ARCHIVE_NAME} preview for PR #${PR_NUMBER}
|
||||
|
||||
Preview artifact: `${ARCHIVE_NAME}-pr-${PR_NUMBER}-${SHA}`
|
||||
|
||||
This artifact expires automatically after 14 days. Stable releases are created only after a release PR is merged into the default branch.
|
||||
EOF
|
||||
@@ -0,0 +1,179 @@
|
||||
name: Agent marketplace release
|
||||
|
||||
on:
|
||||
workflow_call:
|
||||
inputs:
|
||||
skill_root:
|
||||
description: Canonical skill directory relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
default: skills
|
||||
claude_marketplace_file:
|
||||
description: Claude marketplace manifest relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
default: .claude-plugin/marketplace.json
|
||||
claude_plugin_file:
|
||||
description: Claude plugin manifest relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
default: .claude-plugin/plugin.json
|
||||
codex_plugin_root:
|
||||
description: Codex plugin root relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
cursor_plugin_root:
|
||||
description: Cursor plugin root relative to the repository root.
|
||||
required: false
|
||||
type: string
|
||||
release_config_file:
|
||||
description: Release Please configuration file.
|
||||
required: false
|
||||
type: string
|
||||
default: release-please-config.json
|
||||
release_manifest_file:
|
||||
description: Release Please manifest file.
|
||||
required: false
|
||||
type: string
|
||||
default: .release-please-manifest.json
|
||||
package_paths:
|
||||
description: Space-separated paths to package into the release archive.
|
||||
required: false
|
||||
type: string
|
||||
default: skills .claude-plugin .cursor-plugin .agents plugins README.md CHANGELOG.md
|
||||
archive_name:
|
||||
description: Prefix used for the release archive.
|
||||
required: false
|
||||
type: string
|
||||
default: agent-marketplace
|
||||
claude_plugin_name:
|
||||
description: Claude plugin name used in the installation summary.
|
||||
required: false
|
||||
type: string
|
||||
default: marketplace
|
||||
claude_marketplace_name:
|
||||
description: Claude marketplace name used in the installation summary.
|
||||
required: false
|
||||
type: string
|
||||
default: marketplace
|
||||
codex_marketplace_name:
|
||||
description: Codex marketplace name shown in the installation summary.
|
||||
required: false
|
||||
type: string
|
||||
default: marketplace
|
||||
cursor_plugin_name:
|
||||
description: Cursor plugin name shown in the installation summary.
|
||||
required: false
|
||||
type: string
|
||||
default: marketplace
|
||||
secrets:
|
||||
GITHUB_TOKEN:
|
||||
required: false
|
||||
|
||||
permissions:
|
||||
contents: write
|
||||
pull-requests: write
|
||||
|
||||
concurrency:
|
||||
group: release-please
|
||||
cancel-in-progress: false
|
||||
|
||||
jobs:
|
||||
release-please:
|
||||
runs-on: ubuntu-latest
|
||||
outputs:
|
||||
release_created: ${{ steps.release.outputs.release_created }}
|
||||
tag_name: ${{ steps.release.outputs.tag_name }}
|
||||
version: ${{ steps.release.outputs.version }}
|
||||
steps:
|
||||
- name: Create or update release PR
|
||||
id: release
|
||||
uses: googleapis/release-please-action@v4
|
||||
with:
|
||||
token: ${{ secrets.GITHUB_TOKEN || github.token }}
|
||||
target-branch: ${{ github.event.repository.default_branch || 'master' }}
|
||||
config-file: ${{ inputs.release_config_file }}
|
||||
manifest-file: ${{ inputs.release_manifest_file }}
|
||||
|
||||
publish:
|
||||
needs: release-please
|
||||
if: needs.release-please.outputs.release_created == 'true'
|
||||
runs-on: ubuntu-latest
|
||||
permissions:
|
||||
contents: write
|
||||
steps:
|
||||
- name: Check out released version
|
||||
uses: actions/checkout@v4
|
||||
with:
|
||||
ref: ${{ needs.release-please.outputs.tag_name }}
|
||||
- name: Validate released marketplace
|
||||
uses: walter-base/common-workflow/actions/validate-agent-marketplace@master
|
||||
with:
|
||||
skill_root: ${{ inputs.skill_root }}
|
||||
claude_marketplace_file: ${{ inputs.claude_marketplace_file }}
|
||||
claude_plugin_file: ${{ inputs.claude_plugin_file }}
|
||||
codex_plugin_root: ${{ inputs.codex_plugin_root }}
|
||||
cursor_plugin_root: ${{ inputs.cursor_plugin_root }}
|
||||
- name: Build release archive
|
||||
env:
|
||||
VERSION: ${{ needs.release-please.outputs.version }}
|
||||
PACKAGE_PATHS: ${{ inputs.package_paths }}
|
||||
ARCHIVE_NAME: ${{ inputs.archive_name }}
|
||||
shell: bash
|
||||
run: |
|
||||
dir="${ARCHIVE_NAME}-${VERSION}"
|
||||
mkdir -p "dist/${dir}"
|
||||
for path in ${PACKAGE_PATHS}; do
|
||||
cp -R "$path" "dist/${dir}/"
|
||||
done
|
||||
tar -czf "dist/${dir}.tar.gz" -C dist "${dir}"
|
||||
- name: Write installation summary
|
||||
env:
|
||||
VERSION: ${{ needs.release-please.outputs.version }}
|
||||
TAG: ${{ needs.release-please.outputs.tag_name }}
|
||||
REPOSITORY: ${{ github.repository }}
|
||||
SERVER_URL: ${{ github.server_url }}
|
||||
CLAUDE_PLUGIN_NAME: ${{ inputs.claude_plugin_name }}
|
||||
CLAUDE_MARKETPLACE_NAME: ${{ inputs.claude_marketplace_name }}
|
||||
CODEX_MARKETPLACE_NAME: ${{ inputs.codex_marketplace_name }}
|
||||
CURSOR_PLUGIN_NAME: ${{ inputs.cursor_plugin_name }}
|
||||
run: |
|
||||
cat >> "$GITHUB_STEP_SUMMARY" <<EOF
|
||||
# Agent marketplace ${VERSION}
|
||||
|
||||
Released from tag `${TAG}`.
|
||||
|
||||
## Claude Code
|
||||
|
||||
```bash
|
||||
claude plugin marketplace add ${REPOSITORY}@${TAG}
|
||||
claude plugin install ${CLAUDE_PLUGIN_NAME}@${CLAUDE_MARKETPLACE_NAME}
|
||||
```
|
||||
|
||||
## Codex
|
||||
|
||||
```bash
|
||||
codex plugin marketplace add ${REPOSITORY} --ref ${TAG}
|
||||
codex
|
||||
# In Codex, run: /plugins and install ${CODEX_MARKETPLACE_NAME}.
|
||||
```
|
||||
|
||||
## OpenCode
|
||||
|
||||
```bash
|
||||
npx skills add ${SERVER_URL}/${REPOSITORY}/tree/${TAG}/${SKILL_ROOT:-skills} --agent opencode --skill '*'
|
||||
```
|
||||
|
||||
## Cursor
|
||||
|
||||
```bash
|
||||
npx skills add ${SERVER_URL}/${REPOSITORY}/tree/${TAG}/${SKILL_ROOT:-skills} --agent cursor --skill '*'
|
||||
```
|
||||
|
||||
Cursor's native `/add-plugin ${CURSOR_PLUGIN_NAME}` flow can be used after the plugin is published to the Cursor Marketplace.
|
||||
EOF
|
||||
- name: Upload archive to GitHub Release
|
||||
uses: softprops/action-gh-release@v2
|
||||
with:
|
||||
tag_name: ${{ needs.release-please.outputs.tag_name }}
|
||||
files: dist/${{ inputs.archive_name }}-*.tar.gz
|
||||
Reference in New Issue
Block a user