🤝 Contributing Guide - Make It Easy for Everyone!

🤝 Contributing Guide - Make It Easy for Everyone!

**Thank you for wanting to make this repo better!** This guide shows you exactly how to contribute, even if you're new to open source.

---

Quick Start for Contributors

# 1. Fork and clone
git clone https://github.com/YOUR-USERNAME/antigravity-awesome-skills.git
cd antigravity-awesome-skills

# 2. Install dependencies
npm install

# 3. Create your skill
mkdir -p skills/my-awesome-skill

# 4. Use the canonical template
cp docs/contributors/skill-template.md skills/my-awesome-skill/SKILL.md

# 5. Edit and validate
npm run validate

# For SKILL.md with shell/network/credential/mutation guidance:
npm run security:docs

# 6. Open a PR
git add skills/my-awesome-skill/
git commit -m "feat: add my-awesome-skill for [purpose]"
git push origin my-branch

Open the PR with the default template and enable **Allow edits from maintainers** so conflicts can be resolved without extra back-and-forth.

If you only want to improve docs, editing directly in GitHub is still perfectly fine.

---

Ways to Contribute

You don't need to be an expert! Here are ways anyone can help:

1. Improve Documentation (Easiest!)

undefined

2. Report Issues

undefined

3. Create New Skills

undefined

4. Test and Validate

undefined

---

How to Improve Documentation

Super Easy Method (No Git Knowledge Needed!)

undefined

Using Git (If You Know How)

# 1. Fork the repo on GitHub (click the Fork button)

# 2. Clone your fork
git clone https://github.com/YOUR-USERNAME/antigravity-awesome-skills.git
cd antigravity-awesome-skills

# 3. Create a branch
git checkout -b improve-docs

# 4. Make your changes
# Edit files in your favorite editor

# 5. Commit and push
git add .
git commit -m "docs: make XYZ clearer"
git push origin improve-docs

# 6. Open a Pull Request on GitHub

---

How to Create a New Skill

What Makes a Good Skill?

A skill should:

undefined

Step-by-Step: Create Your First Skill

Step 1: Choose Your Skill Topic

Ask yourself:

undefined

**Examples:**

undefined