docs: restore detailed guides mixed with V3 updates (reverting aggressive pruning) [skip ci]

This commit is contained in:
sck_0
2026-01-25 20:15:44 +01:00
parent c96815ed7c
commit 45e2049663
2 changed files with 92 additions and 20 deletions

52
FAQ.md
View File

@@ -1,11 +1,15 @@
# ❓ Frequently Asked Questions (V3)
**Got questions?** Here are answers to the most common questions about Antigravity Awesome Skills.
---
## 🔒 Security & Trust
## 🔒 Security & Trust (V3)
### Q: What do the Risk Labels mean?
In V3, we classify skills so you know what you're running:
-**Safe (White/Blue)**: Read-only, planning, or benign skills. Safe to run anywhere.
- 🔴 **Risk (Red)**: Skills that modify files, delete resources, or perform security scans. **Use with caution.**
- 🟣 **Official (Purple)**: Maintained by trusted vendors (Anthropic, DeepMind, etc.).
@@ -18,12 +22,21 @@ _Always review the code before creating a skill, and check the Risk label._
---
## 📦 Installation & Usage
## 📦 Installation & Setup
### Q: Why shouldn't I just copy all files?
### Q: Do I need to install all 250+ skills?
You can! But 250+ files might clutter your context window.
We recommend using **Starter Packs** (`docs/BUNDLES.md`) to install only what you need for your specific role.
**No!** When you clone the repository, all skills are available, but your AI only loads them when you explicitly invoke them with `@skill-name`.
It's like having a library - all the books are there, but you only read the ones you need.
_Pro Tip: Use [Starter Packs](docs/BUNDLES.md) to install only what matches your role._
### Q: Where should I install the skills?
The universal path is `.agent/skills/`:
```bash
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
```
### Q: Does this work with Windows?
@@ -34,7 +47,30 @@ Or enable "Developer Mode" in Windows Settings.
---
## 🛠️ Contribution
## 🛠️ Usage & Troubleshooting
### Q: How do I invoke a skill?
In your AI chat (Claude, Cursor, etc.), just use the `@` mention:
```
@brainstorming help me design a todo app
```
### Q: My AI assistant doesn't recognize skills. Why?
1. **Wrong Path**: Did you clone to `.agent/skills/`? Check your tool's settings.
2. **Restart Needed**: Some tools (like Cursor) need a restart to index new files.
3. **Typos**: Check `ls .agent/skills/` to see the exact folder name.
### Q: What if a skill gives bad code?
Please [Open an Issue](https://github.com/sickn33/antigravity-awesome-skills/issues)!
Describe what happened and which skill was responsible. We update skills regularly to fix hallucinations.
---
## 🤝 Contribution
### Q: My PR failed "Quality Bar" check. Why?
@@ -48,3 +84,7 @@ V3 introduces automated quality control. Your skill might be missing:
**No.** Official skills (in `skills/official/`) are mirrored from vendors.
Open an issue instead, and we will forward it to the maintainers.
### Q: Can I make my own skills?
**Absolutely!** Check out the **@skill-creator** skill or read [CONTRIBUTING.md](CONTRIBUTING.md).