# Sharing Skills

> 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

- Skill: `majiayu000/sharing-skills` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/sharing-skills`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/sharing-skills/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/sharing-skills

---


# Sharing Skills

## Core Principles

1. **Test before share** - Only share skills validated via writing-skills TDD process
2. **One skill per PR** - Each skill independently reviewable
3. **Broadly useful** - Not project-specific or experimental

## Quick Reference

```bash
# 1. Sync
git checkout main && git pull upstream main

# 2. Branch
git checkout -b "add-${skill_name}-skill"

# 3. Work
# Edit skills/your-skill-name/SKILL.md

# 4. Commit
git add skills/your-skill-name/
git commit -m "Add ${skill_name} skill"

# 5. Push + PR
git push -u origin "add-${skill_name}-skill"
gh pr create --repo <UPSTREAM_ORG>/<UPSTREAM_REPO> \
  --title "Add ${skill_name} skill" \
  --body "## Summary\n...\n## Testing\n..."
```

## When to Share vs Keep Personal

| Share | Keep Personal |
|-------|---------------|
| Applies broadly | Project-specific |
| Well-tested | Experimental/unstable |
| Others benefit | Contains sensitive info |
| Documented | Too narrow/niche |

## Prerequisites

- `gh` CLI installed and authenticated
- Working directory is your local skills clone
- Skill tested using writing-skills TDD process

## Anti-Patterns

- ❌ **Batching** - Multiple skills in one PR
- ❌ **Untested** - Sharing without baseline testing
- ❌ **Project-specific** - Personal conventions as universal skills
- ❌ **Incomplete docs** - Missing Overview, Quick Reference, Common Mistakes

## References

- [Workflow Example](references/workflow-example.md) - Complete async-patterns example

## Related

- [writing-skills](../writing-skills/SKILL.md) - REQUIRED: Create well-tested skills before sharing
- [maestro-core](../maestro-core/SKILL.md) - Workflow routing and skill hierarchy