---
name: skill-publisher
description: "Automates the multi-channel publishing of Agent Skills. Use when the user wants to release a new version of their skills to ClaWHub, GitHub, and other platforms."
---

# Skill Publisher

This skill automates the release process for a repository of Agent Skills, ensuring they are published to all relevant channels with a single command.

## When to Use

- When you have a GitHub repository containing one or more skills.
- When you want to release a new version of these skills.
- When you want to automate the process of publishing to ClaWHub, updating GitHub Topics, creating GitHub Releases, and submitting to awesome-lists.

## How It Works

This skill sets up a GitHub Actions-based CI/CD pipeline in the target repository. The pipeline is triggered by pushing a git tag (e.g., `v1.2.0`).

### Core Workflow

1.  **Setup (`setup.sh`)**: The main script that orchestrates the entire setup process.
2.  **CI/CD Creation**: The script copies pre-built GitHub Actions workflow files (`publish.yml`, `quality-check.yml`, `submit-awesome-lists.yml`) into the target repository's `.github/workflows` directory.
3.  **Helper Scripts**: It also adds helper scripts (`release.sh`, `setup-github-topics.sh`) to the repository's `scripts/` directory.
4.  **Secrets Configuration**: The script prompts the user for necessary API tokens (`CLAWHUB_TOKEN`, `GH_PAT`) and configures them as GitHub Actions secrets in the target repository.
5.  **Git Push**: Finally, it commits and pushes all the new files to the target repository.

### Execution Steps

When this skill is activated, it will perform the following steps:

1.  **Ask for Target Repository**: It will ask the user for the GitHub repository URL where the skills are located (e.g., `https://github.com/your-org/your-skills-repo`).
2.  **Ask for API Tokens**: It will request the necessary `CLAWHUB_TOKEN` and a `GH_PAT` with `repo` and `workflow` scopes.
3.  **Clone Repository**: It will clone the target repository into a temporary directory.
4.  **Run Setup Script**: It will execute the `setup.sh` script, which will:
    *   Copy the workflow and helper script templates from this skill's `assets/` directory into the target repository.
    *   Use the `gh` CLI to set the repository secrets.
    *   Commit and push the changes.
5.  **Confirm Success**: It will report back to the user that the automated publishing pipeline has been successfully set up and provide instructions on how to trigger the first release.

## Bundled Resources

-   **`scripts/setup.sh`**: The main orchestration script.
-   **`assets/workflows/publish.yml`**: GitHub Actions workflow for publishing on tag push.
-   **`assets/workflows/quality-check.yml`**: GitHub Actions workflow for running quality checks on PRs.
-   **`assets/workflows/submit-awesome-lists.yml`**: GitHub Actions workflow for submitting PRs to awesome-lists.
-   **`assets/scripts/release.sh`**: Helper script for users to easily create a new release.
-   **`assets/scripts/setup-github-topics.sh`**: Helper script for setting GitHub Topics.