sharing-skills

Creates a pull request for a new skill from a local branch to upstream ZenPowers.

6|1|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/alexsandrocruz/ZenPowers --skill sharing-skills-alexsandrocruz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sharing-skills
Source: https://github.com/alexsandrocruz/ZenPowers/tree/main/skills/sharing-skills
Command: npx skills add https://github.com/alexsandrocruz/ZenPowers --skill sharing-skills-alexsandrocruz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh.

What problem does it solve?

This Skill provides a clear, step-by-step workflow for contributing your locally developed skills back to the upstream ZenPowers repository via a pull request, ensuring proper branching, committing, and PR creation.

Core Features & Use Cases

  • Contribution Workflow: Guides through syncing with upstream, creating a feature branch, committing changes, pushing to your fork, and creating a pull request.
  • Prerequisites & Troubleshooting: Covers gh CLI setup, SSH issues, and merge conflicts, ensuring a smooth contribution experience.
  • Multi-Skill Contribution Guidance: Enforces one skill per PR to maintain reviewability and simplify the integration process.
  • Use Case: When you've developed a broadly useful skill and want to share it with the ZenPowers community, use this Skill to ensure a smooth and compliant contribution process.

Quick Start

1. Sync with upstream

cd /path/to/your/ZenPowers/ git checkout main git pull origin main

2. Create feature branch

skill_name="my-new-skill" git checkout -b "add-${skill_name}-skill"

3. Create or edit the skill (e.g., skills/my-new-skill/SKILL.md)

... (work on your skill) ...

4. Commit changes

git add skills/my-new-skill/ git commit -m "Add ${skill_name} skill"

5. Push to your fork

git push -u origin "add-${skill_name}-skill"

6. Create Pull Request

gh pr create --repo upstream-org/upstream-repo --title "Add ${skill_name} skill"

Frequently Asked Questions about sharing-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I contribute a skill to the ZenPowers repository via pull request?

Contributing a skill involves syncing with upstream, creating a feature branch, adding or editing your SKILL.md file, committing changes, pushing to your fork, and opening a pull request using the gh CLI. Follow the one-skill-per-PR convention to keep reviews focused and integration straightforward.

What do I need to set up before contributing skills to an open source project?

You need the gh CLI installed, a synchronized local clone of the ZenPowers repository, and familiarity with git branching and pull requests. Test your skill using zenpowers:writing-skills TDD to ensure compatibility and maintainability before submitting.

Can I submit multiple skills in a single pull request?

No. This workflow enforces one skill per pull request to maintain reviewability and simplify the integration process, making it easier for maintainers to evaluate and merge contributions.

What should I do if I encounter merge conflicts when syncing with upstream?

Merge conflicts are covered in the troubleshooting section. Resolve conflicts locally in your feature branch, commit the resolution, and push to your fork before creating the pull request.

How do I test my skill before submitting it to the community?

Use zenpowers:writing-skills TDD to test your skill locally. This ensures your contribution is well-tested and maintains compatibility with the ZenPowers repository before you open a pull request.

What are the prerequisites for my skill to be accepted as a contribution?

Your skill must be broadly applicable, well-tested, and thoroughly documented in SKILL.md. It should follow the contribution workflow, pass TDD validation, and be submitted as a single skill per pull request.