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:

undefined

2. Enhance Existing Skills

Improve current skills with:

undefined

3. Improve Documentation

Help others use skills effectively:

undefined

4. Fix Bugs

Report or fix issues in:

undefined

---

🚀 Getting Started

Prerequisites

undefined

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