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.