Contributing to Claude Skills Library

Contributing to Claude Skills Library

Thank you for your interest in contributing to the Claude Skills Library! This repository aims to democratize professional expertise through reusable, production-ready skill packages for Claude AI.

⚠️ Important: Always Target `dev`

**All PRs must target the `dev` branch.** PRs targeting `main` will be automatically closed.

# Fork the repo, then:
git checkout -b feat/my-new-skill origin/dev
# ... make your changes ...
# Open PR → base: dev (NOT main)

The `main` branch is reserved for releases and is maintained by the project owner.

🎯 Ways to Contribute

1. Create New Skills

Add domain expertise in your field:

• Marketing, sales, customer success
• Engineering specializations
• Business functions (finance, HR, operations)
• Industry-specific skills (FinTech, EdTech, etc.)

2. Enhance Existing Skills

Improve current skills with:

• Better frameworks and templates
• Additional Python automation tools
• Updated best practices
• More reference materials
• Real-world examples and case studies

3. Improve Documentation

Help others use skills effectively:

• Clearer how-to guides
• Additional usage examples
• Better README files
• Translations to other languages

4. Fix Bugs

Report or fix issues in:

• Python scripts
• Documentation errors
• Broken links
• Outdated information

---

🚀 Getting Started

Prerequisites

• Python 3.7+ (for running/testing scripts)
• Git and GitHub account
• Claude AI or Claude Code account (for testing skills)
• Familiarity with the skill domain you're contributing to

Fork and Clone

# Fork the repository on GitHub first
git clone https://github.com/YOUR_USERNAME/claude-skills.git
cd claude-skills

# Add upstream remote
git remote add upstream https://github.com/alirezarezvani/claude-skills.git

Create a Branch

# Create feature branch
git checkout -b feature/my-new-skill

# Or for improvements
git checkout -b improvement/enhance-content-creator

---

📝 Skill Creation Guidelines

Following Anthropic's Official Spec

All skills must follow [Anthropic's Agent Skills Specification](https://docs.anthropic.com/en/docs/agents-and-tools/agent-skills/overview).

Required Structure

your-skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name, description, license, metadata)
│   └── Markdown content (instructions, examples, workflows)
├── scripts/ (optional but recommended)
│   ├── tool1.py
│   ├── tool2.py
│   └── tool3.py
├── references/ (optional but recommended)
│   ├── framework.md
│   ├── best-practices.md
│   └── examples.md
└── assets/ (optional)
    └── templates/

SKILL.md Requirements

**YAML Frontmatter (required):**

---
name: your-skill-name
description: What it does and when to use it. Include specific triggers and keywords.
license: MIT
metadata:
  version: 1.0.0
  author: Your Name
  category: domain-category
  updated: 2025-10-28
---

**Markdown Conten