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
parent 55e87a3f0b
commit 496c484b06
10 changed files with 1576 additions and 0 deletions
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,58 @@
+---
+name: Bug Report
+about: Report a bug in a skill or Python script
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+
+A clear and concise description of the bug.
+
+## Affected Skill
+
+**Skill Name:** (e.g., content-creator, ceo-advisor, senior-fullstack)
+**Component:** (e.g., Python script, SKILL.md, reference file)
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Run command '...'
+3. See error
+
+## Expected Behavior
+
+A clear description of what you expected to happen.
+
+## Actual Behavior
+
+What actually happened.
+
+## Error Messages
+
+```
+Paste any error messages here
+```
+
+## Environment
+
+- **OS:** (e.g., macOS 14, Ubuntu 22.04, Windows 11)
+- **Python Version:** (e.g., 3.11.5)
+- **Claude Platform:** (Claude AI, Claude Code, API)
+- **Skill Version:** (check metadata in SKILL.md)
+
+## Additional Context
+
+Add any other context about the problem here, such as:
+- Screenshots
+- Related issues
+- Potential fixes you've identified
+
+## Checklist
+
+- [ ] I have searched existing issues to avoid duplicates
+- [ ] I have tested with the latest version
+- [ ] I have included all relevant error messages
+- [ ] I have provided steps to reproduce
--- a/.github/ISSUE_TEMPLATE/documentation.md
+++ b/.github/ISSUE_TEMPLATE/documentation.md
@@ -0,0 +1,90 @@
+---
+name: Documentation Improvement
+about: Suggest improvements to documentation
+title: '[DOCS] '
+labels: documentation
+assignees: ''
+---
+
+## Documentation Issue
+
+**File(s) Affected:** (e.g., README.md, CLAUDE.md, specific SKILL.md)
+**Section:** (e.g., Installation, Quick Start, Roadmap)
+
+## Issue Type
+
+Select one or more:
+- [ ] Unclear instructions
+- [ ] Missing information
+- [ ] Outdated content
+- [ ] Broken links
+- [ ] Typos or grammar
+- [ ] Missing examples
+- [ ] Incorrect information
+- [ ] Needs reorganization
+- [ ] Other (specify)
+
+## Current Problem
+
+**What is unclear, missing, or incorrect?**
+
+Describe the documentation issue in detail.
+
+## Proposed Improvement
+
+**What should be changed?**
+
+Describe the proposed documentation improvement.
+
+## Specific Changes
+
+### If Fixing Content:
+**Current Text:**
+```
+[Paste current text that needs fixing]
+```
+
+**Proposed Text:**
+```
+[Paste proposed improved text]
+```
+
+### If Adding New Section:
+**Where to Add:** (After which section)
+**Proposed Content:**
+```markdown
+[Paste proposed new section]
+```
+
+### If Reorganizing:
+**Current Structure:**
+- Section 1
+- Section 2
+
+**Proposed Structure:**
+- Section A
+- Section B
+
+## Affected Audience
+
+**Who would benefit from this improvement?**
+
+- [ ] New users getting started
+- [ ] Experienced users seeking advanced features
+- [ ] Contributors wanting to add skills
+- [ ] Developers using Python tools
+- [ ] All users
+
+## Additional Context
+
+- Screenshots showing the issue
+- Links to related documentation
+- Examples from other projects
+- User feedback or questions
+
+## Checklist
+
+- [ ] I have checked this is not already fixed in main branch
+- [ ] I have specified exactly what should change
+- [ ] I have considered the impact on other documentation
+- [ ] I'm willing to submit a PR for this (optional)
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,92 @@
+---
+name: New Skill Request
+about: Suggest a new skill for the library
+title: '[SKILL REQUEST] '
+labels: enhancement, new-skill
+assignees: ''
+---
+
+## Skill Overview
+
+**Proposed Skill Name:**
+**Domain/Category:** (e.g., Marketing, Engineering, Finance, HR)
+**Target Users:** (e.g., Marketing managers, Data scientists, HR professionals)
+
+## Problem Statement
+
+**What problem does this skill solve?**
+
+Describe the challenge or need that this skill addresses.
+
+## Proposed Capabilities
+
+**What should this skill be able to do?**
+
+List the key capabilities:
+- Capability 1
+- Capability 2
+- Capability 3
+
+## Use Cases
+
+**How would users use this skill?**
+
+### Use Case 1:
+**Scenario:**
+**User request:**
+**Expected output:**
+
+### Use Case 2:
+(Add more as needed)
+
+## Python Automation Tools
+
+**What Python tools would be valuable?**
+
+List potential automation scripts:
+- `tool1.py` - Purpose
+- `tool2.py` - Purpose
+- `tool3.py` - Purpose
+
+## References & Frameworks
+
+**What knowledge bases should be included?**
+
+List frameworks, templates, or reference materials:
+- Framework 1
+- Template 2
+- Best practices guide 3
+
+## Similar Skills/Tools
+
+**Are there existing skills or tools that are similar?**
+
+List any:
+- Similar skills in this repository
+- External tools or resources
+- How this differs/improves
+
+## Value Proposition
+
+**Why is this skill valuable?**
+
+- **Time Savings:** Estimated hours saved per month
+- **Quality Improvement:** Expected quality gains
+- **Target Audience Size:** How many people would benefit
+- **ROI Estimate:** Potential financial impact
+
+## Additional Context
+
+Any other information:
+- Industry trends supporting this need
+- User research or feedback
+- Links to related resources
+- Willingness to contribute to development
+
+## Checklist
+
+- [ ] I have searched existing skills to avoid duplicates
+- [ ] I have searched existing issues/requests
+- [ ] I have clearly defined the problem and use cases
+- [ ] I have specified what should be automated (Python tools)
+- [ ] I have estimated the value/ROI
--- a/.github/ISSUE_TEMPLATE/skill_improvement.md
+++ b/.github/ISSUE_TEMPLATE/skill_improvement.md
@@ -0,0 +1,102 @@
+---
+name: Skill Improvement
+about: Suggest improvements to an existing skill
+title: '[IMPROVEMENT] '
+labels: enhancement
+assignees: ''
+---
+
+## Skill Information
+
+**Skill Name:** (e.g., content-creator, product-manager-toolkit)
+**Current Version:** (check metadata in SKILL.md)
+**Domain:** (e.g., Marketing, Product, Engineering)
+
+## Improvement Type
+
+Select the type of improvement:
+- [ ] Add new Python tool/script
+- [ ] Enhance existing script functionality
+- [ ] Add new reference materials
+- [ ] Improve SKILL.md documentation
+- [ ] Add new templates or examples
+- [ ] Update frameworks or best practices
+- [ ] Fix outdated information
+- [ ] Other (specify)
+
+## Current Limitation
+
+**What is currently missing or could be better?**
+
+Describe the limitation or gap in the current skill.
+
+## Proposed Enhancement
+
+**What should be added or improved?**
+
+Detailed description of the proposed improvement.
+
+## Specific Changes
+
+**What exactly would change?**
+
+### If Adding Python Tool:
+- **Script Name:** tool_name.py
+- **Purpose:** What it does
+- **Input:** What it takes
+- **Output:** What it produces
+- **Usage Example:** `python scripts/tool_name.py input.txt`
+
+### If Enhancing Documentation:
+- **Files to Update:**
+- **Sections to Add/Modify:**
+- **New Content:**
+
+### If Adding References:
+- **New Reference File:** references/framework.md
+- **Content:** Framework, template, or guideline
+- **Purpose:** When and how to use it
+
+## Value Proposition
+
+**Why is this improvement valuable?**
+
+- **Additional Time Savings:** Hours saved per month
+- **Quality Improvement:** Specific quality gains
+- **User Impact:** Who benefits and how
+- **Completeness:** Fills a gap in current coverage
+
+## Examples
+
+**Show how this would be used:**
+
+### Before (Current State):
+```
+Current workflow or limitation
+```
+
+### After (With Improvement):
+```
+Improved workflow or capability
+```
+
+## Implementation Willingness
+
+- [ ] I'm willing to implement this improvement myself
+- [ ] I need help implementing this
+- [ ] I'm suggesting for someone else to implement
+
+## Additional Context
+
+Any other information:
+- Related skills or tools
+- Industry best practices
+- User feedback or requests
+- Links to relevant resources
+
+## Checklist
+
+- [ ] I have checked the latest version of the skill
+- [ ] This improvement doesn't duplicate existing functionality
+- [ ] I have clearly described the value proposition
+- [ ] I have provided concrete examples
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -0,0 +1,183 @@
+# 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)
+
+## Related Issue
+
+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:**
+```bash
+# 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](../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.