sharing-skillslisted

# Sharing Skills ## Overview Contribute skills from your local branch back to the upstream repository. **Workflow:** Branch → Edit/Create skill → Commit → Push → PR ## When to Share **Share when:** - Skill applies broadly (not project-specific) - Pattern/technique others would benefit from - Well-tested and documented - Follows skills/meta/writing-skills guidelines **Keep personal when:** - Project-specific or organization-specific - Experimental or unstable - Contains sensitive information - Too narrow/niche for general use ## Prerequisites - `gh` CLI installed and authenticated - Working directory is `~/.config/superpowers/skills/` (your local clone) - Skill has been tested (see skills/meta/writing-skills for TDD process) ## Sharing Workflow ### 1. Ensure You're on Main and Synced ```bash cd ~/.config/superpowers/skills/ git checkout main git pull upstream main git push origin main # Push to your fork ``` ### 2. Create Feature Branch ```bash # Branch name: add-skillname-skill skill_name="your-skill-name" git checkout -b "add-${skill_name}-skill" ``` ### 3. Create or Edit Skill ```bash # Work on your skill in skills/ # Create new skill or edit existing one # Skill should be in skills/category/skill-name/SKILL.md ``` ### 4. Commit Changes ```bash # Add and commit git add skills/your-skill-name/ git commit -m "Add ${skill_name} skill $(cat <<'EOF' Brief description of what this skill does and why it's useful. Tested with: [describe testing approach] EOF )"