Featured

sharing-skills

Name: sharing-skills
Rating: 5 (9202 reviews)
Author: obra

Use when you've developed a broadly useful skill and want to contribute it upstream via pull request - guides process of branching, committing, pushing, and creating PR to contribute skills back to upstream repository

TL;DR

Contribute broadly useful, well-tested skills to upstream via PR after local development and testing.

What Is It

Share skills from local branch to upstream repo
Follow branching, committing, pushing, and PR workflow
Ensure skills are broadly useful and well-documented
Require TDD testing before sharing

Key Features

Branch → Commit → Push → PR workflow
Must be tested with writing-skills TDD process
Skill must apply broadly, not project-specific
Each skill in separate PR and branch
PR body includes summary, testing, and context
Must sync with upstream main before merging
Delete branch after PR merge
No batching of multiple skills in one PR

How to Use

1.Ensure on main and sync with upstream
2.Create feature branch with format add-skillname-skill
3.Edit or create skill in skills/category/skill-name/SKILL.md
4.Commit changes with brief description and testing info
5.Push to forked repo with --set-upstream
6.Create PR with title and body including summary, testing, context

Guardrails & Gotchas

MUST follow writing-skills TDD process
DO NOT batch multiple skills in one PR
Skill must be broadly useful, not project-specific
DO NOT share experimental or unstable skills
DO NOT share skills with sensitive information
Skill must be independently reviewable
Must resolve merge conflicts with rebase and force push if needed

GitHub Stats

Author

@obra

Repository

obra/superpowers

Stars

9202

Explore More Skills

move-code-quality

@davila7

Analyzes Move language packages against the official Move Book Code Quality Checklist. Use this skill when reviewing Move code, checking Move 2024 Edition compliance, or analyzing Move packages for best practices. Activates automatically when working with .move files or Move.toml manifests.

12.4k

1.1k

1w ago

sharing-skills

Explore More Skills

move-code-quality

e2e-testing-patterns

testing-anti-patterns