skills.rest
joeseesun
joeseesunCOMMUNITY
Explore all skills by this author →
𝕏@vista8GitHub

skill-publisher

Publish Claude Code Skills to GitHub with validation and installability checks.

34|4|Updated Mar 6, 2026
Search Tags:#automation#github#readme#publish#skill#yaml-frontmatter
One-click install
npx skills add https://github.com/joeseesun/skill-publisher --skill skill-publisher-joeseesun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-publisher
Source: https://github.com/joeseesun/skill-publisher/tree/main
Command: npx skills add https://github.com/joeseesun/skill-publisher --skill skill-publisher-joeseesun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

一键发布 Claude Code Skill 到 GitHub，自动验证、补全文件、创建仓库、推送并验证可安装。当用户说"发布这个skill"、"publish skill"、"把skill发到GitHub"、"分享这个skill"、"/publish-skill"时触发。支持发布当前目录或指定路径的 skill。

Core Features & Use Cases

  • 验证 SKILL.md frontmatter（name、description），确保 YAML 正确。
  • 生成缺失的 LICENSE（MIT）和 README.md。
  • 初始化本地 git 仓库，创建并推送到 GitHub 公开或私有仓库。
  • 验证可通过 npx skills 安装（installability 验证）。
  • 公开目录结构、并可选择创建 ~/.agents/skills/ symlink，供多工具共享。

Quick Start

Publish a skill by running the publish_skill.py script with the path to the skill directory.

Frequently Asked Questions about skill-publisher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a Claude Code Skill to GitHub?▼

To publish a Claude Code Skill to GitHub, an automation script handles end-to-end publishing by validating SKILL.md YAML frontmatter, generating missing LICENSE and README.md files, creating the GitHub repository, and pushing the code.

What files are required in a skill directory before publishing to GitHub?▼

Before publishing to GitHub, the skill directory requires a SKILL.md file with valid YAML frontmatter including name and description. The publishing process automatically generates missing MIT LICENSE and README.md files.

Can I automatically generate a README and LICENSE when publishing a skill?▼

Yes, you can automatically generate a README and LICENSE when publishing a skill. The automation process creates an MIT LICENSE and README.md if they are missing in the specified or current directory.

How do I verify a published skill is installable via npx?▼

To verify a published skill is installable via npx, the publishing automation includes an installability verification step that checks the GitHub repository after the push operation completes.

Does the skill publishing workflow support creating symlinks for multiple tools?▼

Yes, the skill publishing workflow supports creating symlinks for multiple tools. It optionally creates a symlink in the ~/.agents/skills/ directory to allow shared access across different tools.

Related Skills

Explore More Software Engineering Skills→
nicholasgriffintnnicholasgriffintn
2

add-skill

Create and validate SKILL.md files with YAML frontmatter for OpenCode or Claude.

Community
Basic
kkn1125kkn1125

audit-skill

Audit and install missing skills globally across Codex, Gemini CLI, and Cursor agents.

Community
Advanced
osolmazosolmaz
12

add-license

Create or update root LICENSE files from an MIT template and append README license links.

Community
Intermediate
paultyngpaultyng
9

push-and-watch

Push local commits, create draft pull requests, and monitor GitHub Actions CI runs.

Community
Intermediate