skills.rest
mostafa-drz
mostafa-drzCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

publish-skills

Syncs selected Claude skills to a GitHub repository with previews and commit/push decisions.

2|Updated Feb 17, 2026
Search Tags:#workflow#versioning#github#skills#catalog#publish
One-click install
npx skills add https://github.com/mostafa-drz/claude-skills --skill publish-skills-mostafa-drz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: publish-skills
Source: https://github.com/mostafa-drz/claude-skills/tree/main/code/publish-skills
Command: npx skills add https://github.com/mostafa-drz/claude-skills --skill publish-skills-mostafa-drz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Publishes Claude skills to a GitHub repository for sharing and versioning, enabling easy distribution and collaboration.

Core Features & Use Cases

  • Syncs local skills to a central repo, builds a catalog README, and records changes for traceability.
  • Supports diffing, previews, and interactive confirmation before publishing.
  • Works with per-skill SKILL.md, reference/, and examples/ directories to keep everything in sync.

Quick Start

Copy your local Claude skills to the publish repository and run the publish command to publish updates.

Frequently Asked Questions about publish-skills

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

FAQPage Schema
How do I publish Claude skills to a GitHub repository for versioning?▼

To publish Claude skills to a GitHub repository, the skill discovers local skills, compares them against published versions, and syncs selected updates into a structured catalog with interactive previews and commit decisions.

Can I preview changes before syncing local skills to a shared catalog?▼

Yes, you can preview changes before syncing local skills. The workflow enforces interactive confirmation by providing diffs and previews of your SKILL.md, reference, and examples directories prior to any commit or push.

Does publishing skills to GitHub support tracking changes for traceability?▼

Publishing skills to GitHub supports traceability by comparing local skills with published versions and recording changes. It syncs selected updates into a structured catalog README to maintain a clear history of modifications.

How do I keep local Claude skill directories in sync with a remote repository?▼

You keep local Claude skill directories in sync by running the publish workflow. It identifies differences in your SKILL.md, reference, and examples folders, then guides you through syncing those selected updates to the remote repository.

What is the best way to share and distribute Claude skills across projects?▼

The best way to share and distribute Claude skills is publishing them to a central GitHub repository. This creates a structured catalog for easy distribution, collaboration, and version tracking across different projects.

Do I need to manually build a catalog README when sharing skills on GitHub?▼

No, you do not need to manually build a catalog README. The publishing workflow automatically builds the catalog README and records changes as it syncs your local skills into the structured GitHub repository.

Related Skills

Explore More Software Engineering Skills→
victorjoshi9victorjoshi9
1

example-skill

Define a reference template for Claude Code plugin skills with SKILL.md structure.

Community
Basic
lucidlabs-hqlucidlabs-hq
2

checkout-project

Clone downstream GitHub projects into a centralized projects folder.

Official
Intermediate
helderbertohelderberto
114

ship

Stage all Git changes, generate a commit message, and push to the current branch.

Community
Basic
alexanderopalexanderop
10

push

Commit staged changes and push to a remote Git repository.

Community
Intermediate