# Skill Publisher

> 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: `dvcrn/skill-publisher-3` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add dvcrn/skill-publisher-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/skill-publisher-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/dvcrn/skill-publisher-3

---


# 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.