Files
claude-skills-reference/.github/pull_request_template.md
Reza Rezvani 496c484b06 feat: add complete GitHub repository pages and MIT License for open source
Add professional open source repository setup with all essential GitHub
community health files, templates, and legal documentation.

Core Files Added (5):

1. **LICENSE**
   - Official MIT License
   - Copyright 2025 Alireza Rezvani
   - GitHub will automatically recognize and display
   - Enables commercial use, modification, distribution

2. **CONTRIBUTING.md**
   - Complete contribution guidelines
   - Skill creation standards following Anthropic spec
   - Python script quality requirements
   - Development workflow and PR process
   - Style guide (Python PEP 8, Markdown, commits)
   - Domain-specific guidelines
   - Quality checklist for contributors

3. **CODE_OF_CONDUCT.md**
   - Contributor Covenant 2.0 standard
   - Community standards and expectations
   - Enforcement guidelines
   - Incident reporting process

4. **SECURITY.md**
   - Vulnerability reporting process
   - Supported versions table
   - Response timelines by severity
   - Security best practices for users
   - Secure coding guidelines for contributors
   - Responsible disclosure policy

5. **CHANGELOG.md**
   - Keep a Changelog format
   - Complete version history from v1.0.0
   - Documents all 42 skills in initial release
   - Tracks Anthropic refactoring progress (v1.1.0)
   - GitHub pages addition (v1.0.2)
   - Semantic versioning with comparison links

GitHub Templates Added (5):

6. **.github/ISSUE_TEMPLATE/bug_report.md**
   - Standardized bug reporting
   - Environment details checklist
   - Reproduction steps required
   - Skill-specific context

7. **.github/ISSUE_TEMPLATE/feature_request.md**
   - New skill proposal template
   - Problem statement and use cases
   - ROI and value quantification
   - Python tools and references specification

8. **.github/ISSUE_TEMPLATE/skill_improvement.md**
   - Enhancement suggestions for existing skills
   - Specific change proposals
   - Value proposition requirement
   - Implementation willingness indicator

9. **.github/ISSUE_TEMPLATE/documentation.md**
   - Documentation issue reporting
   - Clear before/after examples
   - Affected audience specification
   - Link validation focus

10. **.github/pull_request_template.md**
    - Comprehensive PR checklist
    - Quality standards enforcement
    - Testing requirements
    - Documentation update verification
    - ROI value estimation

Benefits:

**For Repository:**
-  Professional open source appearance
-  GitHub recognizes LICENSE automatically
-  Community health score improves to 100%
-  Legal clarity (MIT License)
-  Security vulnerability process established

**For Contributors:**
-  Clear contribution guidelines
-  Standardized issue templates
-  Quality checklists
-  Expected behavior defined

**For Users:**
-  Transparent licensing
-  Security reporting process
-  Version history tracking
-  Professional community standards

Repository Status:
- All GitHub recommended community files present
- Open source best practices followed
- Ready for community contributions
- Professional project presentation

This completes the essential GitHub repository setup for a professional
open source project, making the Claude Skills Library contribution-ready
and community-friendly.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-28 12:04:00 +01:00

4.0 KiB

Pull Request

Description

What does this PR do?

A clear and concise description of the changes.

Type of Change

Select the type of change:

  • New skill addition
  • Skill enhancement/improvement
  • Bug fix
  • Documentation update
  • Python script improvement
  • Refactoring/optimization
  • Other (specify)

Fixes #(issue number)

Or: Related to #(issue number)


Changes Made

Skills Added/Modified

Skill Name(s):

What Changed:

  • Added: (new capabilities, scripts, references)
  • Modified: (what was changed and why)
  • Removed: (what was deprecated/removed and why)

Python Scripts

New Scripts:

  • script_name.py - Purpose and functionality

Modified Scripts:

  • existing_script.py - Changes made

Documentation

Files Updated:

  • README.md - (what sections)
  • SKILL.md - (what changed)
  • Reference files - (which ones)

Testing

Testing Performed

  • Tested with Claude AI (uploaded SKILL.md and verified activation)
  • Tested with Claude Code (loaded skill and ran workflows)
  • All Python scripts run without errors
  • Ran scripts with --help flag
  • Tested JSON output (if applicable)
  • All reference links work
  • No broken relative paths

Test Results

Claude Activation:

  • Skill activates when appropriate
  • Description triggers correctly
  • Keywords help discovery

Python Scripts:

# Commands run for testing
python scripts/tool.py --help
python scripts/tool.py test-input.txt

Results:

[Paste test output or describe results]

Quality Checklist

SKILL.md Quality

  • YAML frontmatter is valid
  • name matches directory name
  • description includes what, when, and keyword triggers
  • license: MIT included
  • metadata section complete (version, author, category, domain)
  • Keywords section added
  • SKILL.md length <200 lines (or justified if longer)
  • Clear quick start section
  • Core workflows documented
  • Examples included

Python Scripts Quality (if applicable)

  • Production-ready code (not placeholders)
  • CLI with --help support
  • Proper error handling
  • Clear docstrings
  • Type hints used
  • Standard library preferred
  • Dependencies documented
  • No hardcoded paths or credentials

Documentation Quality

  • All links work (no 404s)
  • Markdown formatting correct
  • No typos or grammar errors
  • Code blocks have language specified
  • Examples are realistic and complete
  • Screenshots included where helpful

Repository Integration

  • Domain-specific README.md updated (if new skill)
  • Main README.md updated (if new domain or major feature)
  • CLAUDE.md updated (if changes affect development)
  • CHANGELOG.md updated (in Unreleased section)

ROI & Value

Estimated Value of This Contribution:

Time Savings:

  • Hours saved per month per user: (estimate)
  • Number of potential users: (estimate)

Quality Improvements:

  • Specific quality gains: (describe)
  • Measurable improvements: (quantify if possible)

Why This Matters: Brief explanation of the business/user value.


Screenshots

If applicable, add screenshots to help explain your changes.


Additional Notes

Any other information reviewers should know:

  • Implementation decisions made
  • Alternative approaches considered
  • Known limitations
  • Future enhancement ideas

Contributor Checklist

Before Submitting:

  • I have read CONTRIBUTING.md
  • I have followed the skill creation guidelines
  • I have tested thoroughly
  • I have updated all relevant documentation
  • I have added my changes to CHANGELOG.md (Unreleased section)
  • My code follows the repository's style guidelines
  • All new Python scripts are production-ready
  • I agree to the MIT License for my contributions

Thank you for contributing to Claude Skills Library! 🚀

Your contribution helps make world-class expertise accessible to everyone through Claude AI.