Publish Skill

Package a Claude Code skill into a new GitHub repository with a polished README and proper directory structure — ready for others to install with npx skills add.

Workflow

Step 1: Gather skill information

Collect everything needed to create the repo. The user may provide this upfront or you may need to ask.

Required information:

• Skill name — kebab-case repo name (e.g., walkthrough, code-reviewer)
• Skill source — either a path to an existing skill directory or the skill content to package
• One-line description — what the skill does in one sentence
• Detailed description — 3-5 bullet points of what the skill produces or does
• Usage examples — 2-4 example prompts that trigger the skill
• GitHub visibility — public (default) or private

If the user points to an existing skill directory (e.g., .claude/skills/my-skill/), read the skill.md to extract the description, usage triggers, and other metadata automatically. Only ask for what's missing.