What problem does it solves?
This Skill provides a clear, step-by-step workflow for contributing well-tested and broadly useful skills back to an upstream repository. It ensures quality and consistency in community contributions, making it easy to share your expertise.
Core Features & Use Cases
- Contribution Workflow: Guides you through syncing your fork, creating a feature branch, committing changes, pushing to your fork, and creating a pull request using the
gh CLI.
- Quality Gates: Emphasizes prerequisites like testing skills with the
writing-skills TDD process before sharing, ensuring high-quality contributions.
- Troubleshooting: Offers solutions for common issues encountered during the contribution process, such as
gh not found, permission denied, or merge conflicts.
- Use Case: After developing a new, broadly applicable debugging technique and thoroughly testing it, use this skill to package it as a contribution, ensuring it meets community standards and is easily integrated into the main repository.
Quick Start
Example: Sharing a skill named "async-patterns"
Prerequisites: gh CLI installed and authenticated, skill tested using writing-skills
1. Ensure you're on main and synced
cd ~/.config/superpowers/skills/
git checkout main
git pull upstream main
git push origin main
2. Create feature branch
git checkout -b "add-async-patterns-skill"
3. Create or Edit Skill (work on skills/async-patterns/SKILL.md)
4. Commit Changes
git add skills/async-patterns/
git commit -m "Add async-patterns skill
Patterns for handling asynchronous operations..."
5. Push to Your Fork
git push -u origin "add-async-patterns-skill"
6. Create Pull Request
gh pr create
--repo upstream-org/upstream-repo
--title "Add async-patterns skill"
--body "## Summary
Patterns for handling asynchronous operations..."
