🤝 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!)

• Fix typos or grammar
• Make explanations clearer
• Add examples to existing skills
• Translate documentation to other languages

2. Report Issues

• Found something confusing? Tell us!
• Skill not working? Let us know!
• Have suggestions? We want to hear them!

3. Create New Skills

• Share your expertise as a skill
• Fill gaps in the current collection
• Improve existing skills

4. Test and Validate

• Try skills and report what works/doesn't work
• Test on different AI tools
• Suggest improvements

---

How to Improve Documentation

Super Easy Method (No Git Knowledge Needed!)

1. Find the file you want to improve on GitHub
2. Click the pencil icon (✏️) to edit
3. Make your changes in the browser
4. Click "Propose changes" at the bottom
5. Done! We'll review and merge it

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:

• ✅ Solve a specific problem
• ✅ Be reusable across projects
• ✅ Have clear instructions
• ✅ Include examples when possible

Step-by-Step: Create Your First Skill

Step 1: Choose Your Skill Topic

Ask yourself:

• What am I good at?
• What do I wish my AI assistant knew better?
• What task do I do repeatedly?

**Examples:**

• "I'm good at Docker, let me create a Docker skill"
• "I wish AI understood Tailwind better"
• "I kee