docs: restore detailed guides mixed with V3 updates (reverting aggressive pruning) [skip ci]
This commit is contained in:
52
FAQ.md
52
FAQ.md
@@ -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).
|
||||
|
||||
Reference in New Issue
Block a user