Skill Publisher

一键发布 agent skill 到 GitHub，自动验证 SKILL.md、生成或检查更吸引人的 README、区分 skill name 与 GitHub repo name、创建或更新仓库、推送并通过 npx skills 真实安装验证。当用户说"发布这个skill"、"publish skill"、"把skill发到GitHub"、"分享这个skill"、"/publish-skill"时触发。支持发布当前目录或指定路径的 skill。

41 stars 4 forksGit & Code Review

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add joeseesun/qiaomu-skill-publisher --skill skill-publisher

Manual install

git clone --depth 1 https://github.com/joeseesun/qiaomu-skill-publisher.git /tmp/qiaomu-skill-publisher
mkdir -p ~/.claude/skills
cp -r /tmp/qiaomu-skill-publisher/. ~/.claude/skills/skill-publisher

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Skill Publisher

一键将 agent skill 发布到 GitHub，自动完成验证、README 质量检查、补全、推送和真实安装验证。

## 前置条件

- `gh` CLI 已安装且已登录（`gh auth status`）
- Skill 目录包含有效的 `SKILL.md`（含 YAML frontmatter `name` + `description`）
- 优先使用 `/Users/joe/.agents/skills/<name>` 作为正式源目录；`.codex` / `.claude` 可作为兼容入口。

## 发布流程

当用户要求发布 skill 时，运行发布脚本：

```bash
python3 ~/.agents/skills/qiaomu-skill-publisher/scripts/publish_skill.py <skill_dir>
```

### 确定 skill 目录

- 如果用户说"发布这个 skill"且当前在某个 skill 目录 → 用当前目录
- 如果用户指定了 skill 名称 → 优先在 `~/.agents/skills/` 下查找
- 如果不确定 → 问用户要发布哪个 skill

### 脚本自动完成的步骤

1. **验证** SKILL.md 的 YAML frontmatter（name + description）
2. **检查** gh CLI 就绪状态
3. **创建** LICENSE（MIT，如果缺少）
4. **生成或检查** README.md：生成时不再写 TODO 模板；已存在时拦截明显占位符
5. **识别仓库名**：优先使用当前 `origin` 仓库名，避免把 `skill-publisher` 误发到错误 repo
6. **初始化** git（如果需要）
7. **创建或更新** GitHub 公开仓库并推送
8. **验证** `npx skills add --list` 可发现，并在临时目录真实安装

### 参数选项

| 参数 | 说明 |
|------|------|
| `--private` | 创建私有仓库（默认公开） |
| `--dry-run` | 仅检查，不实际发布 |
| `--skip-verify` | 跳过 npx skills 验证 |
| `--github-user USER` | 指定 GitHub 用户名（默认自动获取） |
| `--repo-name NAME` | 指定 GitHub 仓库名；默认优先使用当前 `origin` 仓库名，否则使用 skill name |
| `--no-symlink` | 跳过同步 `~/.agents/skills/` 实体目录 |

### 自动同步 ~/.agents/skills/ 实体目录

发布成功后，脚本可自动把 skill 同步到 `~/.agents/skills/<name>` 作为实体目录。

这个目录是通用 Agent Skills 标准目录，以下工具会自动读取：
OpenCode、Codex CLI、Cursor、Gemini CLI、GitHub Copilot、Amp、Cline、Warp 等。

一次发布，多工具共享，无需重复配置。

Read the full skill on GitHub

Details

Skill name: skill-publisher
Repository: joeseesun/qiaomu-skill-publisher
License: MIT
Repo updated: 11 June 2026

FAQ

What does the Skill Publisher skill do?

How do I install the Skill Publisher skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add joeseesun/qiaomu-skill-publisher --skill skill-publisher. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Skill Publisher popular?

It lives in joeseesun/qiaomu-skill-publisher, which has 41 GitHub stars and 4 forks.

Related skills

Parallel Agent Worktree Skill

TheAhmadOsman/parallel-agent-worktree-skill

Plan and execute complex work with parallel CLI agent-harness workers in git worktrees. Use for task decomposition, tmux worker spawning, deterministic loops, integration, verification, changelogs, and cleanup.

Git & Code Review

Skill Forge

motiful/skill-forge

Validate, fix, and publish skills as GitHub repos. Structures workflow skills for execution fidelity. Registers skills across platforms via symlinks and guides first-use onboarding. Use when the user says "create a skill", "forge a skill", "review this skill repo", "audit this skill", "audit all my skills", "audit this project", "clean up my skills", "check my skill", "publish this skill", "push this to GitHub", "structure my workflow skill", "extract a skill from this folder", "turn my prototype into a skill", or points to a project directory with mixed skills and rules, or to an engineering

Git & Code Review

Gitmoot

gitmoot/gitmoot

Use Gitmoot for local-first AI agent coordination across repositories, reviews, GitHub PR comments, daemon jobs, stuck jobs, branch locks, agent templates, custom prompt agents, orchestration, heartbeats, pipelines, routing telemetry, event webhooks, the web dashboard, runtime metadata, and Codex, Claude Code, Kimi Code, or omp runtime workflows.

Git & Code Review23

Agoragentic

Agoragentic/agoragentic-integrations

Route an Agoragentic task to the smallest applicable skill. Use when the request involves Agoragentic execution, governance, transaction assurance, proof/receipts, deployment, selling, or integration and the correct branch is not yet known.

Git & Code Review10

Code Review

felipereisdev/code-review-skill

Performs a structured, comprehensive code review of git changes (uncommitted, staged, current branch vs base, a single commit, a commit range, or a GitHub pull request or GitLab merge request by number or URL). Detects the stack and architecture automatically, applies stack- and pattern-specific rules, and reports findings by severity. Use when the user runs /code-review or /review-pr, or asks to "review my changes", "review PR", "review this branch", "do a code review", "revisar minhas mudanças", "revisar o PR" or "fazer code review".

Git & Code Review

Better Github Skill

AVGVSTVS96/better-github-skill

GitHub work via gh CLI: PRs, review conversations, CI failures, repo state. Use when inspecting a PR, reading a review (bodies, comments, inline threads), debugging CI (finding which run failed, why a check or Actions run is red, reading job logs), or composing non-trivial gh commands. Scripts cover what raw gh can't do (thread resolution state) or reliably fumbles (PR snapshots, CI log drilldown); use raw gh directly for everything else.

Git & Code Review

Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.