share-skill

To publish a local Claude skill to a shared GitHub repository, the share-skill tool automates validation, copying, and Git operations to push your local skill files directly to the community main branch.

Yes, you can create a pull request instead of pushing directly to main by invoking the share-skill command with the --pr flag, which utilizes gh to handle branch creation and PR submission.

To share a local Codex skill, your SKILL.md file must contain valid YAML frontmatter including the required name, description, and version fields, which the tool validates before proceeding.

Yes, the skill publishing tool performs an org-appropriateness check to evaluate whether your automation skill is suitable for the shared repository and halts the process if it is deemed project-specific.

If a skill name already exists in the community repository, the tool detects whether the operation is an add or an update, checks for author conflicts, and safely commits the changes to update the existing skill.

Your local skill fails validation when trying to share it because the tool checks the SKILL.md YAML frontmatter for required name, description, and version fields, halting if any are missing or invalid.