Creates and publishes Claude Code skills to skills.sh following Anthropic's official skill-building guide. Validates SKILL.md structure, creates a GitHub repository, and pushes the skill files. Handles both first-time publishing and updates to existing skills.
npx skills add amunozdev/create-and-publish-skillA Claude Code skill that can be installed via skills.sh.
This skill automates the full lifecycle of Claude Code skills:
- Create — Generates properly structured skills following Anthropic's official guidelines (frontmatter, progressive disclosure, trigger phrases, references)
- Validate — Checks SKILL.md against the official specification (name format, description requirements, file references, size limits)
- Publish — Creates a GitHub repo, copies files to the correct dual structure (root + nested
.agents/), and pushes - Update — Detects changes, shows diffs, and pushes updates to existing published skills
All skills created and validated by this tool follow the principles from The Complete Guide to Building Skills for Claude:
- Progressive Disclosure — Three-level system (frontmatter → SKILL.md body → references/) to minimize token usage
- Description-Driven Activation — Skills trigger automatically based on well-crafted description fields with specific trigger phrases
- Composability — Skills designed to work alongside others
- Proper Structure — kebab-case naming, no README inside skill folders, references for detailed docs
The full guide is included as a reference file within the skill at references/official-skill-building-guide.md.
"Publish my token-optimizer skill"
"Create a new skill called code-reviewer"
"Update my published skill"
MIT