8363750c13
- Add skill-reviewer v1.0.0 for reviewing Claude Code skills against best practices - Self-review mode: validate your own skills before publishing - External review mode: evaluate others' skill repositories - Auto-PR mode: fork, improve, submit PRs with additive-only changes - Auto-install dependencies: automatically installs skill-creator if missing - Add github-contributor v1.0.0 for strategic open-source contribution - Four contribution types: Documentation, Code Quality, Bug Fixes, Features - Project selection criteria and red flags - PR excellence workflow and reputation building ladder - GitHub CLI commands and conventional commit format - Update marketplace to v1.22.0 with 30 skills - Update documentation (README, README.zh-CN, CLAUDE.md, CHANGELOG) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
130 lines
2.7 KiB
Markdown
130 lines
2.7 KiB
Markdown
# PR Template for Skill Contributions
|
|
|
|
Use this template when creating PRs for Claude Code skill repositories.
|
|
|
|
## PR Title Format
|
|
|
|
```
|
|
refactor: Align skill with Claude Code best practices
|
|
```
|
|
|
|
Or for specific improvements:
|
|
```
|
|
feat: Add marketplace support for plugin installation
|
|
docs: Add bilingual documentation (English/Chinese)
|
|
fix: Improve error handling in scripts
|
|
```
|
|
|
|
## PR Body Template
|
|
|
|
```markdown
|
|
## Summary
|
|
|
|
This PR improves the [skill-name] skill by aligning it with [Claude Code Skill Best Practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices).
|
|
|
|
### What This PR Does
|
|
|
|
- [Improvement 1]
|
|
- [Improvement 2]
|
|
- [Improvement 3]
|
|
|
|
### What This PR Does NOT Change
|
|
|
|
- [Preserved item 1]
|
|
- [Preserved item 2]
|
|
|
|
## Detailed Changes
|
|
|
|
### 1. [Change Category]
|
|
|
|
**Before:**
|
|
[Description of current state]
|
|
|
|
**After:**
|
|
[Description of improvement]
|
|
|
|
**Rationale:**
|
|
[Why this change helps users]
|
|
|
|
### 2. [Change Category]
|
|
|
|
...
|
|
|
|
## Why These Changes?
|
|
|
|
According to Claude Code best practices:
|
|
|
|
> "[Quote from documentation]"
|
|
|
|
This PR addresses:
|
|
- [Issue 1 and how it's fixed]
|
|
- [Issue 2 and how it's fixed]
|
|
|
|
## Files Changed
|
|
|
|
| File | Change Type | Description |
|
|
|------|-------------|-------------|
|
|
| SKILL.md | Modified | Improved description and workflow |
|
|
| README.md | Modified | Added installation instructions |
|
|
| README.en.md | Added | English documentation |
|
|
| .claude-plugin/marketplace.json | Added | Plugin marketplace support |
|
|
|
|
## Test Plan
|
|
|
|
- [ ] Test 1
|
|
- [ ] Test 2
|
|
- [ ] Test 3
|
|
|
|
## References
|
|
|
|
- [Claude Code Skill Best Practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)
|
|
- [Skills Overview](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)
|
|
|
|
---
|
|
|
|
🤖 Generated with [Claude Code](https://claude.com/claude-code)
|
|
```
|
|
|
|
## Key Sections Explained
|
|
|
|
### Summary
|
|
- Brief overview (2-3 sentences)
|
|
- Link to best practices
|
|
|
|
### What This PR Does NOT Change
|
|
**CRITICAL** - Always include this section to show respect for original work.
|
|
|
|
### Rationale
|
|
- Explain WHY each change helps
|
|
- Quote official documentation
|
|
- Don't be judgmental
|
|
|
|
### Test Plan
|
|
- Provide actionable verification steps
|
|
- Help maintainers review quickly
|
|
|
|
## Tone Guidelines
|
|
|
|
### Do
|
|
- Be helpful and constructive
|
|
- Explain benefits to users
|
|
- Acknowledge good aspects of original
|
|
|
|
### Don't
|
|
- Be critical or judgmental
|
|
- Imply the original is "wrong"
|
|
- Use words like "fix", "correct", "proper" negatively
|
|
|
|
### Examples
|
|
|
|
```
|
|
❌ "Fixed the incorrect description format"
|
|
✅ "Improved description for better skill discovery"
|
|
|
|
❌ "The skill had several issues..."
|
|
✅ "This PR adds improvements for..."
|
|
|
|
❌ "Corrected the non-standard structure"
|
|
✅ "Added marketplace support for easier installation"
|
|
```
|