awesome-agent-skills/CONTRIBUTING.md

# Contributing

**This is a curated collection of links** to Claude Skills, articles, and videos. We organize links to existing resources, we don't host skills or content.

## How to Contribute

1. Fork the repository
2. Create a branch (`git checkout -b add-new-skill`)
3. Edit `README.md`
4. Commit (`git commit -m 'Add skill: author/skill-name'`)
5. Push (`git push origin add-new-skill`)
6. Open a Pull Request

## Adding a Skill

### Format

```markdown
| **author/skill-name** | [![Source Code](https://img.shields.io/badge/source-code-blue?logo=github)](https://github.com/author/repo/path) | Description |
```


### Requirements

- ✅ Public repository
- ✅ Working skill
- ✅ Has documentation
- ✅ Relevant to Claude Skills
- ✅ Author prefix included

## Adding Articles

### Format

```markdown
| **Title** | [![Badge](https://img.shields.io/badge/type-blue?logo=icon&logoColor=white)](https://url) | Description |
```

### Badges

**Docs:**
```markdown
[![Docs](https://img.shields.io/badge/docs-blue?logo=readthedocs&logoColor=white)](https://url)
```

**GitHub Docs:**
```markdown
[![Docs](https://img.shields.io/badge/docs-blue?logo=github&logoColor=white)](https://url)
```

**Blog:**
```markdown
[![Blog](https://img.shields.io/badge/blog-blue?logo=rss&logoColor=white)](https://url)
```

**Article:**
```markdown
[![Article](https://img.shields.io/badge/article-blue?logo=medium&logoColor=white)](https://url)
```

### Requirements

- ✅ Public (no paywall)
- ✅ Relevant to Claude Skills
- ✅ Accurate and current

## Adding Videos

### Format

```markdown
| **Title** | [![YouTube](https://img.shields.io/badge/YouTube-red?logo=youtube&logoColor=white)](https://youtube.com/watch?v=ID) | |
```

### Requirements

- ✅ Public on YouTube
- ✅ Relevant to Claude Skills
- ✅ Good quality

## Pull Request

### Title Format

- Skill: `Add skill: author/skill-name`
- Article: `Add article: Title`
- Video: `Add video: Title`
- Update: `Update: author/skill-name`
- Fix: `Fix: description`

### Template

```markdown
## Type
- [ ] Skill
- [ ] Article
- [ ] Video
- [ ] Fix

## Checklist
- [ ] Link works
- [ ] Relevant to Claude Skills
- [ ] Formatting correct
- [ ] Added to correct section
- [ ] (Skills) Author prefix included
```


## Important

⭐ This repository:
- Curates links only
- Doesn't host skill code
- Each skill lives in its own repo

📝 Before submitting:
- Verify links work
- Check documentation exists
- Ensure public access

## Help

- Check existing issues/PRs
- Open new issue for questions
- Visit skill's repo for skill-specific help

---

Thank you for contributing! 🎉