sharing-skills

To contribute a skill via pull request, clone the skills repository locally, create a feature branch, add your well-tested and documented skill, commit with a descriptive message, push to your fork, and open a PR with a summary of changes. This workflow ensures proper review before merging upstream.

The Git workflow involves branching from the main repository, editing or adding your skill files, committing with clear messages about what the skill does, pushing to your remote fork, and creating a pull request with testing details and context. Following these steps increases the likelihood of approval and integration.

Before contributing, ensure your skill is well-tested, fully documented according to project guidelines, and broadly useful beyond a single project. You'll also need a local clone at ~/.config/superpowers/skills/ and GitHub CLI (gh) installed to execute the contribution workflow.

Yes, GitHub CLI (gh) is required for this contribution workflow. It handles the pull request creation step, enabling you to submit your skill contribution directly from the command line after pushing your branch.

After submitting your pull request, it enters the review process where maintainers evaluate your skill against contribution guidelines. A well-structured PR with testing documentation and clear context accelerates review and increases the chance of merge into the upstream repository.