Can I contribute multiple skills in a single pull request?

No, the workflow enforces a one-skill-per-PR policy to ensure each contribution can be reviewed, iterated, and merged independently.

Do I need the GitHub CLI installed to use this skill?

Yes, this skill requires the GitHub CLI (gh) to be installed and authenticated to handle automated pull request creation.

Does this skill help with testing my new contribution?

While it requires you to document your testing approach in the PR, it assumes you have already followed the 'writing-skills' TDD process before initiating the share workflow.

What is the required directory structure for sharing skills?

The skill expects your local clone to be located at ~/.config/superpowers/skills/ and organized by category/skill-name/SKILL.md.

How do I clean up my branches after a contribution is merged?

The skill includes a dedicated post-merge workflow to sync your local main branch with upstream and delete the obsolete feature branches.

Skill Sharing Workflow

Name: Skill Sharing Workflow
Author: dsifry

bydsifry

•

Developer Tools

Streamlines the process of contributing custom Claude Code skills to upstream repositories using standardized Git and GitHub CLI workflows.

About

The sharing-skills skill provides a structured framework for developers to contribute their locally developed capabilities back to the primary community repository. It automates the complex lifecycle of an open-source contribution, including upstream synchronization, feature branch management, and the creation of detailed pull requests. By enforcing best practices like the 'one skill per PR' rule and requiring testing documentation, it ensures that community-contributed skills remain high-quality and easy for maintainers to review and merge.

Key Features

Standardized feature branch creation and naming conventions
Integrated GitHub CLI (gh) commands for automated PR generation
29 GitHub stars
Automated upstream synchronization and fork management
Template-based commit messages with testing context requirements
Post-merge cleanup workflows for local and remote branches

Use Cases

Automating the repetitive Git commands required for open-source contributions
Submitting improvements or bug fixes to existing global skills
Contributing a newly developed AI coding pattern to the community repository

About

Key Features

Standardized feature branch creation and naming conventions
Integrated GitHub CLI (gh) commands for automated PR generation
29 GitHub stars
Automated upstream synchronization and fork management
Template-based commit messages with testing context requirements
Post-merge cleanup workflows for local and remote branches

Use Cases

Automating the repetitive Git commands required for open-source contributions
Submitting improvements or bug fixes to existing global skills
Contributing a newly developed AI coding pattern to the community repository