refactor: reorganize repo docs and tooling layout
Consolidate the repository into clearer apps, tools, and layered docs areas so contributors can navigate and maintain it more reliably. Align validation, metadata sync, and CI around the same canonical workflow to reduce drift across local checks and GitHub Actions.
This commit is contained in:
sck_0
49
.github/MAINTENANCE.md
vendored
49
.github/MAINTENANCE.md
vendored
@@ -80,13 +80,13 @@ Before ANY commit that adds/modifies skills, run the chain:
|
||||
git commit -m "chore: sync generated files"
|
||||
```
|
||||
> 🔴 **CRITICAL**: If you skip this, CI will fail with "Detected uncommitted changes".
|
||||
> See [docs/CI_DRIFT_FIX.md](../docs/CI_DRIFT_FIX.md) for details.
|
||||
> See [`docs/maintainers/ci-drift-fix.md`](../docs/maintainers/ci-drift-fix.md) for details.
|
||||
|
||||
### B. When You Merge a PR (Step-by-Step)
|
||||
|
||||
**Before merging:**
|
||||
|
||||
1. **CI is green** — All Validation Chain and catalog steps passed (see [workflows/ci.yml](workflows/ci.yml)).
|
||||
1. **CI is green** — Validation, reference checks, tests, and generated artifact steps passed (see [`.github/workflows/ci.yml`](workflows/ci.yml)).
|
||||
2. **No drift** — PR does not introduce uncommitted generated-file changes; if the "Check for Uncommitted Drift" step failed, ask the author to run `npm run chain` and `npm run catalog` and commit the result.
|
||||
3. **Quality Bar** — PR description confirms the [Quality Bar Checklist](.github/PULL_REQUEST_TEMPLATE.md) (metadata, risk label, credits if applicable).
|
||||
4. **Issue link** — If the PR fixes an issue, the PR description should contain `Closes #N` or `Fixes #N` so GitHub auto-closes the issue on merge.
|
||||
@@ -134,21 +134,21 @@ GitHub's anchor generation breaks if headers have emojis.
|
||||
If you update installation instructions or tool compatibility, you MUST update all 3 files:
|
||||
|
||||
1. `README.md` (Source of Truth)
|
||||
2. `docs/GETTING_STARTED.md` (Beginner Guide)
|
||||
3. `docs/FAQ.md` (Troubleshooting)
|
||||
2. `docs/users/getting-started.md` (Beginner Guide)
|
||||
3. `docs/users/faq.md` (Troubleshooting)
|
||||
|
||||
_Common pitfall: Updating the clone URL in README but leaving an old one in FAQ._
|
||||
|
||||
### C. Statistics Consistency (CRITICAL)
|
||||
|
||||
If you add/remove skills, you **MUST** ensure the total count is identical in ALL locations.
|
||||
**Do not allow drift** (e.g., 560 in title, 558 in header).
|
||||
If you add/remove skills, you **MUST** ensure generated counts and user-facing claims stay aligned.
|
||||
|
||||
Locations to check:
|
||||
|
||||
1. **Title of `README.md`**: "1,200+ Agentic Skills..."
|
||||
2. **`## Full Skill Registry (1,200+/1,200+)` header**.
|
||||
3. **`docs/GETTING_STARTED.md` intro**.
|
||||
1. `README.md`
|
||||
2. `package.json` description
|
||||
3. `skills_index.json` and generated catalog artifacts
|
||||
4. Any user docs that deliberately hardcode counts
|
||||
|
||||
### D. Credits Policy (Who goes where?)
|
||||
|
||||
@@ -166,7 +166,7 @@ Locations to check:
|
||||
|
||||
If you touch any Workflows-related artifact, keep all workflow surfaces in sync:
|
||||
|
||||
1. `docs/WORKFLOWS.md` (human-readable playbooks)
|
||||
1. `docs/users/workflows.md` (human-readable playbooks)
|
||||
2. `data/workflows.json` (machine-readable schema)
|
||||
3. `skills/antigravity-workflows/SKILL.md` (orchestration entrypoint)
|
||||
|
||||
@@ -177,8 +177,8 @@ Rules:
|
||||
- If a workflow references optional skills not yet merged (example: `go-playwright`), mark them explicitly as **optional** in docs.
|
||||
- If workflow onboarding text is changed, update the docs trinity:
|
||||
- `README.md`
|
||||
- `docs/GETTING_STARTED.md`
|
||||
- `docs/FAQ.md`
|
||||
- `docs/users/getting-started.md`
|
||||
- `docs/users/faq.md`
|
||||
|
||||
---
|
||||
|
||||
@@ -192,7 +192,7 @@ Reject any PR that fails this:
|
||||
2. **Safety**: `risk: offensive` used for red-team tools?
|
||||
3. **Clarity**: Does it say _when_ to use it?
|
||||
4. **Examples**: Copy-pasteable code blocks?
|
||||
5. **Actions**: "Run this command" vs "Think about this".
|
||||
5. **Limitations / Safety Notes**: Edge cases and risk boundaries are stated clearly.
|
||||
|
||||
### B. Risk Labels (V4)
|
||||
|
||||
@@ -204,14 +204,25 @@ Reject any PR that fails this:
|
||||
|
||||
## 4. 🚀 Release Workflow
|
||||
|
||||
When cutting a new version (e.g., v4.1.0):
|
||||
When cutting a new version, follow the maintainer playbook in [`docs/maintainers/release-process.md`](../docs/maintainers/release-process.md).
|
||||
|
||||
**Release checklist (order matters):**
|
||||
Validate → Changelog → Bump `package.json` (and README if needed) → Commit & push → Create GitHub Release with tag **matching** `package.json` (e.g. `v4.1.0` ↔ `"version": "4.1.0"`) → npm publish (manual or via CI) → Close any remaining linked issues.
|
||||
Operational verification → Changelog → Bump `package.json` (and README if needed) → Commit & push → Create GitHub Release with tag matching `package.json` → npm publish (manual or via CI) → Close remaining linked issues.
|
||||
|
||||
---
|
||||
|
||||
1. **Run Full Validation**: `python3 scripts/validate_skills.py --strict`
|
||||
1. **Run release verification**:
|
||||
```bash
|
||||
npm run validate
|
||||
npm run validate:references
|
||||
npm run sync:all
|
||||
npm run test
|
||||
npm run app:build
|
||||
```
|
||||
Optional diagnostic pass:
|
||||
```bash
|
||||
npm run validate:strict
|
||||
```
|
||||
2. **Update Changelog**: Add the new release section to `CHANGELOG.md`.
|
||||
3. **Bump Version**:
|
||||
- Update `package.json` → `"version": "X.Y.Z"` (source of truth for npm).
|
||||
@@ -224,12 +235,12 @@ Validate → Changelog → Bump `package.json` (and README if needed) → Commit
|
||||
Use the GitHub CLI:
|
||||
|
||||
```bash
|
||||
# Prepare release notes (copy the new section from CHANGELOG.md into release_notes.md, or use CHANGELOG excerpt)
|
||||
# Prepare release notes (copy the new section from CHANGELOG.md into docs/maintainers/release-process.md, or use CHANGELOG excerpt)
|
||||
# Then create the tag AND the release page (tag must match package.json version, e.g. v4.1.0)
|
||||
gh release create v4.0.0 --title "v4.0.0 - [Theme Name]" --notes-file release_notes.md
|
||||
gh release create v4.0.0 --title "v4.0.0 - [Theme Name]" --notes-file docs/maintainers/release-process.md
|
||||
```
|
||||
|
||||
**Important:** The release tag (e.g. `v4.1.0`) must match `package.json`'s `"version": "4.1.0"`. The [Publish to npm](workflows/publish-npm.yml) workflow runs on **Release published** and will run `npm publish`; npm rejects republishing the same version.
|
||||
**Important:** The release tag must match `package.json`'s version. The [Publish to npm](workflows/publish-npm.yml) workflow runs on **Release published** and will run `npm publish`; npm rejects republishing the same version.
|
||||
|
||||
_Or create the release manually via GitHub UI > Releases > Draft a new release, then publish._
|
||||
|
||||
|
||||
7
.github/PULL_REQUEST_TEMPLATE.md
vendored
7
.github/PULL_REQUEST_TEMPLATE.md
vendored
@@ -6,12 +6,13 @@ Please include a summary of the change and which skill is added or fixed.
|
||||
|
||||
**All items must be checked before merging.**
|
||||
|
||||
- [ ] **Standards**: I have read `docs/QUALITY_BAR.md` and `docs/SECURITY_GUARDRAILS.md`.
|
||||
- [ ] **Metadata**: The `SKILL.md` frontmatter is valid (checked with `scripts/validate_skills.py`).
|
||||
- [ ] **Risk Label**: I have assigned the correct `risk:` tag (`none`, `safe`, `critical`, `offensive`).
|
||||
- [ ] **Standards**: I have read `docs/contributors/quality-bar.md` and `docs/contributors/security-guardrails.md`.
|
||||
- [ ] **Metadata**: The `SKILL.md` frontmatter is valid (checked with `npm run validate`).
|
||||
- [ ] **Risk Label**: I have assigned the correct `risk:` tag (`none`, `safe`, `critical`, `offensive`, or `unknown` for legacy/unclassified content).
|
||||
- [ ] **Triggers**: The "When to use" section is clear and specific.
|
||||
- [ ] **Security**: If this is an _offensive_ skill, I included the "Authorized Use Only" disclaimer.
|
||||
- [ ] **Local Test**: I have verified the skill works locally.
|
||||
- [ ] **Repo Checks**: I ran `npm run validate:references` if my change affected docs, bundles, workflows, or generated artifacts.
|
||||
- [ ] **Credits**: I have added the source credit in `README.md` (if applicable).
|
||||
|
||||
## Type of Change
|
||||
|
||||
41
.github/workflows/ci.yml
vendored
41
.github/workflows/ci.yml
vendored
@@ -25,18 +25,6 @@ jobs:
|
||||
run: |
|
||||
pip install pyyaml
|
||||
|
||||
- name: 🔍 Validate Skills (Soft Mode)
|
||||
run: |
|
||||
python3 scripts/validate_skills.py
|
||||
|
||||
- name: 🏗️ Generate Index
|
||||
run: |
|
||||
python3 scripts/generate_index.py
|
||||
|
||||
- name: 📝 Update README
|
||||
run: |
|
||||
python3 scripts/update_readme.py
|
||||
|
||||
- name: Set up Node
|
||||
uses: actions/setup-node@v4
|
||||
with:
|
||||
@@ -45,6 +33,31 @@ jobs:
|
||||
- name: Install npm dependencies
|
||||
run: npm ci
|
||||
|
||||
- name: Verify directory structure
|
||||
run: |
|
||||
test -d skills/
|
||||
test -d apps/web-app/
|
||||
test -d tools/scripts/
|
||||
test -d tools/lib/
|
||||
test -f README.md
|
||||
test -f CONTRIBUTING.md
|
||||
|
||||
- name: 🔍 Validate Skills (Soft Mode)
|
||||
run: |
|
||||
npm run validate
|
||||
|
||||
- name: 🔗 Validate References
|
||||
run: |
|
||||
npm run validate:references
|
||||
|
||||
- name: 🏗️ Generate Index
|
||||
run: |
|
||||
npm run index
|
||||
|
||||
- name: 📝 Update README
|
||||
run: |
|
||||
npm run readme
|
||||
|
||||
- name: Audit npm dependencies
|
||||
run: npm audit --audit-level=high
|
||||
continue-on-error: true
|
||||
@@ -60,8 +73,8 @@ jobs:
|
||||
- name: Set up GitHub credentials (for auto-sync)
|
||||
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
|
||||
run: |
|
||||
git config --global user.name 'github-actions[bot]'
|
||||
git config --global user.email 'github-actions[bot]@users.noreply.github.com'
|
||||
git config user.name 'github-actions[bot]'
|
||||
git config user.email 'github-actions[bot]@users.noreply.github.com'
|
||||
git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git
|
||||
|
||||
- name: Auto-commit registry drift (main only)
|
||||
|
||||
4
.gitignore
vendored
4
.gitignore
vendored
@@ -37,5 +37,5 @@ scripts/*count*.py
|
||||
validation-baseline.json
|
||||
|
||||
# Web app generated assets (from npm run app:setup)
|
||||
web-app/public/skills/
|
||||
web-app/public/skills.json
|
||||
apps/web-app/public/skills/
|
||||
apps/web-app/public/skills.json
|
||||
|
||||
@@ -4,6 +4,35 @@
|
||||
|
||||
---
|
||||
|
||||
## Quick Start for Contributors
|
||||
|
||||
```bash
|
||||
# 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
|
||||
|
||||
# 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
|
||||
```
|
||||
|
||||
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:
|
||||
@@ -106,12 +135,17 @@ touch SKILL.md
|
||||
|
||||
#### Step 3: Write Your SKILL.md
|
||||
|
||||
Every skill needs this basic structure:
|
||||
Every skill should start from the canonical template in [`docs/contributors/skill-template.md`](docs/contributors/skill-template.md).
|
||||
|
||||
Minimum frontmatter:
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: my-awesome-skill
|
||||
description: "Brief one-line description of what this skill does"
|
||||
risk: safe
|
||||
source: community
|
||||
date_added: "2026-03-06"
|
||||
---
|
||||
|
||||
# Skill Title
|
||||
@@ -183,10 +217,19 @@ More examples...
|
||||
|
||||
#### Step 5: Validate Your Skill
|
||||
|
||||
Run the validation script:
|
||||
Recommended validation path:
|
||||
|
||||
```bash
|
||||
python3 scripts/validate_skills.py
|
||||
npm install
|
||||
npm run validate
|
||||
npm run validate:references
|
||||
npm test
|
||||
```
|
||||
|
||||
Python-only fallback:
|
||||
|
||||
```bash
|
||||
python3 tools/scripts/validate_skills.py
|
||||
```
|
||||
|
||||
This checks:
|
||||
@@ -194,6 +237,15 @@ This checks:
|
||||
- ✅ Frontmatter is correct
|
||||
- ✅ Name matches folder name
|
||||
- ✅ Description exists
|
||||
- ✅ Reference data and docs bundles stay coherent
|
||||
|
||||
Optional hardening pass:
|
||||
|
||||
```bash
|
||||
npm run validate:strict
|
||||
```
|
||||
|
||||
`validate:strict` is useful before larger cleanup PRs, but the repository still contains legacy skills that do not all satisfy the strict quality bar.
|
||||
|
||||
#### Step 6: Submit Your Skill
|
||||
|
||||
@@ -214,12 +266,15 @@ git push origin my-branch
|
||||
|
||||
## Skill Template (Copy & Paste)
|
||||
|
||||
Save time! Copy this template:
|
||||
The canonical template now lives at [`docs/contributors/skill-template.md`](docs/contributors/skill-template.md). You can still use the inline version below as a starting point:
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: your-skill-name
|
||||
description: "One sentence describing what this skill does and when to use it"
|
||||
risk: safe
|
||||
source: community
|
||||
date_added: "2026-03-06"
|
||||
---
|
||||
|
||||
# Your Skill Name
|
||||
@@ -327,10 +382,11 @@ description: "One sentence describing what this skill does and when to use it"
|
||||
Before submitting your contribution:
|
||||
|
||||
- [ ] My skill has a clear, descriptive name
|
||||
- [ ] The `SKILL.md` has proper frontmatter (name + description)
|
||||
- [ ] The `SKILL.md` has proper frontmatter (`name`, `description`, `risk`, `source`, `date_added`)
|
||||
- [ ] I've included examples
|
||||
- [ ] I've tested the skill with an AI assistant
|
||||
- [ ] I've run `python3 scripts/validate_skills.py`
|
||||
- [ ] I've run `npm run validate`
|
||||
- [ ] I've run `npm run validate:references` and `npm test` when my change affects docs, bundles, workflows, or generated artifacts
|
||||
- [ ] My commit message is clear (e.g., "feat: add docker-compose skill")
|
||||
- [ ] I've checked for typos and grammar
|
||||
|
||||
|
||||
529
FAQ.md
529
FAQ.md
@@ -1,528 +1,3 @@
|
||||
# ❓ Frequently Asked Questions (FAQ)
|
||||
# FAQ
|
||||
|
||||
**Got questions?** You're not alone! Here are answers to the most common questions about Antigravity Awesome Skills.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 General Questions
|
||||
|
||||
### What are "skills" exactly?
|
||||
|
||||
Skills are specialized instruction files that teach AI assistants how to handle specific tasks. Think of them as expert knowledge modules that your AI can load on-demand.
|
||||
|
||||
**Simple analogy:** Just like you might consult different experts (a lawyer, a doctor, a mechanic), skills let your AI become an expert in different areas when you need them.
|
||||
|
||||
---
|
||||
|
||||
### Do I need to install all 179 skills?
|
||||
|
||||
**No!** When you clone the repository, all skills are available, but your AI only loads them when you explicitly invoke them with `@skill-name` or `/skill-name`.
|
||||
|
||||
It's like having a library - all the books are there, but you only read the ones you need.
|
||||
|
||||
---
|
||||
|
||||
### Which AI tools work with these skills?
|
||||
|
||||
These skills work with any AI coding assistant that supports the `SKILL.md` format:
|
||||
|
||||
- ✅ **Claude Code** (Anthropic CLI)
|
||||
- ✅ **Gemini CLI** (Google)
|
||||
- ✅ **Codex CLI** (OpenAI)
|
||||
- ✅ **Cursor** (AI IDE)
|
||||
- ✅ **Antigravity IDE**
|
||||
- ✅ **OpenCode**
|
||||
- ⚠️ **GitHub Copilot** (partial support)
|
||||
|
||||
---
|
||||
|
||||
### Are these skills free to use?
|
||||
|
||||
**Yes!** This repository is licensed under MIT License, which means:
|
||||
- ✅ Free for personal use
|
||||
- ✅ Free for commercial use
|
||||
- ✅ You can modify them
|
||||
- ✅ You can redistribute them
|
||||
|
||||
---
|
||||
|
||||
### Do skills work offline?
|
||||
|
||||
The skill files themselves are stored locally on your computer, but your AI assistant needs an internet connection to function. So:
|
||||
- ✅ Skills are local files
|
||||
- ❌ AI assistant needs internet
|
||||
|
||||
---
|
||||
|
||||
## Installation & Setup
|
||||
|
||||
### Where should I install the skills?
|
||||
|
||||
The universal path that works with most tools is `.agent/skills/`:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
**Tool-specific paths:**
|
||||
- Claude Code: `.claude/skills/` or `.agent/skills/`
|
||||
- Gemini CLI: `.gemini/skills/` or `.agent/skills/`
|
||||
- Cursor: `.cursor/skills/` or project root
|
||||
- Antigravity: `.agent/skills/`
|
||||
|
||||
---
|
||||
|
||||
### Can I install skills in multiple projects?
|
||||
|
||||
**Yes!** You have two options:
|
||||
|
||||
**Option 1: Global Installation** (recommended)
|
||||
Install once in your home directory, works for all projects:
|
||||
```bash
|
||||
cd ~
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
**Option 2: Per-Project Installation**
|
||||
Install in each project directory:
|
||||
```bash
|
||||
cd /path/to/your/project
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### How do I update skills to the latest version?
|
||||
|
||||
Navigate to your skills directory and pull the latest changes:
|
||||
|
||||
```bash
|
||||
cd .agent/skills
|
||||
git pull origin main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Can I install only specific skills?
|
||||
|
||||
**Yes!** You can manually copy individual skill folders:
|
||||
|
||||
```bash
|
||||
# Clone the full repo first
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git temp-skills
|
||||
|
||||
# Copy only the skills you want
|
||||
mkdir -p .agent/skills
|
||||
cp -r temp-skills/skills/brainstorming .agent/skills/
|
||||
cp -r temp-skills/skills/stripe-integration .agent/skills/
|
||||
|
||||
# Clean up
|
||||
rm -rf temp-skills
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Using Skills
|
||||
|
||||
### How do I invoke a skill?
|
||||
|
||||
Use the `@` symbol followed by the skill name:
|
||||
|
||||
```
|
||||
@skill-name your request here
|
||||
```
|
||||
|
||||
**Examples:**
|
||||
```
|
||||
@brainstorming help me design a todo app
|
||||
@stripe-integration add subscription billing
|
||||
@systematic-debugging fix this test failure
|
||||
```
|
||||
|
||||
Some tools also support `/skill-name` syntax.
|
||||
|
||||
---
|
||||
|
||||
### How do I know which skill to use?
|
||||
|
||||
**Method 1: Browse the README**
|
||||
Check the [Full Skill Registry](README.md#full-skill-registry-179179) organized by category
|
||||
|
||||
**Method 2: Search by keyword**
|
||||
```bash
|
||||
ls skills/ | grep "keyword"
|
||||
```
|
||||
|
||||
**Method 3: Ask your AI**
|
||||
```
|
||||
What skills are available for [topic]?
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Can I use multiple skills at once?
|
||||
|
||||
**Yes!** You can invoke multiple skills in the same conversation:
|
||||
|
||||
```
|
||||
@brainstorming help me design this feature
|
||||
|
||||
[After brainstorming...]
|
||||
|
||||
@test-driven-development now let's implement it with tests
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### What if a skill doesn't work?
|
||||
|
||||
**Troubleshooting steps:**
|
||||
|
||||
1. **Check installation path**
|
||||
```bash
|
||||
ls .agent/skills/
|
||||
```
|
||||
|
||||
2. **Verify skill exists**
|
||||
```bash
|
||||
ls .agent/skills/skill-name/
|
||||
```
|
||||
|
||||
3. **Check SKILL.md exists**
|
||||
```bash
|
||||
cat .agent/skills/skill-name/SKILL.md
|
||||
```
|
||||
|
||||
4. **Try restarting your AI assistant**
|
||||
|
||||
5. **Check for typos in skill name**
|
||||
- Use `@brainstorming` not `@brain-storming`
|
||||
- Names are case-sensitive in some tools
|
||||
|
||||
6. **Report the issue**
|
||||
[Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues) with details
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
### I'm new to open source. Can I still contribute?
|
||||
|
||||
**Absolutely!** Everyone starts somewhere. We welcome contributions from beginners:
|
||||
|
||||
- Fix typos or grammar
|
||||
- Improve documentation clarity
|
||||
- Add examples to existing skills
|
||||
- Report issues or confusing parts
|
||||
|
||||
Check out [CONTRIBUTING_GUIDE.md](CONTRIBUTING_GUIDE.md) for step-by-step instructions.
|
||||
|
||||
---
|
||||
|
||||
### Do I need to know how to code to contribute?
|
||||
|
||||
**No!** Many valuable contributions don't require coding:
|
||||
|
||||
- **Documentation improvements** - Make things clearer
|
||||
- **Examples** - Add real-world usage examples
|
||||
- **Issue reporting** - Tell us what's confusing
|
||||
- **Testing** - Try skills and report what works
|
||||
|
||||
---
|
||||
|
||||
### How do I create a new skill?
|
||||
|
||||
**Quick version:**
|
||||
|
||||
1. Create a folder: `skills/my-skill-name/`
|
||||
2. Create `SKILL.md` with frontmatter and content
|
||||
3. Test it with your AI assistant
|
||||
4. Run validation: `python3 scripts/validate_skills.py`
|
||||
5. Submit a Pull Request
|
||||
|
||||
**Detailed version:** See [CONTRIBUTING_GUIDE.md](CONTRIBUTING_GUIDE.md)
|
||||
|
||||
---
|
||||
|
||||
### What makes a good skill?
|
||||
|
||||
A good skill:
|
||||
- ✅ Solves a specific problem
|
||||
- ✅ Has clear, actionable instructions
|
||||
- ✅ Includes examples
|
||||
- ✅ Is reusable across projects
|
||||
- ✅ Follows the standard structure
|
||||
|
||||
See [SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md) for details.
|
||||
|
||||
---
|
||||
|
||||
### How long does it take for my contribution to be reviewed?
|
||||
|
||||
Review times vary, but typically:
|
||||
- **Simple fixes** (typos, docs): 1-3 days
|
||||
- **New skills**: 3-7 days
|
||||
- **Major changes**: 1-2 weeks
|
||||
|
||||
You can speed this up by:
|
||||
- Following the contribution guidelines
|
||||
- Writing clear commit messages
|
||||
- Testing your changes
|
||||
- Responding to feedback quickly
|
||||
|
||||
---
|
||||
|
||||
## Technical Questions
|
||||
|
||||
### What's the difference between SKILL.md and README.md?
|
||||
|
||||
- **SKILL.md** (required): The actual skill definition that the AI reads
|
||||
- **README.md** (optional): Human-readable documentation about the skill
|
||||
|
||||
The AI primarily uses `SKILL.md`, while developers read `README.md`.
|
||||
|
||||
---
|
||||
|
||||
### Can I use scripts or code in my skill?
|
||||
|
||||
**Yes!** Skills can include:
|
||||
- `scripts/` - Helper scripts
|
||||
- `examples/` - Example code
|
||||
- `templates/` - Code templates
|
||||
- `references/` - Documentation
|
||||
|
||||
Reference them in your `SKILL.md`:
|
||||
```markdown
|
||||
Run the setup script:
|
||||
\`\`\`bash
|
||||
bash scripts/setup.sh
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### What programming languages can skills cover?
|
||||
|
||||
**Any language!** Current skills cover:
|
||||
- JavaScript/TypeScript
|
||||
- Python
|
||||
- Go
|
||||
- Rust
|
||||
- Swift
|
||||
- Kotlin
|
||||
- Shell scripting
|
||||
- And many more...
|
||||
|
||||
---
|
||||
|
||||
### Can skills call other skills?
|
||||
|
||||
**Yes!** Skills can reference other skills:
|
||||
|
||||
```markdown
|
||||
## Workflow
|
||||
|
||||
1. First, use `@brainstorming` to design
|
||||
2. Then, use `@writing-plans` to plan
|
||||
3. Finally, use `@test-driven-development` to implement
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### How do I validate my skill before submitting?
|
||||
|
||||
Run the validation script:
|
||||
|
||||
```bash
|
||||
python3 scripts/validate_skills.py
|
||||
```
|
||||
|
||||
This checks:
|
||||
- ✅ SKILL.md exists
|
||||
- ✅ Frontmatter is valid
|
||||
- ✅ Name matches folder name
|
||||
- ✅ Description exists
|
||||
|
||||
---
|
||||
|
||||
## Learning & Best Practices
|
||||
|
||||
### Which skills should I try first?
|
||||
|
||||
**For beginners:**
|
||||
- `@brainstorming` - Design before coding
|
||||
- `@systematic-debugging` - Fix bugs methodically
|
||||
- `@git-pushing` - Commit with good messages
|
||||
|
||||
**For developers:**
|
||||
- `@test-driven-development` - Write tests first
|
||||
- `@react-best-practices` - Modern React patterns
|
||||
- `@senior-fullstack` - Full-stack development
|
||||
|
||||
**For security:**
|
||||
- `@ethical-hacking-methodology` - Security basics
|
||||
- `@burp-suite-testing` - Web app testing
|
||||
|
||||
---
|
||||
|
||||
### How do I learn to write good skills?
|
||||
|
||||
**Learning path:**
|
||||
|
||||
1. **Read existing skills** - Study 5-10 well-written skills
|
||||
2. **Use skills** - Try them with your AI assistant
|
||||
3. **Read guides** - Check [SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md)
|
||||
4. **Start simple** - Create a basic skill first
|
||||
5. **Get feedback** - Submit and learn from reviews
|
||||
6. **Iterate** - Improve based on feedback
|
||||
|
||||
**Recommended skills to study:**
|
||||
- `skills/brainstorming/SKILL.md` - Clear structure
|
||||
- `skills/systematic-debugging/SKILL.md` - Comprehensive
|
||||
- `skills/git-pushing/SKILL.md` - Simple and focused
|
||||
|
||||
---
|
||||
|
||||
### Are there any skills for learning AI/ML?
|
||||
|
||||
**Yes!** Check out:
|
||||
- `@rag-engineer` - RAG systems
|
||||
- `@prompt-engineering` - Prompt design
|
||||
- `@langgraph` - Multi-agent systems
|
||||
- `@ai-agents-architect` - Agent architecture
|
||||
- `@llm-app-patterns` - LLM application patterns
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### My AI assistant doesn't recognize skills
|
||||
|
||||
**Possible causes:**
|
||||
|
||||
1. **Wrong installation path**
|
||||
- Check your tool's documentation for the correct path
|
||||
- Try `.agent/skills/` as the universal path
|
||||
|
||||
2. **Skill name typo**
|
||||
- Verify the exact skill name: `ls .agent/skills/`
|
||||
- Use the exact name from the folder
|
||||
|
||||
3. **Tool doesn't support skills**
|
||||
- Verify your tool supports the SKILL.md format
|
||||
- Check the [Compatibility](#-compatibility) section
|
||||
|
||||
4. **Need to restart**
|
||||
- Restart your AI assistant after installing skills
|
||||
|
||||
---
|
||||
|
||||
### A skill gives incorrect or outdated advice
|
||||
|
||||
**Please report it!**
|
||||
|
||||
1. [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues)
|
||||
2. Include:
|
||||
- Which skill
|
||||
- What's incorrect
|
||||
- What should it say instead
|
||||
- Links to correct documentation
|
||||
|
||||
We'll update it quickly!
|
||||
|
||||
---
|
||||
|
||||
### Can I modify skills for my own use?
|
||||
|
||||
**Yes!** The MIT License allows you to:
|
||||
- ✅ Modify skills for your needs
|
||||
- ✅ Create private versions
|
||||
- ✅ Customize for your team
|
||||
|
||||
**To modify:**
|
||||
1. Copy the skill to a new location
|
||||
2. Edit the SKILL.md file
|
||||
3. Use your modified version
|
||||
|
||||
**Consider contributing improvements back!**
|
||||
|
||||
---
|
||||
|
||||
## Statistics & Info
|
||||
|
||||
### How many skills are there?
|
||||
|
||||
**179 skills** across 10+ categories as of the latest update.
|
||||
|
||||
---
|
||||
|
||||
### How often are skills updated?
|
||||
|
||||
- **Bug fixes**: As soon as reported
|
||||
- **New skills**: Added regularly by contributors
|
||||
- **Updates**: When best practices change
|
||||
|
||||
**Stay updated:**
|
||||
```bash
|
||||
cd .agent/skills
|
||||
git pull origin main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Who maintains this repository?
|
||||
|
||||
This is a community-driven project with contributions from:
|
||||
- Original creators
|
||||
- Open source contributors
|
||||
- AI coding assistant users worldwide
|
||||
|
||||
See [Credits & Sources](README.md#credits--sources) for attribution.
|
||||
|
||||
---
|
||||
|
||||
## Still Have Questions?
|
||||
|
||||
### Where can I get help?
|
||||
|
||||
- **[GitHub Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions)** - Ask questions
|
||||
- **[GitHub Issues](https://github.com/sickn33/antigravity-awesome-skills/issues)** - Report bugs
|
||||
- **Documentation** - Read the guides in this repo
|
||||
- **Community** - Connect with other users
|
||||
|
||||
---
|
||||
|
||||
### How can I stay updated?
|
||||
|
||||
- **Star the repository** on GitHub
|
||||
- **Watch the repository** for updates
|
||||
- **Subscribe to releases** for notifications
|
||||
- **Follow contributors** on social media
|
||||
|
||||
---
|
||||
|
||||
### Can I use these skills commercially?
|
||||
|
||||
**Yes!** The MIT License permits commercial use. You can:
|
||||
- ✅ Use in commercial projects
|
||||
- ✅ Use in client work
|
||||
- ✅ Include in paid products
|
||||
- ✅ Modify for commercial purposes
|
||||
|
||||
**Only requirement:** Keep the license notice.
|
||||
|
||||
---
|
||||
|
||||
## 💡 Pro Tips
|
||||
|
||||
- Start with `@brainstorming` before building anything new
|
||||
- Use `@systematic-debugging` when stuck on bugs
|
||||
- Try `@test-driven-development` for better code quality
|
||||
- Explore `@skill-creator` to make your own skills
|
||||
- Read skill descriptions to understand when to use them
|
||||
|
||||
---
|
||||
|
||||
**Question not answered?**
|
||||
|
||||
[Open a discussion](https://github.com/sickn33/antigravity-awesome-skills/discussions) and we'll help you out! 🙌
|
||||
This document moved to [`docs/users/faq.md`](docs/users/faq.md).
|
||||
|
||||
@@ -1,201 +1,3 @@
|
||||
# Getting Started with Antigravity Awesome Skills
|
||||
# Getting Started
|
||||
|
||||
**New here? This guide will help you understand and use this repository in 5 minutes!**
|
||||
|
||||
---
|
||||
|
||||
## 🤔 What Are "Skills"?
|
||||
|
||||
Think of skills as **specialized instruction manuals** for AI coding assistants.
|
||||
|
||||
**Simple analogy:** Just like you might hire different experts (a designer, a security expert, a marketer), these skills let your AI assistant become an expert in specific areas when you need them.
|
||||
|
||||
---
|
||||
|
||||
## 📦 What's Inside This Repository?
|
||||
|
||||
This repo contains **179 ready-to-use skills** organized in the `skills/` folder. Each skill is a folder with at least one file: `SKILL.md`
|
||||
|
||||
```
|
||||
skills/
|
||||
├── brainstorming/
|
||||
│ └── SKILL.md ← The skill definition
|
||||
├── stripe-integration/
|
||||
│ └── SKILL.md
|
||||
├── react-best-practices/
|
||||
│ └── SKILL.md
|
||||
└── ... (176 more skills)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## How Do Skills Work?
|
||||
|
||||
### Step 1: Install Skills
|
||||
Copy the skills to your AI tool's directory:
|
||||
|
||||
```bash
|
||||
# For most AI tools (Claude Code, Gemini CLI, etc.)
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
### Step 2: Use a Skill
|
||||
In your AI chat, mention the skill:
|
||||
|
||||
```
|
||||
@brainstorming help me design a todo app
|
||||
```
|
||||
|
||||
or
|
||||
|
||||
```
|
||||
/stripe-integration add payment processing to my app
|
||||
```
|
||||
|
||||
### Step 3: The AI Becomes an Expert
|
||||
The AI loads that skill's knowledge and helps you with specialized expertise!
|
||||
|
||||
---
|
||||
|
||||
## Which AI Tools Work With This?
|
||||
|
||||
| Tool | Works? | Installation Path |
|
||||
|------|--------|-------------------|
|
||||
| **Claude Code** | ✅ Yes | `.claude/skills/` or `.agent/skills/` |
|
||||
| **Gemini CLI** | ✅ Yes | `.gemini/skills/` or `.agent/skills/` |
|
||||
| **Cursor** | ✅ Yes | `.cursor/skills/` |
|
||||
| **GitHub Copilot** | ⚠️ Partial | Copy to `.github/copilot/` |
|
||||
| **Antigravity IDE** | ✅ Yes | `.agent/skills/` |
|
||||
|
||||
---
|
||||
|
||||
## Skill Categories (Simplified)
|
||||
|
||||
### **Creative & Design** (10 skills)
|
||||
Make beautiful things: UI design, art, themes, web components
|
||||
- Try: `@frontend-design`, `@canvas-design`, `@ui-ux-pro-max`
|
||||
|
||||
### **Development** (25 skills)
|
||||
Write better code: testing, debugging, React patterns, architecture
|
||||
- Try: `@test-driven-development`, `@systematic-debugging`, `@react-best-practices`
|
||||
|
||||
### **Security** (50 skills)
|
||||
Ethical hacking and penetration testing tools
|
||||
- Try: `@ethical-hacking-methodology`, `@burp-suite-testing`
|
||||
|
||||
### **AI & Agents** (30 skills)
|
||||
Build AI apps: RAG, LangGraph, prompt engineering, voice agents
|
||||
- Try: `@rag-engineer`, `@prompt-engineering`, `@langgraph`
|
||||
|
||||
### **Documents** (4 skills)
|
||||
Work with Word, Excel, PowerPoint, PDF files
|
||||
- Try: `@docx-official`, `@xlsx-official`, `@pdf-official`
|
||||
|
||||
### **Marketing** (23 skills)
|
||||
Grow your product: SEO, copywriting, ads, email campaigns
|
||||
- Try: `@copywriting`, `@seo-audit`, `@page-cro`
|
||||
|
||||
### **Integrations** (25 skills)
|
||||
Connect to services: Stripe, Firebase, Twilio, Discord, Slack
|
||||
- Try: `@stripe-integration`, `@firebase`, `@clerk-auth`
|
||||
|
||||
---
|
||||
|
||||
## Your First Skill: A Quick Example
|
||||
|
||||
Let's try the **brainstorming** skill:
|
||||
|
||||
1. **Open your AI assistant** (Claude Code, Cursor, etc.)
|
||||
|
||||
2. **Type this:**
|
||||
```
|
||||
@brainstorming I want to build a simple weather app
|
||||
```
|
||||
|
||||
3. **What happens:**
|
||||
- The AI loads the brainstorming skill
|
||||
- It asks you questions one at a time
|
||||
- It helps you design the app before coding
|
||||
- It creates a design document for you
|
||||
|
||||
4. **Result:** You get a well-thought-out plan instead of jumping straight to code!
|
||||
|
||||
---
|
||||
|
||||
## How to Find the Right Skill
|
||||
|
||||
### Method 1: Browse by Category
|
||||
Check the [Full Skill Registry](README.md#full-skill-registry-179179) in the main README
|
||||
|
||||
### Method 2: Search by Keyword
|
||||
Use your file explorer or terminal:
|
||||
```bash
|
||||
# Find skills related to "testing"
|
||||
ls skills/ | grep test
|
||||
|
||||
# Find skills related to "auth"
|
||||
ls skills/ | grep auth
|
||||
```
|
||||
|
||||
### Method 3: Look at the Index
|
||||
Check `skills_index.json` for a machine-readable list
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Want to Contribute?
|
||||
|
||||
Great! Here's how:
|
||||
|
||||
### Option 1: Improve Documentation
|
||||
- Make READMEs clearer
|
||||
- Add more examples
|
||||
- Fix typos or confusing parts
|
||||
|
||||
### Option 2: Create a New Skill
|
||||
See our [CONTRIBUTING_GUIDE.md](CONTRIBUTING_GUIDE.md) for step-by-step instructions
|
||||
|
||||
### Option 3: Report Issues
|
||||
Found something confusing? [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues)
|
||||
|
||||
---
|
||||
|
||||
## ❓ Common Questions
|
||||
|
||||
### Q: Do I need to install all 179 skills?
|
||||
**A:** No! Clone the whole repo, and your AI will only load skills when you use them.
|
||||
|
||||
### Q: Can I create my own skills?
|
||||
**A:** Yes! Check out the `@skill-creator` skill or read [CONTRIBUTING_GUIDE.md](CONTRIBUTING_GUIDE.md)
|
||||
|
||||
### Q: What if my AI tool isn't listed?
|
||||
**A:** If it supports the `SKILL.md` format, try `.agent/skills/` - it's the universal path.
|
||||
|
||||
### Q: Are these skills free?
|
||||
**A:** Yes! MIT License. Use them however you want.
|
||||
|
||||
### Q: Do skills work offline?
|
||||
**A:** The skill files are local, but your AI assistant needs internet to function.
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. ✅ Install the skills in your AI tool
|
||||
2. ✅ Try 2-3 skills from different categories
|
||||
3. ✅ Read [CONTRIBUTING_GUIDE.md](CONTRIBUTING_GUIDE.md) if you want to help
|
||||
4. ✅ Star the repo if you find it useful! ⭐
|
||||
|
||||
---
|
||||
|
||||
## 💡 Pro Tips
|
||||
|
||||
- **Start with `@brainstorming`** before building anything new
|
||||
- **Use `@systematic-debugging`** when you're stuck on a bug
|
||||
- **Try `@test-driven-development`** to write better code
|
||||
- **Explore `@skill-creator`** to make your own skills
|
||||
|
||||
---
|
||||
|
||||
**Still confused?** Open an issue and we'll help you out! 🙌
|
||||
|
||||
**Ready to dive deeper?** Check out the main [README.md](README.md) for the complete skill list.
|
||||
This document moved to [`docs/users/getting-started.md`](docs/users/getting-started.md).
|
||||
|
||||
536
README.md
536
README.md
@@ -1,453 +1,151 @@
|
||||
# 🌌 Antigravity Awesome Skills: 1,200+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More
|
||||
<!-- registry-sync: version=7.0.0; skills=1204; stars=20731; updated_at=2026-03-06T10:20:13+00:00 -->
|
||||
# 🌌 Antigravity Awesome Skills: 1,204+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More
|
||||
|
||||
> **The Ultimate Collection of 1,200+ Universal Agentic Skills for AI Coding Assistants — Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL**
|
||||
|
||||
[](https://github.com/sickn33/antigravity-awesome-skills/stargazers)
|
||||
> **The Ultimate Collection of 1,204+ Universal Agentic Skills for AI Coding Assistants — Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL**
|
||||
|
||||
[](https://github.com/sickn33/antigravity-awesome-skills/stargazers)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://claude.ai)
|
||||
[](https://github.com/google-gemini/gemini-cli)
|
||||
[](https://github.com/openai/codex)
|
||||
[](https://kiro.dev)
|
||||
[](https://cursor.sh)
|
||||
[](https://github.com/features/copilot)
|
||||
[](https://github.com/opencode-ai/opencode)
|
||||
[](https://github.com/sickn33/antigravity-awesome-skills)
|
||||
[](https://sylph.ai/)
|
||||
[](https://github.com/yeasy/ask)
|
||||
[](https://buymeacoffee.com/sickn33)
|
||||
[](apps/web-app)
|
||||
|
||||
If this project helps you, you can [support it here](https://buymeacoffee.com/sickn33) or simply ⭐ the repo.
|
||||
**Antigravity Awesome Skills** is a curated, battle-tested library of **1,204+ high-performance agentic skills** designed to work seamlessly across the major AI coding assistants.
|
||||
|
||||
**Antigravity Awesome Skills** is a curated, battle-tested library of **1,200+ high-performance agentic skills** designed to work seamlessly across all major AI coding assistants:
|
||||
**Welcome to the V7.0.0 21k Stars Celebration Release!** This repository gives your agent reusable playbooks for planning, coding, debugging, testing, security review, infrastructure work, product thinking, and much more.
|
||||
|
||||
- 🟣 **Claude Code** (Anthropic CLI)
|
||||
- 🔵 **Gemini CLI** (Google DeepMind)
|
||||
- 🟢 **Codex CLI** (OpenAI)
|
||||
- 🟠 **Kiro CLI** (AWS)
|
||||
- 🟠 **Kiro IDE** (AWS)
|
||||
- 🔴 **Antigravity IDE** (Google DeepMind)
|
||||
- 🩵 **GitHub Copilot** (VSCode Extension)
|
||||
- 🟠 **Cursor** (AI-native IDE)
|
||||
- ⚪ **OpenCode** (Open-source CLI)
|
||||
- 🌸 **AdaL CLI** (Self-evolving Coding Agent)
|
||||
> **🌟 21,000+ GitHub Stars Milestone!** Thank you to the community for turning this into one of the largest skill libraries in this category.
|
||||
|
||||
This repository provides essential skills to transform your AI assistant into a **full-stack digital agency**, including official capabilities from **Anthropic**, **OpenAI**, **Google**, **Microsoft**, **Supabase**, **Apify**, and **Vercel Labs**.
|
||||
## Quick Start
|
||||
|
||||
## Table of Contents
|
||||
|
||||
- [🚀 New Here? Start Here!](#new-here-start-here)
|
||||
- [📖 Complete Usage Guide](docs/USAGE.md) - **Start here if confused after installation!**
|
||||
- [🔌 Compatibility & Invocation](#compatibility--invocation)
|
||||
- [🛠️ Installation](#installation)
|
||||
- [🧯 Troubleshooting](#troubleshooting)
|
||||
- [🎁 Curated Collections (Bundles)](#curated-collections)
|
||||
- [🧭 Antigravity Workflows](#antigravity-workflows)
|
||||
- [📦 Features & Categories](#features--categories)
|
||||
- [📚 Browse 1,200+ Skills](#browse-1200-skills)
|
||||
- [🤝 How to Contribute](#how-to-contribute)
|
||||
- [💬 Community](#community)
|
||||
- [☕ Support the Project](#support-the-project)
|
||||
- [🏆 Credits & Sources](#credits--sources)
|
||||
- [👥 Repo Contributors](#repo-contributors)
|
||||
- [⚖️ License](#license)
|
||||
- [🌟 Star History](#star-history)
|
||||
|
||||
---
|
||||
|
||||
## New Here? Start Here!
|
||||
|
||||
**Welcome to the V7.0.0 20k Stars Celebration Release!** 🎉 This isn't just a list of scripts; it's a complete operating system for your AI Agent.
|
||||
|
||||
> **🌟 20,000+ GitHub Stars Milestone!** Thank you to our incredible community for making this the most comprehensive agentic skills collection ever created.
|
||||
|
||||
### 1. 🐣 Context: What is this?
|
||||
|
||||
**Antigravity Awesome Skills** (Release 7.0.0) is a massive upgrade to your AI's capabilities, now featuring **1,200+ skills** from 35+ community repositories.
|
||||
|
||||
AI Agents (like Claude Code, Cursor, or Gemini) are smart, but they lack **specific tools**. They don't know your company's "Deployment Protocol" or the specific syntax for "AWS CloudFormation".
|
||||
**Skills** are small markdown files that teach them how to do these specific tasks perfectly, every time.
|
||||
|
||||
### 2. ⚡️ Quick Start (1 minute)
|
||||
|
||||
Install once; then use Starter Packs in [docs/BUNDLES.md](docs/BUNDLES.md) to focus on your role.
|
||||
|
||||
1. **Install**:
|
||||
|
||||
```bash
|
||||
# Default: ~/.gemini/antigravity/skills (Antigravity global). Use --path for other locations.
|
||||
npx antigravity-awesome-skills
|
||||
```
|
||||
|
||||
2. **Verify**:
|
||||
|
||||
```bash
|
||||
test -d ~/.gemini/antigravity/skills && echo "Skills installed in ~/.gemini/antigravity/skills"
|
||||
```
|
||||
|
||||
3. **Run your first skill**:
|
||||
|
||||
> "Use **@brainstorming** to plan a SaaS MVP."
|
||||
|
||||
4. **Pick a bundle**:
|
||||
- **Web Dev?** start with `Web Wizard`.
|
||||
- **Security?** start with `Security Engineer`.
|
||||
- **General use?** start with `Essentials`.
|
||||
|
||||
### 3. 🧠 How to use
|
||||
|
||||
Once installed, just ask your agent naturally:
|
||||
|
||||
> "Use the **@brainstorming** skill to help me plan a SaaS."
|
||||
> "Run **@lint-and-validate** on this file."
|
||||
|
||||
👉 **NEW:** [**Complete Usage Guide - Read This First!**](docs/USAGE.md) (answers: "What do I do after installation?", "How do I execute skills?", "What should prompts look like?")
|
||||
|
||||
👉 **[Full Getting Started Guide](docs/GETTING_STARTED.md)**
|
||||
|
||||
---
|
||||
|
||||
## Compatibility & Invocation
|
||||
|
||||
These skills follow the universal **SKILL.md** format and work with any AI coding assistant that supports agentic skills.
|
||||
|
||||
| Tool | Type | Invocation Example | Path |
|
||||
| :-------------- | :--- | :-------------------------------- | :-------------------------------------------------------------------- |
|
||||
| **Claude Code** | CLI | `>> /skill-name help me...` | `.claude/skills/` |
|
||||
| **Gemini CLI** | CLI | `(User Prompt) Use skill-name...` | `.gemini/skills/` |
|
||||
| **Codex CLI** | CLI | `(User Prompt) Use skill-name...` | `.codex/skills/` |
|
||||
| **Kiro CLI** | CLI | `(Auto) Skills load on-demand` | Global: `~/.kiro/skills/` · Workspace: `.kiro/skills/` |
|
||||
| **Kiro IDE** | IDE | `/skill-name or (Auto)` | Global: `~/.kiro/skills/` · Workspace: `.kiro/skills/` |
|
||||
| **Antigravity** | IDE | `(Agent Mode) Use skill...` | Global: `~/.gemini/antigravity/skills/` · Workspace: `.agent/skills/` |
|
||||
| **Cursor** | IDE | `@skill-name (in Chat)` | `.cursor/skills/` |
|
||||
| **Copilot** | Ext | `(Paste content manually)` | N/A |
|
||||
| **OpenCode** | CLI | `opencode run @skill-name` | `.agents/skills/` |
|
||||
| **AdaL CLI** | CLI | `(Auto) Skills load on-demand` | `.adal/skills/` |
|
||||
|
||||
> [!TIP]
|
||||
> **Default installer path**: `~/.gemini/antigravity/skills` (Antigravity global). Use `--path ~/.agent/skills` for workspace-specific install. For manual clone, `.agent/skills/` works as workspace path for Antigravity.
|
||||
> **OpenCode Path Update**: opencode path is changed to `.agents/skills` for global skills. See [Place Files](https://opencode.ai/docs/skills/#place-files) directive on OpenCode Docs.
|
||||
|
||||
> [!WARNING]
|
||||
> **Windows Users**: this repository uses **symlinks** for official skills.
|
||||
> See [Troubleshooting](#troubleshooting) for the exact fix.
|
||||
|
||||
---
|
||||
|
||||
## Installation
|
||||
|
||||
To use these skills with **Claude Code**, **Gemini CLI**, **Codex CLI**, **Kiro CLI**, **Kiro IDE**, **Cursor**, **Antigravity**, **OpenCode**, or **AdaL**:
|
||||
|
||||
### Option A: npx (recommended)
|
||||
1. Install once:
|
||||
|
||||
```bash
|
||||
# Default: ~/.gemini/antigravity/skills (Antigravity global)
|
||||
npx antigravity-awesome-skills
|
||||
|
||||
# Antigravity (explicit; same as default)
|
||||
npx antigravity-awesome-skills --antigravity
|
||||
|
||||
# Kiro CLI/IDE (global)
|
||||
npx antigravity-awesome-skills --path ~/.kiro/skills
|
||||
|
||||
# Kiro CLI/IDE (workspace)
|
||||
npx antigravity-awesome-skills --path .kiro/skills
|
||||
|
||||
# Cursor
|
||||
npx antigravity-awesome-skills --cursor
|
||||
|
||||
# Claude Code
|
||||
npx antigravity-awesome-skills --claude
|
||||
|
||||
# Gemini CLI
|
||||
npx antigravity-awesome-skills --gemini
|
||||
|
||||
# Codex CLI
|
||||
npx antigravity-awesome-skills --codex
|
||||
|
||||
# Kiro CLI
|
||||
npx antigravity-awesome-skills --kiro
|
||||
|
||||
# OpenCode
|
||||
npx antigravity-awesome-skills --path .agents/skills
|
||||
|
||||
# AdaL CLI
|
||||
npx antigravity-awesome-skills --path .adal/skills
|
||||
|
||||
# Workspace-specific (e.g. .agent/skills for Antigravity workspace)
|
||||
npx antigravity-awesome-skills --path ~/.agent/skills
|
||||
|
||||
# Custom path
|
||||
npx antigravity-awesome-skills --path ./my-skills
|
||||
```
|
||||
|
||||
Run `npx antigravity-awesome-skills --help` for all options. If the directory already exists, the installer runs `git pull` to update.
|
||||
|
||||
### Option B: git clone
|
||||
|
||||
Without `--path`, the npx installer uses `~/.gemini/antigravity/skills`. For manual clone or a different path (e.g. workspace `.agent/skills`), use one of the following:
|
||||
|
||||
```bash
|
||||
# Antigravity global (matches npx default)
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.gemini/antigravity/skills
|
||||
|
||||
# Workspace-specific (e.g. .agent/skills in your project)
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
|
||||
# Kiro CLI/IDE global
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.kiro/skills
|
||||
|
||||
# Claude Code specific
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .claude/skills
|
||||
|
||||
# Gemini CLI specific
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .gemini/skills
|
||||
|
||||
# Codex CLI specific
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .codex/skills
|
||||
|
||||
# Cursor specific
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .cursor/skills
|
||||
|
||||
# OpenCode
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agents/skills
|
||||
|
||||
# AdaL CLI specific
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .adal/skills
|
||||
```
|
||||
|
||||
### Option C: Kiro IDE Import (GUI)
|
||||
|
||||
For Kiro IDE users, you can import individual skills directly:
|
||||
|
||||
1. Open **Agent Steering & Skills** panel in Kiro IDE
|
||||
2. Click **+** → **Import a skill** → **GitHub**
|
||||
3. Paste skill URL: `https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/[skill-name]`
|
||||
4. Example: `https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aws-cost-optimizer`
|
||||
|
||||
> **Note**: This imports one skill at a time. For bulk installation, use Option A or B above.
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### `npx antigravity-awesome-skills` returns 404
|
||||
|
||||
Use the GitHub package fallback:
|
||||
|
||||
```bash
|
||||
npx github:sickn33/antigravity-awesome-skills
|
||||
```
|
||||
|
||||
### Windows clone issues (symlinks)
|
||||
|
||||
This repository uses symlinks for official skills. Enable Developer Mode or run Git as Administrator, then clone with:
|
||||
|
||||
```bash
|
||||
git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
### Skills installed but not detected by your tool
|
||||
|
||||
Install to the tool-specific path. Use installer flags: `--antigravity` (default), `--claude`, `--gemini`, `--codex`, `--cursor`, or `--path <dir>` for a custom location (e.g. `~/.agent/skills` for Antigravity workspace).
|
||||
|
||||
### Update an existing installation
|
||||
|
||||
**Good news!** You no longer need to manually run `git pull` or `npx antigravity-awesome-skills` to update your skills.
|
||||
|
||||
- **Windows:** Double-click **`START_APP.bat`** (or run it in your terminal).
|
||||
- **macOS/Linux:** Run `cd web-app && npm run app:dev` from the repo root.
|
||||
|
||||
Both methods automatically fetch and merge the latest skills from the original repository every time you open the Web App, ensuring you always have the most up-to-date catalog.
|
||||
|
||||
### Reinstall from scratch
|
||||
|
||||
```bash
|
||||
rm -rf ~/.gemini/antigravity/skills
|
||||
npx antigravity-awesome-skills
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Curated Collections
|
||||
|
||||
**Bundles** are curated groups of skills for a specific role or goal (for example: `Web Wizard`, `Security Engineer`, `OSS Maintainer`).
|
||||
|
||||
They help you avoid picking from 1006+ skills one by one.
|
||||
|
||||
### ⚠️ Important: Bundles Are NOT Separate Installations!
|
||||
|
||||
**Common confusion:** "Do I need to install each bundle separately?"
|
||||
|
||||
**Answer: NO!** Here's what bundles actually are:
|
||||
|
||||
**What bundles ARE:**
|
||||
|
||||
- ✅ Recommended skill lists organized by role
|
||||
- ✅ Curated starting points to help you decide what to use
|
||||
- ✅ Time-saving shortcuts for discovering relevant skills
|
||||
|
||||
**What bundles are NOT:**
|
||||
|
||||
- ❌ Separate installations or downloads
|
||||
- ❌ Different git commands
|
||||
- ❌ Something you need to "activate"
|
||||
|
||||
### How to use bundles:
|
||||
|
||||
1. **Install the repository once** (you already have all skills)
|
||||
2. **Browse bundles** in [docs/BUNDLES.md](docs/BUNDLES.md) to find your role
|
||||
3. **Pick 3-5 skills** from that bundle to start using in your prompts
|
||||
4. **Reference them in your conversations** with your AI (e.g., "Use @brainstorming...")
|
||||
|
||||
For detailed examples of how to actually use skills, see the [**Usage Guide**](docs/USAGE.md).
|
||||
|
||||
### Examples:
|
||||
|
||||
- Building a SaaS MVP: `Essentials` + `Full-Stack Developer` + `QA & Testing`.
|
||||
- Hardening production: `Security Developer` + `DevOps & Cloud` + `Observability & Monitoring`.
|
||||
- Shipping OSS changes: `Essentials` + `OSS Maintainer`.
|
||||
|
||||
## Antigravity Workflows
|
||||
|
||||
Bundles help you choose skills. Workflows help you execute them in order.
|
||||
|
||||
- Use bundles when you need curated recommendations by role.
|
||||
- Use workflows when you need step-by-step execution for a concrete goal.
|
||||
|
||||
Start here:
|
||||
|
||||
- [docs/WORKFLOWS.md](docs/WORKFLOWS.md): human-readable playbooks.
|
||||
- [data/workflows.json](data/workflows.json): machine-readable workflow metadata.
|
||||
|
||||
Initial workflows include:
|
||||
|
||||
- Ship a SaaS MVP
|
||||
- Security Audit for a Web App
|
||||
- Build an AI Agent System
|
||||
- QA and Browser Automation (with optional `@go-playwright` support for Go stacks)
|
||||
|
||||
## Features & Categories
|
||||
|
||||
The repository is organized into specialized domains to transform your AI into an expert across the entire software development lifecycle:
|
||||
|
||||
| Category | Focus | Example skills |
|
||||
| :------------- | :------------------------------------------------- | :------------------------------------------------------------------------------ |
|
||||
| Architecture | System design, ADRs, C4, and scalable patterns | `architecture`, `c4-context`, `senior-architect` |
|
||||
| Business | Growth, pricing, CRO, SEO, and go-to-market | `copywriting`, `pricing-strategy`, `seo-audit` |
|
||||
| Data & AI | LLM apps, RAG, agents, observability, analytics | `rag-engineer`, `prompt-engineer`, `langgraph` |
|
||||
| Development | Language mastery, framework patterns, code quality | `typescript-expert`, `python-patterns`, `react-patterns` |
|
||||
| General | Planning, docs, product ops, writing, guidelines | `brainstorming`, `doc-coauthoring`, `writing-plans` |
|
||||
| Infrastructure | DevOps, cloud, serverless, deployment, CI/CD | `docker-expert`, `aws-serverless`, `vercel-deployment` |
|
||||
| Security | AppSec, pentesting, vuln analysis, compliance | `api-security-best-practices`, `sql-injection-testing`, `vulnerability-scanner` |
|
||||
| Testing | TDD, test design, fixes, QA workflows | `test-driven-development`, `testing-patterns`, `test-fixing` |
|
||||
| Workflow | Automation, orchestration, jobs, agents | `workflow-automation`, `inngest`, `trigger-dev` |
|
||||
|
||||
Counts change as new skills are added. For the current full registry, see [CATALOG.md](CATALOG.md).
|
||||
|
||||
## Browse 1,200+ Skills
|
||||
|
||||
We have moved the full skill registry to a dedicated catalog to keep this README clean, and we've also introduced an interactive **Web App**!
|
||||
|
||||
### 🌐 Interactive Skills Web App
|
||||
|
||||
A modern web interface to explore, search, and use the 1,200+ skills directly from your browser.
|
||||
|
||||
#### ✨ Features
|
||||
|
||||
- 🔍 **Full-text search** – Search skills by name, description, or content
|
||||
- 🏷️ **Category filters** – Frontend, Backend, Security, DevOps, etc.
|
||||
- 📝 **Markdown rendering** – View complete documentation with syntax highlighting
|
||||
- 📋 **Copy buttons** – Copy `@skill-name` or full content in 1 click
|
||||
- 🛠️ **Prompt Builder** – Add custom context before copying
|
||||
- 🌙 **Dark mode** – Adaptive light/dark interface
|
||||
- ⚡ **Auto-update** – Automatically syncs with upstream repo
|
||||
|
||||
#### 🚀 Quick Start
|
||||
|
||||
**Windows:**
|
||||
2. Verify the default install:
|
||||
|
||||
```bash
|
||||
# Double-click or terminal
|
||||
START_APP.bat
|
||||
test -d ~/.gemini/antigravity/skills && echo "Skills installed"
|
||||
```
|
||||
|
||||
**macOS/Linux:**
|
||||
3. Use your first skill:
|
||||
|
||||
```text
|
||||
Use @brainstorming to plan a SaaS MVP.
|
||||
```
|
||||
|
||||
4. Browse starter collections in [`docs/users/bundles.md`](docs/users/bundles.md) and execution playbooks in [`docs/users/workflows.md`](docs/users/workflows.md).
|
||||
|
||||
## Choose Your Tool
|
||||
|
||||
| Tool | Install | First Use |
|
||||
| --- | --- | --- |
|
||||
| Claude Code | `npx antigravity-awesome-skills --claude` | `>> /brainstorming help me plan a feature` |
|
||||
| Cursor | `npx antigravity-awesome-skills --cursor` | `@brainstorming help me plan a feature` |
|
||||
| Gemini CLI | `npx antigravity-awesome-skills --gemini` | `Use brainstorming to plan a feature` |
|
||||
| Codex CLI | `npx antigravity-awesome-skills --codex` | `Use brainstorming to plan a feature` |
|
||||
| Antigravity | `npx antigravity-awesome-skills --antigravity` | `Use @brainstorming to plan a feature` |
|
||||
| Custom path | `npx antigravity-awesome-skills --path ./my-skills` | Depends on your tool |
|
||||
|
||||
## What This Repo Includes
|
||||
|
||||
- **Skills library**: `skills/` contains the reusable `SKILL.md` collection.
|
||||
- **Installer**: the npm CLI installs skills into the right directory for each tool.
|
||||
- **Catalog**: [`CATALOG.md`](CATALOG.md), `skills_index.json`, and `data/` provide generated indexes.
|
||||
- **Web app**: [`apps/web-app`](apps/web-app) gives you search, filters, rendering, and copy helpers.
|
||||
- **Bundles**: [`docs/users/bundles.md`](docs/users/bundles.md) groups starter skills by role.
|
||||
- **Workflows**: [`docs/users/workflows.md`](docs/users/workflows.md) gives step-by-step execution playbooks.
|
||||
|
||||
## Project Structure
|
||||
|
||||
| Path | Purpose |
|
||||
| --- | --- |
|
||||
| `skills/` | The canonical skill library |
|
||||
| `docs/users/` | Getting started, usage, bundles, workflows, visual guides |
|
||||
| `docs/contributors/` | Templates, anatomy, examples, quality bar, community docs |
|
||||
| `docs/maintainers/` | Release, audit, CI drift, metadata maintenance docs |
|
||||
| `docs/sources/` | Attribution and licensing references |
|
||||
| `apps/web-app/` | Interactive browser for the skill catalog |
|
||||
| `tools/` | Installer, validators, generators, and support scripts |
|
||||
| `data/` | Generated catalog, aliases, bundles, and workflows |
|
||||
|
||||
## Top Starter Skills
|
||||
|
||||
- `@brainstorming` for planning before implementation.
|
||||
- `@architecture` for system and component design.
|
||||
- `@test-driven-development` for TDD-oriented work.
|
||||
- `@doc-coauthoring` for structured documentation writing.
|
||||
- `@lint-and-validate` for lightweight quality checks.
|
||||
- `@create-pr` for packaging work into a clean pull request.
|
||||
- `@debugging-strategies` for systematic troubleshooting.
|
||||
- `@api-design-principles` for API shape and consistency.
|
||||
- `@frontend-design` for UI and interaction quality.
|
||||
- `@security-auditor` for security-focused reviews.
|
||||
|
||||
## Three Real Examples
|
||||
|
||||
```text
|
||||
Use @brainstorming to turn this product idea into a concrete MVP plan.
|
||||
```
|
||||
|
||||
```text
|
||||
Use @security-auditor to review this API endpoint for auth and validation risks.
|
||||
```
|
||||
|
||||
```text
|
||||
Use @doc-coauthoring to rewrite our setup guide for first-time contributors.
|
||||
```
|
||||
|
||||
## Browse 1,204+ Skills
|
||||
|
||||
- Open the interactive browser in [`apps/web-app`](apps/web-app).
|
||||
- Read the full catalog in [`CATALOG.md`](CATALOG.md).
|
||||
- Start with role-based bundles in [`docs/users/bundles.md`](docs/users/bundles.md).
|
||||
- Follow outcome-driven workflows in [`docs/users/workflows.md`](docs/users/workflows.md).
|
||||
- Use the onboarding guides in [`docs/users/getting-started.md`](docs/users/getting-started.md) and [`docs/users/usage.md`](docs/users/usage.md).
|
||||
|
||||
## Documentation
|
||||
|
||||
| For Users | For Contributors | For Maintainers |
|
||||
| --- | --- | --- |
|
||||
| [`docs/users/getting-started.md`](docs/users/getting-started.md) | [`CONTRIBUTING.md`](CONTRIBUTING.md) | [`docs/maintainers/release-process.md`](docs/maintainers/release-process.md) |
|
||||
| [`docs/users/usage.md`](docs/users/usage.md) | [`docs/contributors/skill-anatomy.md`](docs/contributors/skill-anatomy.md) | [`docs/maintainers/audit.md`](docs/maintainers/audit.md) |
|
||||
| [`docs/users/faq.md`](docs/users/faq.md) | [`docs/contributors/quality-bar.md`](docs/contributors/quality-bar.md) | [`docs/maintainers/ci-drift-fix.md`](docs/maintainers/ci-drift-fix.md) |
|
||||
| [`docs/users/visual-guide.md`](docs/users/visual-guide.md) | [`docs/contributors/examples.md`](docs/contributors/examples.md) | [`docs/maintainers/skills-update-guide.md`](docs/maintainers/skills-update-guide.md) |
|
||||
|
||||
## Web App
|
||||
|
||||
The web app is the fastest way to navigate a large repository like this.
|
||||
|
||||
```bash
|
||||
# 1. Install dependencies (first time)
|
||||
cd web-app && npm install
|
||||
|
||||
# 2. Setup assets and launch
|
||||
npm run app:install
|
||||
npm run app:dev
|
||||
```
|
||||
|
||||
**Available npm commands:**
|
||||
That will copy the generated skill index into `apps/web-app/public/skills.json`, mirror the current `skills/` tree into `apps/web-app/public/skills/`, and start the Vite development server.
|
||||
|
||||
```bash
|
||||
npm run app:setup # Copy skills to web-app/public/
|
||||
npm run app:dev # Start dev server
|
||||
npm run app:build # Production build
|
||||
npm run app:preview # Preview production build
|
||||
```
|
||||
## Contributing
|
||||
|
||||
The app automatically opens at `http://localhost:5173` (or alternative port).
|
||||
|
||||
#### 🛠️ Interactive Prompt Builder
|
||||
|
||||
On each skill page you'll find the **Interactive Prompt Builder**. Instead of manually copying `@skill-name` and writing your requirements separately in your IDE:
|
||||
|
||||
1. Type your specific project constraints into the text box (e.g., "Use React 19, TypeScript and Tailwind").
|
||||
2. Click **Copy Prompt** — copies a fully formatted, ready-to-run prompt combining `@skill-name` + your custom context.
|
||||
3. Or click **Copy Full Content** — copies the full skill documentation.
|
||||
4. Paste into your AI assistant (Claude, Cursor, Gemini, etc.).
|
||||
|
||||
👉 **[View the Complete Skill Catalog (CATALOG.md)](CATALOG.md)**
|
||||
|
||||
---
|
||||
|
||||
## How to Contribute
|
||||
|
||||
We welcome contributions from the community! To add a new skill:
|
||||
|
||||
1. **Fork** the repository.
|
||||
2. **Create a new directory** inside `skills/` for your skill.
|
||||
3. **Add a `SKILL.md`** with the required frontmatter (name, description, risk, source). See [docs/SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md) and [docs/QUALITY_BAR.md](docs/QUALITY_BAR.md).
|
||||
4. **Add date tracking** (optional): Include `date_added: "YYYY-MM-DD"` in frontmatter. See [docs/SKILLS_DATE_TRACKING.md](docs/SKILLS_DATE_TRACKING.md) for details.
|
||||
5. **Run validation**: `npm run validate` (or `npm run validate:strict` for CI). Optionally run `python3 scripts/validate_references.py` if you touch workflows or bundles.
|
||||
6. **Submit a Pull Request**.
|
||||
|
||||
Please ensure your skill follows the Antigravity/Claude Code best practices. Maintainers: see [docs/AUDIT.md](docs/AUDIT.md) for coherence checks and [.github/MAINTENANCE.md](.github/MAINTENANCE.md) for the full validation chain.
|
||||
|
||||
---
|
||||
- Add new skills under `skills/<skill-name>/SKILL.md`.
|
||||
- Follow the contributor guide in [`CONTRIBUTING.md`](CONTRIBUTING.md).
|
||||
- Use the template in [`docs/contributors/skill-template.md`](docs/contributors/skill-template.md).
|
||||
- Validate with `npm run validate` before opening a PR.
|
||||
|
||||
## Community
|
||||
|
||||
- [Community Guidelines](docs/COMMUNITY_GUIDELINES.md)
|
||||
- [Security Policy](docs/SECURITY_GUARDRAILS.md)
|
||||
|
||||
---
|
||||
- [Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions) for questions and feedback.
|
||||
- [Issues](https://github.com/sickn33/antigravity-awesome-skills/issues) for bugs and improvement requests.
|
||||
- [`SECURITY.md`](SECURITY.md) for security reporting.
|
||||
|
||||
## Support the Project
|
||||
|
||||
Support is optional. This project stays free and open-source for everyone.
|
||||
Support is optional. The project stays free and open-source for everyone.
|
||||
|
||||
If this repository saves you time or helps you ship faster, you can support ongoing maintenance:
|
||||
|
||||
- [☕ Buy me a book on Buy Me a Coffee](https://buymeacoffee.com/sickn33)
|
||||
|
||||
Where support goes:
|
||||
|
||||
- Skill curation, testing, and quality validation.
|
||||
- Documentation updates, examples, and onboarding improvements.
|
||||
- Faster triage and review of community issues and PRs.
|
||||
|
||||
Prefer non-financial support:
|
||||
|
||||
- Star the repository.
|
||||
- Open clear, reproducible issues.
|
||||
- Submit PRs (skills, docs, fixes).
|
||||
- Share the project with other builders.
|
||||
- [Buy me a book on Buy Me a Coffee](https://buymeacoffee.com/sickn33)
|
||||
- Star the repository
|
||||
- Open reproducible issues
|
||||
- Contribute docs, fixes, and skills
|
||||
|
||||
---
|
||||
|
||||
@@ -455,7 +153,7 @@ Prefer non-financial support:
|
||||
|
||||
We stand on the shoulders of giants.
|
||||
|
||||
👉 **[View the Full Attribution Ledger](docs/SOURCES.md)**
|
||||
👉 **[View the Full Attribution Ledger](docs/sources/sources.md)**
|
||||
|
||||
Key contributors and sources include:
|
||||
|
||||
@@ -513,7 +211,7 @@ This collection would not be possible without the incredible work of the Claude
|
||||
- **[f/awesome-chatgpt-prompts](https://github.com/f/awesome-chatgpt-prompts)**: Inspiration for the Prompt Library.
|
||||
- **[leonardomso/33-js-concepts](https://github.com/leonardomso/33-js-concepts)**: Inspiration for JavaScript Mastery.
|
||||
|
||||
---
|
||||
### Additional Sources
|
||||
|
||||
- **[agent-cards/skill](https://github.com/agent-cards/skill)**: Manage prepaid virtual Visa cards for AI agents. Create cards, check balances, view credentials, close cards, and get support via MCP tools.
|
||||
|
||||
|
||||
@@ -15,5 +15,5 @@ If you find a security vulnerability (e.g., a skill that bypasses the "Authorize
|
||||
|
||||
## Offensive Skills Policy
|
||||
|
||||
Please read our [Security Guardrails](docs/SECURITY_GUARDRAILS.md).
|
||||
Please read our [Security Guardrails](docs/contributors/security-guardrails.md).
|
||||
All offensive skills are strictly for **authorized educational and professional use only**.
|
||||
|
||||
@@ -1,89 +1,3 @@
|
||||
# Skills Update Guide
|
||||
|
||||
This guide explains how to update the skills in the Antigravity Awesome Skills web application.
|
||||
|
||||
## Automatic Updates (Recommended)
|
||||
|
||||
The `START_APP.bat` file automatically checks for and updates skills when you run it. It uses multiple methods:
|
||||
|
||||
1. **Git method** (if Git is installed): Fast and efficient
|
||||
2. **PowerShell download** (fallback): Works without Git
|
||||
|
||||
## Manual Update Options
|
||||
|
||||
### Option 1: Using npm script (Recommended for manual updates)
|
||||
```bash
|
||||
npm run update:skills
|
||||
```
|
||||
|
||||
This command:
|
||||
- Generates the latest skills index from the skills directory
|
||||
- Copies it to the web app's public directory
|
||||
- Requires Python and PyYAML to be installed
|
||||
|
||||
### Option 2: Using START_APP.bat (Integrated solution)
|
||||
```bash
|
||||
START_APP.bat
|
||||
```
|
||||
|
||||
The START_APP.bat file includes integrated update functionality that:
|
||||
- Automatically checks for updates on startup
|
||||
- Uses Git if available (fast method)
|
||||
- Falls back to HTTPS download if Git is not installed
|
||||
- Handles all dependencies automatically
|
||||
- Provides clear status messages
|
||||
- Works without any additional setup
|
||||
|
||||
### Option 3: Manual steps
|
||||
```bash
|
||||
# 1. Generate skills index
|
||||
python scripts/generate_index.py
|
||||
|
||||
# 2. Copy to web app
|
||||
copy skills_index.json web-app\public\skills.json
|
||||
```
|
||||
|
||||
## Prerequisites
|
||||
|
||||
For manual updates, you need:
|
||||
|
||||
- **Python 3.x**: Download from [python.org](https://python.org/)
|
||||
- **PyYAML**: Install with `pip install PyYAML`
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Python is not recognized"
|
||||
- Install Python from [python.org](https://python.org/)
|
||||
- Make sure to check "Add Python to PATH" during installation
|
||||
|
||||
### "PyYAML not found"
|
||||
- Install with: `pip install PyYAML`
|
||||
- Or run the update script which will install it automatically
|
||||
|
||||
### "Failed to copy skills"
|
||||
- Make sure the `web-app\public\` directory exists
|
||||
- Check file permissions
|
||||
|
||||
## What Gets Updated
|
||||
|
||||
The update process refreshes:
|
||||
- Skills index (`skills_index.json`)
|
||||
- Web app skills data (`web-app\public\skills.json`)
|
||||
- All 900+ skills from the skills directory
|
||||
|
||||
## When to Update
|
||||
|
||||
Update skills when:
|
||||
- New skills are added to the repository
|
||||
- You want the latest skill descriptions
|
||||
- Skills appear missing or outdated in the web app
|
||||
|
||||
## Git Users
|
||||
|
||||
If you have Git installed and want to update the entire repository:
|
||||
```bash
|
||||
git pull origin main
|
||||
npm run update:skills
|
||||
```
|
||||
|
||||
This pulls the latest code and updates the skills data.
|
||||
This document moved to [`docs/maintainers/skills-update-guide.md`](docs/maintainers/skills-update-guide.md).
|
||||
|
||||
@@ -15,7 +15,7 @@ IF %ERRORLEVEL% NEQ 0 (
|
||||
)
|
||||
|
||||
:: Check/Install dependencies
|
||||
cd web-app
|
||||
cd apps\web-app
|
||||
|
||||
if not exist "node_modules\" (
|
||||
echo [INFO] Dependencies not found. Installing...
|
||||
@@ -43,7 +43,7 @@ if %ERRORLEVEL% NEQ 0 (
|
||||
)
|
||||
|
||||
:DEPS_OK
|
||||
cd ..
|
||||
cd ..\..
|
||||
|
||||
:: Run setup script
|
||||
echo [INFO] Updating skills data...
|
||||
@@ -53,7 +53,7 @@ call npm run app:setup
|
||||
echo [INFO] Starting Web App...
|
||||
echo [INFO] Opening default browser...
|
||||
echo [INFO] Use the Sync Skills button in the app to update skills from GitHub!
|
||||
cd web-app
|
||||
cd apps\web-app
|
||||
call npx -y vite --open
|
||||
|
||||
endlocal
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
"path": "skills/00-andruia-consultant",
|
||||
"category": "andruia",
|
||||
"name": "00-andruia-consultant",
|
||||
"description": "Arquitecto de Soluciones Principal y Consultor Tecnol\u00f3gico de Andru.ia. Diagnostica y traza la hoja de ruta \u00f3ptima para proyectos de IA en espa\u00f1ol.",
|
||||
"description": "Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.",
|
||||
"risk": "safe",
|
||||
"source": "personal",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -14,7 +14,7 @@
|
||||
"path": "skills/10-andruia-skill-smith",
|
||||
"category": "andruia",
|
||||
"name": "10-andruia-skill-smith",
|
||||
"description": "Ingeniero de Sistemas de Andru.ia. Dise\u00f1a, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Est\u00e1ndar de Diamante.",
|
||||
"description": "Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.",
|
||||
"risk": "safe",
|
||||
"source": "personal",
|
||||
"date_added": "2026-02-25"
|
||||
@@ -24,7 +24,7 @@
|
||||
"path": "skills/20-andruia-niche-intelligence",
|
||||
"category": "andruia",
|
||||
"name": "20-andruia-niche-intelligence",
|
||||
"description": "Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho espec\u00edfico de un proyecto para inyectar conocimientos, regulaciones y est\u00e1ndares \u00fanicos del sector. Act\u00edvalo tras definir el nicho.",
|
||||
"description": "Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.",
|
||||
"risk": "safe",
|
||||
"source": "personal",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -124,7 +124,7 @@
|
||||
"path": "skills/agent-evaluation",
|
||||
"category": "uncategorized",
|
||||
"name": "agent-evaluation",
|
||||
"description": "Testing and benchmarking LLM agents including behavioral testing, capability assessment, reliability metrics, and production monitoring\u2014where even top agents achieve less than 50% on re...",
|
||||
"description": "Testing and benchmarking LLM agents including behavioral testing, capability assessment, reliability metrics, and production monitoring—where even top agents achieve less than 50% on re...",
|
||||
"risk": "unknown",
|
||||
"source": "vibeship-spawner-skills (Apache 2.0)",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -274,7 +274,7 @@
|
||||
"path": "skills/ai-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "ai-analyzer",
|
||||
"description": "AI\u9a71\u52a8\u7684\u7efc\u5408\u5065\u5eb7\u5206\u6790\u7cfb\u7edf\uff0c\u6574\u5408\u591a\u7ef4\u5ea6\u5065\u5eb7\u6570\u636e\u3001\u8bc6\u522b\u5f02\u5e38\u6a21\u5f0f\u3001\u9884\u6d4b\u5065\u5eb7\u98ce\u9669\u3001\u63d0\u4f9b\u4e2a\u6027\u5316\u5efa\u8bae\u3002\u652f\u6301\u667a\u80fd\u95ee\u7b54\u548cAI\u5065\u5eb7\u62a5\u544a\u751f\u6210\u3002",
|
||||
"description": "AI驱动的综合健康分析系统，整合多维度健康数据、识别异常模式、预测健康风险、提供个性化建议。支持智能问答和AI健康报告生成。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -366,7 +366,7 @@
|
||||
"name": "alpha-vantage",
|
||||
"description": "Access real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API. Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash...",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -686,7 +686,7 @@
|
||||
"name": "apify-trend-analysis",
|
||||
"description": "Discover and track emerging trends across Google Trends, Instagram, Facebook, YouTube, and TikTok to inform content strategy.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -2676,7 +2676,7 @@
|
||||
"name": "burpsuite-project-parser",
|
||||
"description": "Searches and explores Burp Suite project files (.burp) from the command line. Use when searching response headers or bodies with regex patterns, extracting security audit findings, dumping proxy history or site map data, or analyzing HTTP traffic captured in a Burp project.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -2986,7 +2986,7 @@
|
||||
"name": "claimable-postgres",
|
||||
"description": "Provision instant temporary Postgres databases via Claimable Postgres by Neon (pg.new). No login or credit card required. Use for quick Postgres environments and throwaway DATABASE_URL for prototyping.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -3334,7 +3334,7 @@
|
||||
"path": "skills/commit",
|
||||
"category": "uncategorized",
|
||||
"name": "commit",
|
||||
"description": "ALWAYS use this skill when committing code changes \u2014 never commit directly without it. Creates commits following Sentry conventions with proper conventional commit format and issue references. Trigger on any commit, git commit, save changes, or commit message task.",
|
||||
"description": "ALWAYS use this skill when committing code changes — never commit directly without it. Creates commits following Sentry conventions with proper conventional commit format and issue references. Trigger on any commit, git commit, save changes, or commit message task.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -3754,7 +3754,7 @@
|
||||
"path": "skills/crypto-bd-agent",
|
||||
"category": "uncategorized",
|
||||
"name": "crypto-bd-agent",
|
||||
"description": "Autonomous crypto business development patterns \u2014 multi-chain token discovery, 100-point scoring with wallet forensics, x402 micropayments, ERC-8004 on-chain identity, LLM cascade routing, and...",
|
||||
"description": "Autonomous crypto business development patterns — multi-chain token discovery, 100-point scoring with wallet forensics, x402 micropayments, ERC-8004 on-chain identity, LLM cascade routing, and...",
|
||||
"risk": "safe",
|
||||
"source": "community",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -3874,7 +3874,7 @@
|
||||
"path": "skills/data-structure-protocol",
|
||||
"category": "uncategorized",
|
||||
"name": "data-structure-protocol",
|
||||
"description": "Give agents persistent structural memory of a codebase \u2014 navigate dependencies, track public APIs, and understand why connections exist without re-reading the whole repo.",
|
||||
"description": "Give agents persistent structural memory of a codebase — navigate dependencies, track public APIs, and understand why connections exist without re-reading the whole repo.",
|
||||
"risk": "safe",
|
||||
"source": "https://github.com/k-kolomeitsev/data-structure-protocol",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -4454,7 +4454,7 @@
|
||||
"path": "skills/drizzle-orm-expert",
|
||||
"category": "uncategorized",
|
||||
"name": "drizzle-orm-expert",
|
||||
"description": "Expert in Drizzle ORM for TypeScript \u2014 schema design, relational queries, migrations, and serverless database integration. Use when building type-safe database layers with Drizzle.",
|
||||
"description": "Expert in Drizzle ORM for TypeScript — schema design, relational queries, migrations, and serverless database integration. Use when building type-safe database layers with Drizzle.",
|
||||
"risk": "safe",
|
||||
"source": "community",
|
||||
"date_added": "2026-03-04"
|
||||
@@ -4554,9 +4554,9 @@
|
||||
"path": "skills/emergency-card",
|
||||
"category": "uncategorized",
|
||||
"name": "emergency-card",
|
||||
"description": "\u751f\u6210\u7d27\u6025\u60c5\u51b5\u4e0b\u5feb\u901f\u8bbf\u95ee\u7684\u533b\u7597\u4fe1\u606f\u6458\u8981\u5361\u7247\u3002\u5f53\u7528\u6237\u9700\u8981\u65c5\u884c\u3001\u5c31\u8bca\u51c6\u5907\u3001\u7d27\u6025\u60c5\u51b5\u6216\u8be2\u95ee\"\u7d27\u6025\u4fe1\u606f\"\u3001\"\u533b\u7597\u5361\u7247\"\u3001\"\u6025\u6551\u4fe1\u606f\"\u65f6\u4f7f\u7528\u6b64\u6280\u80fd\u3002\u63d0\u53d6\u5173\u952e\u4fe1\u606f\uff08\u8fc7\u654f\u3001\u7528\u836f\u3001\u6025\u75c7\u3001\u690d\u5165\u7269\uff09\uff0c\u652f\u6301\u591a\u683c\u5f0f\u8f93\u51fa\uff08JSON\u3001\u6587\u672c\u3001\u4e8c\u7ef4\u7801\uff09\uff0c\u7528\u4e8e\u6025\u6551\u6216\u5feb\u901f\u5c31\u533b\u3002",
|
||||
"description": "生成紧急情况下快速访问的医疗信息摘要卡片。当用户需要旅行、就诊准备、紧急情况或询问\"紧急信息\"、\"医疗卡片\"、\"急救信息\"时使用此技能。提取关键信息（过敏、用药、急症、植入物），支持多格式输出（JSON、文本、二维码），用于急救或快速就医。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -4884,7 +4884,7 @@
|
||||
"path": "skills/family-health-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "family-health-analyzer",
|
||||
"description": "\u5206\u6790\u5bb6\u65cf\u75c5\u53f2\u3001\u8bc4\u4f30\u9057\u4f20\u98ce\u9669\u3001\u8bc6\u522b\u5bb6\u5ead\u5065\u5eb7\u6a21\u5f0f\u3001\u63d0\u4f9b\u4e2a\u6027\u5316\u9884\u9632\u5efa\u8bae",
|
||||
"description": "分析家族病史、评估遗传风险、识别家庭健康模式、提供个性化预防建议",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -5016,7 +5016,7 @@
|
||||
"name": "filesystem-context",
|
||||
"description": "Use for file-based context management, dynamic context discovery, and reducing context window bloat. Offload context to files for just-in-time loading.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -5074,7 +5074,7 @@
|
||||
"path": "skills/fitness-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "fitness-analyzer",
|
||||
"description": "\u5206\u6790\u8fd0\u52a8\u6570\u636e\u3001\u8bc6\u522b\u8fd0\u52a8\u6a21\u5f0f\u3001\u8bc4\u4f30\u5065\u8eab\u8fdb\u5c55\uff0c\u5e76\u63d0\u4f9b\u4e2a\u6027\u5316\u8bad\u7ec3\u5efa\u8bae\u3002\u652f\u6301\u4e0e\u6162\u6027\u75c5\u6570\u636e\u7684\u5173\u8054\u5206\u6790\u3002",
|
||||
"description": "分析运动数据、识别运动模式、评估健身进展，并提供个性化训练建议。支持与慢性病数据的关联分析。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -5144,7 +5144,7 @@
|
||||
"path": "skills/form-cro",
|
||||
"category": "uncategorized",
|
||||
"name": "form-cro",
|
||||
"description": "Optimize any form that is NOT signup or account registration \u2014 including lead capture, contact, demo request, application, survey, quote, and checkout forms.",
|
||||
"description": "Optimize any form that is NOT signup or account registration — including lead capture, contact, demo request, application, survey, quote, and checkout forms.",
|
||||
"risk": "unknown",
|
||||
"source": "community",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -5334,7 +5334,7 @@
|
||||
"path": "skills/free-tool-strategy",
|
||||
"category": "uncategorized",
|
||||
"name": "free-tool-strategy",
|
||||
"description": "When the user wants to plan, evaluate, or build a free tool for marketing purposes \u2014 lead generation, SEO value, or brand awareness. Also use when the user mentions \"engineering as mar...",
|
||||
"description": "When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions \"engineering as mar...",
|
||||
"risk": "unknown",
|
||||
"source": "community",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -5724,7 +5724,7 @@
|
||||
"path": "skills/goal-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "goal-analyzer",
|
||||
"description": "\u5206\u6790\u5065\u5eb7\u76ee\u6807\u6570\u636e\u3001\u8bc6\u522b\u76ee\u6807\u6a21\u5f0f\u3001\u8bc4\u4f30\u76ee\u6807\u8fdb\u5ea6,\u5e76\u63d0\u4f9b\u4e2a\u6027\u5316\u76ee\u6807\u7ba1\u7406\u5efa\u8bae\u3002\u652f\u6301\u4e0e\u8425\u517b\u3001\u8fd0\u52a8\u3001\u7761\u7720\u7b49\u5065\u5eb7\u6570\u636e\u7684\u5173\u8054\u5206\u6790\u3002",
|
||||
"description": "分析健康目标数据、识别目标模式、评估目标进度,并提供个性化目标管理建议。支持与营养、运动、睡眠等健康数据的关联分析。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -5814,9 +5814,9 @@
|
||||
"path": "skills/google-sheets-automation",
|
||||
"category": "uncategorized",
|
||||
"name": "google-sheets-automation",
|
||||
"description": "Read and write Google Sheets spreadsheets - get content, update cells, append rows, fetch specific ranges,\nsearch for spreadsheets, and view metadata. Use when user asks to: read a spreadsheet, update cells,\nadd data to Google Sheets, find a spreadsheet, check sheet...",
|
||||
"description": "Read and write Google Sheets spreadsheets - get content, update cells, append rows, fetch specific ranges,\nsearch for spreadsheets, and view metadata. Use when user asks to: read a spreadsheet, update cells,\nadd data to Google Sheets, find a spreadsheet, check sheet...\n",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -5914,7 +5914,7 @@
|
||||
"path": "skills/health-trend-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "health-trend-analyzer",
|
||||
"description": "\u5206\u6790\u4e00\u6bb5\u65f6\u95f4\u5185\u5065\u5eb7\u6570\u636e\u7684\u8d8b\u52bf\u548c\u6a21\u5f0f\u3002\u5173\u8054\u836f\u7269\u3001\u75c7\u72b6\u3001\u751f\u547d\u4f53\u5f81\u3001\u5316\u9a8c\u7ed3\u679c\u548c\u5176\u4ed6\u5065\u5eb7\u6307\u6807\u7684\u53d8\u5316\u3002\u8bc6\u522b\u4ee4\u4eba\u62c5\u5fe7\u7684\u8d8b\u52bf\u3001\u6539\u5584\u60c5\u51b5\uff0c\u5e76\u63d0\u4f9b\u6570\u636e\u9a71\u52a8\u7684\u6d1e\u5bdf\u3002\u5f53\u7528\u6237\u8be2\u95ee\u5065\u5eb7\u8d8b\u52bf\u3001\u6a21\u5f0f\u3001\u968f\u65f6\u95f4\u7684\u53d8\u5316\u6216\"\u6211\u7684\u5065\u5eb7\u72b6\u51b5\u6709\u4ec0\u4e48\u53d8\u5316\uff1f\"\u65f6\u4f7f\u7528\u3002\u652f\u6301\u591a\u7ef4\u5ea6\u5206\u6790\uff08\u4f53\u91cd/BMI\u3001\u75c7\u72b6\u3001\u836f\u7269\u4f9d\u4ece\u6027\u3001\u5316\u9a8c\u7ed3\u679c\u3001\u60c5\u7eea\u7761\u7720\uff09\uff0c\u76f8\u5173\u6027\u5206\u6790\uff0c\u53d8\u5316\u68c0\u6d4b\uff0c\u4ee5\u53ca\u4ea4\u4e92\u5f0fHTML\u53ef\u89c6\u5316\u62a5\u544a\uff08ECharts\u56fe\u8868\uff09\u3002",
|
||||
"description": "分析一段时间内健康数据的趋势和模式。关联药物、症状、生命体征、化验结果和其他健康指标的变化。识别令人担忧的趋势、改善情况，并提供数据驱动的洞察。当用户询问健康趋势、模式、随时间的变化或\"我的健康状况有什么变化？\"时使用。支持多维度分析（体重/BMI、症状、药物依从性、化验结果、情绪睡眠），相关性分析，变化检测，以及交互式HTML可视化报告（ECharts图表）。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -6096,7 +6096,7 @@
|
||||
"name": "hosted-agents",
|
||||
"description": "Build background agents in sandboxed environments. Use for hosted coding agents, sandboxed VMs, Modal sandboxes, and remote coding environments.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -6476,7 +6476,7 @@
|
||||
"name": "iterate-pr",
|
||||
"description": "Iterate on a PR until CI passes. Use when you need to fix CI failures, address review feedback, or continuously push fixes until all checks are green. Automates the feedback-fix-push-wait cycle.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -6754,7 +6754,7 @@
|
||||
"path": "skills/lightning-factory-explainer",
|
||||
"category": "uncategorized",
|
||||
"name": "lightning-factory-explainer",
|
||||
"description": "Explain Bitcoin Lightning channel factories and the SuperScalar protocol \u2014 scalable Lightning onboarding using shared UTXOs, Decker-Wattenhofer trees, timeout-signature trees, MuSig2, and Taproot. No soft fork required.",
|
||||
"description": "Explain Bitcoin Lightning channel factories and the SuperScalar protocol — scalable Lightning onboarding using shared UTXOs, Decker-Wattenhofer trees, timeout-signature trees, MuSig2, and Taproot. No soft fork required.",
|
||||
"risk": "unknown",
|
||||
"source": "community",
|
||||
"date_added": "2026-03-03"
|
||||
@@ -7014,7 +7014,7 @@
|
||||
"path": "skills/makepad-animation",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-animation",
|
||||
"description": "CRITICAL: Use for Makepad animation system. Triggers on:\nmakepad animation, makepad animator, makepad hover, makepad state,\nmakepad transition, \"from: { all: Forward\", makepad pressed,\nmakepad \u52a8\u753b, makepad \u72b6\u6001, makepad \u8fc7\u6e21, makepad \u60ac\u505c\u6548\u679c",
|
||||
"description": "CRITICAL: Use for Makepad animation system. Triggers on:\nmakepad animation, makepad animator, makepad hover, makepad state,\nmakepad transition, \"from: { all: Forward\", makepad pressed,\nmakepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7024,7 +7024,7 @@
|
||||
"path": "skills/makepad-basics",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-basics",
|
||||
"description": "CRITICAL: Use for Makepad getting started and app structure. Triggers on:\nmakepad, makepad getting started, makepad tutorial, live_design!, app_main!,\nmakepad project setup, makepad hello world, \"how to create makepad app\",\nmakepad \u5165\u95e8, \u521b\u5efa makepad \u5e94\u7528, makepad \u6559\u7a0b, makepad \u9879\u76ee\u7ed3\u6784",
|
||||
"description": "CRITICAL: Use for Makepad getting started and app structure. Triggers on:\nmakepad, makepad getting started, makepad tutorial, live_design!, app_main!,\nmakepad project setup, makepad hello world, \"how to create makepad app\",\nmakepad 入门, 创建 makepad 应用, makepad 教程, makepad 项目结构",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7034,7 +7034,7 @@
|
||||
"path": "skills/makepad-deployment",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-deployment",
|
||||
"description": "CRITICAL: Use for Makepad packaging and deployment. Triggers on:\ndeploy, package, APK, IPA, \u6253\u5305, \u90e8\u7f72,\ncargo-packager, cargo-makepad, WASM, Android, iOS,\ndistribution, installer, .deb, .dmg, .nsis,\nGitHub Actions, CI, action, marketplace",
|
||||
"description": "CRITICAL: Use for Makepad packaging and deployment. Triggers on:\ndeploy, package, APK, IPA, 打包, 部署,\ncargo-packager, cargo-makepad, WASM, Android, iOS,\ndistribution, installer, .deb, .dmg, .nsis,\nGitHub Actions, CI, action, marketplace",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7044,7 +7044,7 @@
|
||||
"path": "skills/makepad-dsl",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-dsl",
|
||||
"description": "CRITICAL: Use for Makepad DSL syntax and inheritance. Triggers on:\nmakepad dsl, live_design, makepad inheritance, makepad prototype,\n\"<Widget>\", \"Foo = { }\", makepad object, makepad property,\nmakepad DSL \u8bed\u6cd5, makepad \u7ee7\u627f, makepad \u539f\u578b, \u5982\u4f55\u5b9a\u4e49 makepad \u7ec4\u4ef6",
|
||||
"description": "CRITICAL: Use for Makepad DSL syntax and inheritance. Triggers on:\nmakepad dsl, live_design, makepad inheritance, makepad prototype,\n\"<Widget>\", \"Foo = { }\", makepad object, makepad property,\nmakepad DSL 语法, makepad 继承, makepad 原型, 如何定义 makepad 组件",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7054,7 +7054,7 @@
|
||||
"path": "skills/makepad-event-action",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-event-action",
|
||||
"description": "CRITICAL: Use for Makepad event and action handling. Triggers on:\nmakepad event, makepad action, Event enum, ActionTrait, handle_event,\nMouseDown, KeyDown, TouchUpdate, Hit, FingerDown, post_action,\nmakepad \u4e8b\u4ef6, makepad action, \u4e8b\u4ef6\u5904\u7406",
|
||||
"description": "CRITICAL: Use for Makepad event and action handling. Triggers on:\nmakepad event, makepad action, Event enum, ActionTrait, handle_event,\nMouseDown, KeyDown, TouchUpdate, Hit, FingerDown, post_action,\nmakepad 事件, makepad action, 事件处理",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7064,9 +7064,9 @@
|
||||
"path": "skills/makepad-font",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-font",
|
||||
"description": "CRITICAL: Use for Makepad font and text rendering. Triggers on:\nmakepad font, makepad text, makepad glyph, makepad typography,\nfont atlas, text layout, font family, font size, text shaping,\nmakepad \u5b57\u4f53, makepad \u6587\u5b57, makepad \u6392\u7248, makepad \u5b57\u5f62",
|
||||
"description": "CRITICAL: Use for Makepad font and text rendering. Triggers on:\nmakepad font, makepad text, makepad glyph, makepad typography,\nfont atlas, text layout, font family, font size, text shaping,\nmakepad 字体, makepad 文字, makepad 排版, makepad 字形\n",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -7074,7 +7074,7 @@
|
||||
"path": "skills/makepad-layout",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-layout",
|
||||
"description": "CRITICAL: Use for Makepad layout system. Triggers on:\nmakepad layout, makepad width, makepad height, makepad flex,\nmakepad padding, makepad margin, makepad flow, makepad align,\nFit, Fill, Size, Walk, \"how to center in makepad\",\nmakepad \u5e03\u5c40, makepad \u5bbd\u5ea6, makepad \u5bf9\u9f50, makepad \u5c45\u4e2d",
|
||||
"description": "CRITICAL: Use for Makepad layout system. Triggers on:\nmakepad layout, makepad width, makepad height, makepad flex,\nmakepad padding, makepad margin, makepad flow, makepad align,\nFit, Fill, Size, Walk, \"how to center in makepad\",\nmakepad 布局, makepad 宽度, makepad 对齐, makepad 居中",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7084,7 +7084,7 @@
|
||||
"path": "skills/makepad-platform",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-platform",
|
||||
"description": "CRITICAL: Use for Makepad cross-platform support. Triggers on:\nmakepad platform, makepad os, makepad macos, makepad windows, makepad linux,\nmakepad android, makepad ios, makepad web, makepad wasm, makepad metal,\nmakepad d3d11, makepad opengl, makepad webgl, OsType, CxOs,\nmakepad \u8de8\u5e73\u53f0, makepad \u5e73\u53f0\u652f\u6301",
|
||||
"description": "CRITICAL: Use for Makepad cross-platform support. Triggers on:\nmakepad platform, makepad os, makepad macos, makepad windows, makepad linux,\nmakepad android, makepad ios, makepad web, makepad wasm, makepad metal,\nmakepad d3d11, makepad opengl, makepad webgl, OsType, CxOs,\nmakepad 跨平台, makepad 平台支持",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7104,7 +7104,7 @@
|
||||
"path": "skills/makepad-shaders",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-shaders",
|
||||
"description": "CRITICAL: Use for Makepad shader system. Triggers on:\nmakepad shader, makepad draw_bg, Sdf2d, makepad pixel,\nmakepad glsl, makepad sdf, draw_quad, makepad gpu,\nmakepad \u7740\u8272\u5668, makepad shader \u8bed\u6cd5, makepad \u7ed8\u5236",
|
||||
"description": "CRITICAL: Use for Makepad shader system. Triggers on:\nmakepad shader, makepad draw_bg, Sdf2d, makepad pixel,\nmakepad glsl, makepad sdf, draw_quad, makepad gpu,\nmakepad 着色器, makepad shader 语法, makepad 绘制",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7124,7 +7124,7 @@
|
||||
"path": "skills/makepad-splash",
|
||||
"category": "uncategorized",
|
||||
"name": "makepad-splash",
|
||||
"description": "CRITICAL: Use for Makepad Splash scripting language. Triggers on:\nsplash language, makepad script, makepad scripting, script!, cx.eval,\nmakepad dynamic, makepad AI, splash \u8bed\u8a00, makepad \u811a\u672c",
|
||||
"description": "CRITICAL: Use for Makepad Splash scripting language. Triggers on:\nsplash language, makepad script, makepad scripting, script!, cx.eval,\nmakepad dynamic, makepad AI, splash 语言, makepad 脚本",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7254,7 +7254,7 @@
|
||||
"path": "skills/mental-health-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "mental-health-analyzer",
|
||||
"description": "\u5206\u6790\u5fc3\u7406\u5065\u5eb7\u6570\u636e\u3001\u8bc6\u522b\u5fc3\u7406\u6a21\u5f0f\u3001\u8bc4\u4f30\u5fc3\u7406\u5065\u5eb7\u72b6\u51b5\u3001\u63d0\u4f9b\u4e2a\u6027\u5316\u5fc3\u7406\u5065\u5eb7\u5efa\u8bae\u3002\u652f\u6301\u4e0e\u7761\u7720\u3001\u8fd0\u52a8\u3001\u8425\u517b\u7b49\u5176\u4ed6\u5065\u5eb7\u6570\u636e\u7684\u5173\u8054\u5206\u6790\u3002",
|
||||
"description": "分析心理健康数据、识别心理模式、评估心理健康状况、提供个性化心理健康建议。支持与睡眠、运动、营养等其他健康数据的关联分析。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7674,7 +7674,7 @@
|
||||
"path": "skills/nerdzao-elite-gemini-high",
|
||||
"category": "uncategorized",
|
||||
"name": "nerdzao-elite-gemini-high",
|
||||
"description": "Modo Elite Coder + UX Pixel-Perfect otimizado especificamente para Gemini 3.1 Pro High. Workflow completo com foco em qualidade m\u00e1xima e efici\u00eancia de tokens.",
|
||||
"description": "Modo Elite Coder + UX Pixel-Perfect otimizado especificamente para Gemini 3.1 Pro High. Workflow completo com foco em qualidade máxima e eficiência de tokens.",
|
||||
"risk": "safe",
|
||||
"source": "community",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -7844,7 +7844,7 @@
|
||||
"path": "skills/nutrition-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "nutrition-analyzer",
|
||||
"description": "\u5206\u6790\u8425\u517b\u6570\u636e\u3001\u8bc6\u522b\u8425\u517b\u6a21\u5f0f\u3001\u8bc4\u4f30\u8425\u517b\u72b6\u51b5\uff0c\u5e76\u63d0\u4f9b\u4e2a\u6027\u5316\u8425\u517b\u5efa\u8bae\u3002\u652f\u6301\u4e0e\u8fd0\u52a8\u3001\u7761\u7720\u3001\u6162\u6027\u75c5\u6570\u636e\u7684\u5173\u8054\u5206\u6790\u3002",
|
||||
"description": "分析营养数据、识别营养模式、评估营养状况，并提供个性化营养建议。支持与运动、睡眠、慢性病数据的关联分析。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -7914,7 +7914,7 @@
|
||||
"path": "skills/occupational-health-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "occupational-health-analyzer",
|
||||
"description": "\u5206\u6790\u804c\u4e1a\u5065\u5eb7\u6570\u636e\u3001\u8bc6\u522b\u5de5\u4f5c\u76f8\u5173\u5065\u5eb7\u98ce\u9669\u3001\u8bc4\u4f30\u804c\u4e1a\u5065\u5eb7\u72b6\u51b5\u3001\u63d0\u4f9b\u4e2a\u6027\u5316\u804c\u4e1a\u5065\u5eb7\u5efa\u8bae\u3002\u652f\u6301\u4e0e\u7761\u7720\u3001\u8fd0\u52a8\u3001\u5fc3\u7406\u5065\u5eb7\u7b49\u5176\u4ed6\u5065\u5eb7\u6570\u636e\u7684\u5173\u8054\u5206\u6790\u3002",
|
||||
"description": "分析职业健康数据、识别工作相关健康风险、评估职业健康状况、提供个性化职业健康建议。支持与睡眠、运动、心理健康等其他健康数据的关联分析。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -8024,7 +8024,7 @@
|
||||
"path": "skills/odoo-migration-helper",
|
||||
"category": "uncategorized",
|
||||
"name": "odoo-migration-helper",
|
||||
"description": "Step-by-step guide for migrating Odoo custom modules between versions (v14\u2192v15\u2192v16\u2192v17). Covers API changes, deprecated methods, and view migration.",
|
||||
"description": "Step-by-step guide for migrating Odoo custom modules between versions (v14→v15→v16→v17). Covers API changes, deprecated methods, and view migration.",
|
||||
"risk": "safe",
|
||||
"source": "self",
|
||||
"date_added": null
|
||||
@@ -8074,7 +8074,7 @@
|
||||
"path": "skills/odoo-purchase-workflow",
|
||||
"category": "uncategorized",
|
||||
"name": "odoo-purchase-workflow",
|
||||
"description": "Expert guide for Odoo Purchase: RFQ \u2192 PO \u2192 Receipt \u2192 Vendor Bill workflow, purchase agreements, vendor price lists, and 3-way matching.",
|
||||
"description": "Expert guide for Odoo Purchase: RFQ → PO → Receipt → Vendor Bill workflow, purchase agreements, vendor price lists, and 3-way matching.",
|
||||
"risk": "safe",
|
||||
"source": "self",
|
||||
"date_added": null
|
||||
@@ -8234,7 +8234,7 @@
|
||||
"path": "skills/oral-health-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "oral-health-analyzer",
|
||||
"description": "\u5206\u6790\u53e3\u8154\u5065\u5eb7\u6570\u636e\u3001\u8bc6\u522b\u53e3\u8154\u95ee\u9898\u6a21\u5f0f\u3001\u8bc4\u4f30\u53e3\u8154\u5065\u5eb7\u72b6\u51b5\u3001\u63d0\u4f9b\u4e2a\u6027\u5316\u53e3\u8154\u5065\u5eb7\u5efa\u8bae\u3002\u652f\u6301\u4e0e\u8425\u517b\u3001\u6162\u6027\u75c5\u3001\u7528\u836f\u7b49\u5176\u4ed6\u5065\u5eb7\u6570\u636e\u7684\u5173\u8054\u5206\u6790\u3002",
|
||||
"description": "分析口腔健康数据、识别口腔问题模式、评估口腔健康状况、提供个性化口腔健康建议。支持与营养、慢性病、用药等其他健康数据的关联分析。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -8326,7 +8326,7 @@
|
||||
"name": "pandas",
|
||||
"description": "Pandas",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -8694,7 +8694,7 @@
|
||||
"path": "skills/pr-writer",
|
||||
"category": "uncategorized",
|
||||
"name": "pr-writer",
|
||||
"description": "ALWAYS use this skill when creating or updating pull requests \u2014 never create or edit a PR directly without it. Follows Sentry conventions for PR titles, descriptions, and issue references. Trigger on any create PR, open PR, submit PR, make PR,...",
|
||||
"description": "ALWAYS use this skill when creating or updating pull requests — never create or edit a PR directly without it. Follows Sentry conventions for PR titles, descriptions, and issue references. Trigger on any create PR, open PR, submit PR, make PR,...",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -9264,7 +9264,7 @@
|
||||
"path": "skills/rehabilitation-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "rehabilitation-analyzer",
|
||||
"description": "\u5206\u6790\u5eb7\u590d\u8bad\u7ec3\u6570\u636e\u3001\u8bc6\u522b\u5eb7\u590d\u6a21\u5f0f\u3001\u8bc4\u4f30\u5eb7\u590d\u8fdb\u5c55\uff0c\u5e76\u63d0\u4f9b\u4e2a\u6027\u5316\u5eb7\u590d\u5efa\u8bae",
|
||||
"description": "分析康复训练数据、识别康复模式、评估康复进展，并提供个性化康复建议",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -9276,7 +9276,7 @@
|
||||
"name": "remotion",
|
||||
"description": "Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -9374,7 +9374,7 @@
|
||||
"path": "skills/robius-app-architecture",
|
||||
"category": "uncategorized",
|
||||
"name": "robius-app-architecture",
|
||||
"description": "CRITICAL: Use for Robius app architecture patterns. Triggers on:\nTokio, async, submit_async_request, \u5f02\u6b65, \u67b6\u6784,\nSignalToUI, Cx::post_action, worker task,\napp structure, MatchEvent, handle_startup",
|
||||
"description": "CRITICAL: Use for Robius app architecture patterns. Triggers on:\nTokio, async, submit_async_request, 异步, 架构,\nSignalToUI, Cx::post_action, worker task,\napp structure, MatchEvent, handle_startup",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -9384,7 +9384,7 @@
|
||||
"path": "skills/robius-event-action",
|
||||
"category": "uncategorized",
|
||||
"name": "robius-event-action",
|
||||
"description": "CRITICAL: Use for Robius event and action patterns. Triggers on:\ncustom action, MatchEvent, post_action, cx.widget_action,\nhandle_actions, DefaultNone, widget action, event handling,\n\u4e8b\u4ef6\u5904\u7406, \u81ea\u5b9a\u4e49\u52a8\u4f5c",
|
||||
"description": "CRITICAL: Use for Robius event and action patterns. Triggers on:\ncustom action, MatchEvent, post_action, cx.widget_action,\nhandle_actions, DefaultNone, widget action, event handling,\n事件处理, 自定义动作",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -9394,7 +9394,7 @@
|
||||
"path": "skills/robius-matrix-integration",
|
||||
"category": "uncategorized",
|
||||
"name": "robius-matrix-integration",
|
||||
"description": "CRITICAL: Use for Matrix SDK integration with Makepad. Triggers on:\nMatrix SDK, sliding sync, MatrixRequest, timeline,\nmatrix-sdk, matrix client, robrix, matrix room,\nMatrix \u96c6\u6210, \u804a\u5929\u5ba2\u6237\u7aef",
|
||||
"description": "CRITICAL: Use for Matrix SDK integration with Makepad. Triggers on:\nMatrix SDK, sliding sync, MatrixRequest, timeline,\nmatrix-sdk, matrix client, robrix, matrix room,\nMatrix 集成, 聊天客户端",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -9404,7 +9404,7 @@
|
||||
"path": "skills/robius-state-management",
|
||||
"category": "uncategorized",
|
||||
"name": "robius-state-management",
|
||||
"description": "CRITICAL: Use for Robius state management patterns. Triggers on:\nAppState, persistence, theme switch, \u72b6\u6001\u7ba1\u7406,\nScope::with_data, save state, load state, serde,\n\u72b6\u6001\u6301\u4e45\u5316, \u4e3b\u9898\u5207\u6362",
|
||||
"description": "CRITICAL: Use for Robius state management patterns. Triggers on:\nAppState, persistence, theme switch, 状态管理,\nScope::with_data, save state, load state, serde,\n状态持久化, 主题切换",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -9414,7 +9414,7 @@
|
||||
"path": "skills/robius-widget-patterns",
|
||||
"category": "uncategorized",
|
||||
"name": "robius-widget-patterns",
|
||||
"description": "CRITICAL: Use for Robius widget patterns. Triggers on:\napply_over, TextOrImage, modal, \u53ef\u590d\u7528, \u6a21\u6001,\ncollapsible, drag drop, reusable widget, widget design,\npageflip, \u7ec4\u4ef6\u8bbe\u8ba1, \u7ec4\u4ef6\u6a21\u5f0f",
|
||||
"description": "CRITICAL: Use for Robius widget patterns. Triggers on:\napply_over, TextOrImage, modal, 可复用, 模态,\ncollapsible, drag drop, reusable widget, widget design,\npageflip, 组件设计, 组件模式",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -9576,7 +9576,7 @@
|
||||
"name": "scikit-learn",
|
||||
"description": "Machine learning in Python with scikit-learn. Use for classification, regression, clustering, model evaluation, and ML pipelines.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -10166,7 +10166,7 @@
|
||||
"name": "skill-writer",
|
||||
"description": "Create and improve agent skills following the Agent Skills specification. Use when asked to create, write, or update skills.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -10176,7 +10176,7 @@
|
||||
"name": "skin-health-analyzer",
|
||||
"description": "Analyze skin health data, identify skin problem patterns, assess skin health status. Supports correlation analysis with nutrition, chronic diseases, and medication data.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -10214,7 +10214,7 @@
|
||||
"path": "skills/sleep-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "sleep-analyzer",
|
||||
"description": "\u5206\u6790\u7761\u7720\u6570\u636e\u3001\u8bc6\u522b\u7761\u7720\u6a21\u5f0f\u3001\u8bc4\u4f30\u7761\u7720\u8d28\u91cf\uff0c\u5e76\u63d0\u4f9b\u4e2a\u6027\u5316\u7761\u7720\u6539\u5584\u5efa\u8bae\u3002\u652f\u6301\u4e0e\u5176\u4ed6\u5065\u5eb7\u6570\u636e\u7684\u5173\u8054\u5206\u6790\u3002",
|
||||
"description": "分析睡眠数据、识别睡眠模式、评估睡眠质量，并提供个性化睡眠改善建议。支持与其他健康数据的关联分析。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -10634,7 +10634,7 @@
|
||||
"path": "skills/tcm-constitution-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "tcm-constitution-analyzer",
|
||||
"description": "\u5206\u6790\u4e2d\u533b\u4f53\u8d28\u6570\u636e\u3001\u8bc6\u522b\u4f53\u8d28\u7c7b\u578b\u3001\u8bc4\u4f30\u4f53\u8d28\u7279\u5f81,\u5e76\u63d0\u4f9b\u4e2a\u6027\u5316\u517b\u751f\u5efa\u8bae\u3002\u652f\u6301\u4e0e\u8425\u517b\u3001\u8fd0\u52a8\u3001\u7761\u7720\u7b49\u5065\u5eb7\u6570\u636e\u7684\u5173\u8054\u5206\u6790\u3002",
|
||||
"description": "分析中医体质数据、识别体质类型、评估体质特征,并提供个性化养生建议。支持与营养、运动、睡眠等健康数据的关联分析。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -10804,7 +10804,7 @@
|
||||
"path": "skills/terraform-aws-modules",
|
||||
"category": "uncategorized",
|
||||
"name": "terraform-aws-modules",
|
||||
"description": "Terraform module creation for AWS \u2014 reusable modules, state management, and HCL best practices. Use when building or reviewing Terraform AWS infrastructure.",
|
||||
"description": "Terraform module creation for AWS — reusable modules, state management, and HCL best practices. Use when building or reviewing Terraform AWS infrastructure.",
|
||||
"risk": "unknown",
|
||||
"source": "community",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -11006,7 +11006,7 @@
|
||||
"name": "threejs-materials",
|
||||
"description": "Three.js materials - PBR, basic, phong, shader materials, material properties. Use when styling meshes, working with textures, creating custom shaders, or optimizing material performance.",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"source": "community",
|
||||
"date_added": null
|
||||
},
|
||||
{
|
||||
@@ -11104,7 +11104,7 @@
|
||||
"path": "skills/travel-health-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "travel-health-analyzer",
|
||||
"description": "\u5206\u6790\u65c5\u884c\u5065\u5eb7\u6570\u636e\u3001\u8bc4\u4f30\u76ee\u7684\u5730\u5065\u5eb7\u98ce\u9669\u3001\u63d0\u4f9b\u75ab\u82d7\u63a5\u79cd\u5efa\u8bae\u3001\u751f\u6210\u591a\u8bed\u8a00\u7d27\u6025\u533b\u7597\u4fe1\u606f\u5361\u7247\u3002\u652f\u6301WHO/CDC\u6570\u636e\u96c6\u6210\u7684\u4e13\u4e1a\u7ea7\u65c5\u884c\u5065\u5eb7\u98ce\u9669\u8bc4\u4f30\u3002",
|
||||
"description": "分析旅行健康数据、评估目的地健康风险、提供疫苗接种建议、生成多语言紧急医疗信息卡片。支持WHO/CDC数据集成的专业级旅行健康风险评估。",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -11654,7 +11654,7 @@
|
||||
"path": "skills/weightloss-analyzer",
|
||||
"category": "uncategorized",
|
||||
"name": "weightloss-analyzer",
|
||||
"description": "\u5206\u6790\u51cf\u80a5\u6570\u636e\u3001\u8ba1\u7b97\u4ee3\u8c22\u7387\u3001\u8ffd\u8e2a\u80fd\u91cf\u7f3a\u53e3\u3001\u7ba1\u7406\u51cf\u80a5\u9636\u6bb5",
|
||||
"description": "分析减肥数据、计算代谢率、追踪能量缺口、管理减肥阶段",
|
||||
"risk": "unknown",
|
||||
"source": "unknown",
|
||||
"date_added": null
|
||||
@@ -11704,7 +11704,7 @@
|
||||
"path": "skills/wiki-onboarding",
|
||||
"category": "uncategorized",
|
||||
"name": "wiki-onboarding",
|
||||
"description": "Generates two complementary onboarding guides \u2014 a Principal-Level architectural deep-dive and a Zero-to-Hero contributor walkthrough. Use when the user wants onboarding documentation fo...",
|
||||
"description": "Generates two complementary onboarding guides — a Principal-Level architectural deep-dive and a Zero-to-Hero contributor walkthrough. Use when the user wants onboarding documentation fo...",
|
||||
"risk": "unknown",
|
||||
"source": "community",
|
||||
"date_added": "2026-02-27"
|
||||
@@ -11914,7 +11914,7 @@
|
||||
"path": "skills/x-twitter-scraper",
|
||||
"category": "data",
|
||||
"name": "x-twitter-scraper",
|
||||
"description": "X (Twitter) data platform skill \u2014 tweet search, user lookup, follower extraction, engagement metrics, giveaway draws, monitoring, webhooks, 19 extraction tools, MCP server.",
|
||||
"description": "X (Twitter) data platform skill — tweet search, user lookup, follower extraction, engagement metrics, giveaway draws, monitoring, webhooks, 19 extraction tools, MCP server.",
|
||||
"risk": "safe",
|
||||
"source": "community",
|
||||
"date_added": "2026-02-28"
|
||||
@@ -12004,7 +12004,7 @@
|
||||
"path": "skills/zod-validation-expert",
|
||||
"category": "uncategorized",
|
||||
"name": "zod-validation-expert",
|
||||
"description": "Expert in Zod \u2014 TypeScript-first schema validation. Covers parsing, custom errors, refinements, type inference, and integration with React Hook Form, Next.js, and tRPC.",
|
||||
"description": "Expert in Zod — TypeScript-first schema validation. Covers parsing, custom errors, refinements, type inference, and integration with React Hook Form, Next.js, and tRPC.",
|
||||
"risk": "safe",
|
||||
"source": "community",
|
||||
"date_added": "2026-03-05"
|
||||
|
Before Width: | Height: | Size: 1.5 KiB After Width: | Height: | Size: 1.5 KiB |
|
Before Width: | Height: | Size: 4.0 KiB After Width: | Height: | Size: 4.0 KiB |
747
categorization_report.txt
Normal file
747
categorization_report.txt
Normal file
@@ -0,0 +1,747 @@
|
||||
================================================================================
|
||||
REPORT DI CATEGORIZZAZIONE SKILLS
|
||||
================================================================================
|
||||
|
||||
Totale skills processate: 1139
|
||||
Categorizzate: 667 (58.6%)
|
||||
Non categorizzate: 472 (41.4%)
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
DISTRIBUZIONE PER CATEGORIA
|
||||
--------------------------------------------------------------------------------
|
||||
cloud-devops: 155 skills
|
||||
security: 57 skills
|
||||
product-business: 57 skills
|
||||
languages-frameworks: 49 skills
|
||||
ai-ml: 48 skills
|
||||
frontend: 37 skills
|
||||
game-development: 32 skills
|
||||
web3-blockchain: 29 skills
|
||||
data-engineering: 28 skills
|
||||
database: 25 skills
|
||||
testing-qa: 24 skills
|
||||
workflow-automation: 22 skills
|
||||
marketing-growth: 21 skills
|
||||
api-integration: 20 skills
|
||||
backend: 17 skills
|
||||
mobile: 16 skills
|
||||
3d-web: 12 skills
|
||||
documentation-content: 9 skills
|
||||
infrastructure-sre: 7 skills
|
||||
meta: 2 skills
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
SKILLS A BASSA CONFIDENZA (655)
|
||||
--------------------------------------------------------------------------------
|
||||
neon-postgres: database (confidenza: 0.55)
|
||||
crewai: ai-ml (confidenza: 0.56)
|
||||
last30days: web3-blockchain (confidenza: 0.57)
|
||||
launch-strategy: web3-blockchain (confidenza: 0.57)
|
||||
legacy-modernizer: web3-blockchain (confidenza: 0.57)
|
||||
legal-advisor: web3-blockchain (confidenza: 0.57)
|
||||
lightning-architecture-review: web3-blockchain (confidenza: 0.57)
|
||||
lightning-channel-factories: web3-blockchain (confidenza: 0.57)
|
||||
lightning-factory-explainer: web3-blockchain (confidenza: 0.57)
|
||||
lint-and-validate: web3-blockchain (confidenza: 0.57)
|
||||
linux-shell-scripting: web3-blockchain (confidenza: 0.57)
|
||||
literature-analysis: web3-blockchain (confidenza: 0.57)
|
||||
local-legal-seo-audit: web3-blockchain (confidenza: 0.57)
|
||||
logistics-exception-management: web3-blockchain (confidenza: 0.57)
|
||||
prisma-expert: database (confidenza: 0.57)
|
||||
ai-agents-architect: ai-ml (confidenza: 0.58)
|
||||
ai-analyzer: ai-ml (confidenza: 0.58)
|
||||
ai-engineer: ai-ml (confidenza: 0.58)
|
||||
ai-product: ai-ml (confidenza: 0.58)
|
||||
ai-wrapper-product: ai-ml (confidenza: 0.58)
|
||||
airflow-dag-patterns: ai-ml (confidenza: 0.58)
|
||||
airtable-automation: ai-ml (confidenza: 0.58)
|
||||
cc-skill-backend-patterns: game-development (confidenza: 0.58)
|
||||
cc-skill-clickhouse-io: game-development (confidenza: 0.58)
|
||||
cc-skill-coding-standards: game-development (confidenza: 0.58)
|
||||
cc-skill-continuous-learning: game-development (confidenza: 0.58)
|
||||
cc-skill-frontend-patterns: game-development (confidenza: 0.58)
|
||||
cc-skill-project-guidelines-example: game-development (confidenza: 0.58)
|
||||
cc-skill-strategic-compact: game-development (confidenza: 0.58)
|
||||
data-scientist: web3-blockchain (confidenza: 0.58)
|
||||
data-storytelling: web3-blockchain (confidenza: 0.58)
|
||||
data-structure-protocol: web3-blockchain (confidenza: 0.58)
|
||||
data-visualization: web3-blockchain (confidenza: 0.58)
|
||||
dbos-golang: database (confidenza: 0.58)
|
||||
dbos-python: database (confidenza: 0.58)
|
||||
dbos-typescript: database (confidenza: 0.58)
|
||||
dbt-transformation-patterns: database (confidenza: 0.58)
|
||||
drizzle-orm-expert: database (confidenza: 0.58)
|
||||
fda-food-safety-auditor: database (confidenza: 0.58)
|
||||
fda-medtech-compliance-auditor: database (confidenza: 0.58)
|
||||
go-concurrency-patterns: languages-frameworks (confidenza: 0.58)
|
||||
go-playwright: languages-frameworks (confidenza: 0.58)
|
||||
go-rod-master: languages-frameworks (confidenza: 0.58)
|
||||
goal-analyzer: languages-frameworks (confidenza: 0.58)
|
||||
godot-4-migration: languages-frameworks (confidenza: 0.58)
|
||||
godot-gdscript-patterns: languages-frameworks (confidenza: 0.58)
|
||||
golang-pro: languages-frameworks (confidenza: 0.58)
|
||||
google-analytics-automation: languages-frameworks (confidenza: 0.58)
|
||||
google-calendar-automation: languages-frameworks (confidenza: 0.58)
|
||||
google-docs-automation: languages-frameworks (confidenza: 0.58)
|
||||
google-drive-automation: languages-frameworks (confidenza: 0.58)
|
||||
google-sheets-automation: languages-frameworks (confidenza: 0.58)
|
||||
google-slides-automation: languages-frameworks (confidenza: 0.58)
|
||||
googlesheets-automation: languages-frameworks (confidenza: 0.58)
|
||||
hybrid-search-implementation: languages-frameworks (confidenza: 0.58)
|
||||
langfuse: ai-ml (confidenza: 0.58)
|
||||
ml-engineer: ai-ml (confidenza: 0.58)
|
||||
ml-pipeline-workflow: ai-ml (confidenza: 0.58)
|
||||
mlops-engineer: ai-ml (confidenza: 0.58)
|
||||
osint-evals: cloud-devops (confidenza: 0.58)
|
||||
oss-hunter: cloud-devops (confidenza: 0.58)
|
||||
tiktok-automation: languages-frameworks (confidenza: 0.58)
|
||||
twilio-communications: game-development (confidenza: 0.58)
|
||||
twitter-automation: game-development (confidenza: 0.58)
|
||||
ui-skills: frontend (confidenza: 0.58)
|
||||
ui-ux-designer: frontend (confidenza: 0.58)
|
||||
ui-ux-pro-max: frontend (confidenza: 0.58)
|
||||
ui-visual-validator: frontend (confidenza: 0.58)
|
||||
api-design-principles: api-integration (confidenza: 0.59)
|
||||
api-documentation-generator: api-integration (confidenza: 0.59)
|
||||
api-documenter: api-integration (confidenza: 0.59)
|
||||
api-fuzzing-bug-bounty: api-integration (confidenza: 0.59)
|
||||
api-patterns: api-integration (confidenza: 0.59)
|
||||
apify-actor-development: api-integration (confidenza: 0.59)
|
||||
apify-actorization: api-integration (confidenza: 0.59)
|
||||
apify-audience-analysis: api-integration (confidenza: 0.59)
|
||||
apify-brand-reputation-monitoring: api-integration (confidenza: 0.59)
|
||||
apify-competitor-intelligence: api-integration (confidenza: 0.59)
|
||||
apify-content-analytics: api-integration (confidenza: 0.59)
|
||||
apify-ecommerce: api-integration (confidenza: 0.59)
|
||||
apify-influencer-discovery: api-integration (confidenza: 0.59)
|
||||
apify-lead-generation: api-integration (confidenza: 0.59)
|
||||
apify-market-research: api-integration (confidenza: 0.59)
|
||||
apify-trend-analysis: api-integration (confidenza: 0.59)
|
||||
apify-ultimate-scraper: api-integration (confidenza: 0.59)
|
||||
avalonia-layout-zafiro: testing-qa (confidenza: 0.59)
|
||||
avalonia-viewmodels-zafiro: testing-qa (confidenza: 0.59)
|
||||
avalonia-zafiro-development: testing-qa (confidenza: 0.59)
|
||||
aws-agentic-ai: cloud-devops (confidenza: 0.59)
|
||||
aws-cdk-development: cloud-devops (confidenza: 0.59)
|
||||
aws-common: cloud-devops (confidenza: 0.59)
|
||||
aws-cost-cleanup: cloud-devops (confidenza: 0.59)
|
||||
aws-cost-ops: cloud-devops (confidenza: 0.59)
|
||||
aws-cost-optimizer: cloud-devops (confidenza: 0.59)
|
||||
aws-mcp-setup: cloud-devops (confidenza: 0.59)
|
||||
aws-penetration-testing: cloud-devops (confidenza: 0.59)
|
||||
aws-serverless: cloud-devops (confidenza: 0.59)
|
||||
aws-serverless-eda: cloud-devops (confidenza: 0.59)
|
||||
aws-skills: cloud-devops (confidenza: 0.59)
|
||||
coda-automation: game-development (confidenza: 0.59)
|
||||
code-documentation-code-explain: game-development (confidenza: 0.59)
|
||||
code-documentation-doc-generate: game-development (confidenza: 0.59)
|
||||
code-refactoring-context-restore: game-development (confidenza: 0.59)
|
||||
code-refactoring-refactor-clean: game-development (confidenza: 0.59)
|
||||
code-refactoring-tech-debt: game-development (confidenza: 0.59)
|
||||
code-review-ai-ai-review: game-development (confidenza: 0.59)
|
||||
code-review-checklist: game-development (confidenza: 0.59)
|
||||
code-review-excellence: game-development (confidenza: 0.59)
|
||||
code-reviewer: game-development (confidenza: 0.59)
|
||||
code-simplifier: game-development (confidenza: 0.59)
|
||||
codebase-cleanup-deps-audit: game-development (confidenza: 0.59)
|
||||
codebase-cleanup-refactor-clean: game-development (confidenza: 0.59)
|
||||
codebase-cleanup-tech-debt: game-development (confidenza: 0.59)
|
||||
codex-review: game-development (confidenza: 0.59)
|
||||
cpp-pro: languages-frameworks (confidenza: 0.59)
|
||||
daily-news-report: web3-blockchain (confidenza: 0.59)
|
||||
doc-coauthoring: documentation-content (confidenza: 0.59)
|
||||
docs-architect: documentation-content (confidenza: 0.59)
|
||||
docusign-automation: documentation-content (confidenza: 0.59)
|
||||
docx-official: documentation-content (confidenza: 0.59)
|
||||
domain-driven-design: frontend (confidenza: 0.59)
|
||||
gcp-cloud-run: cloud-devops (confidenza: 0.59)
|
||||
ios-developer: mobile (confidenza: 0.59)
|
||||
k8s-manifest-generator: cloud-devops (confidenza: 0.59)
|
||||
kpi-dashboard-design: product-business (confidenza: 0.59)
|
||||
langchain-architecture: ai-ml (confidenza: 0.59)
|
||||
langgraph: ai-ml (confidenza: 0.59)
|
||||
llm-app-patterns: ai-ml (confidenza: 0.59)
|
||||
llm-application-dev-ai-assistant: ai-ml (confidenza: 0.59)
|
||||
llm-application-dev-langchain-agent: ai-ml (confidenza: 0.59)
|
||||
llm-application-dev-prompt-optimize: ai-ml (confidenza: 0.59)
|
||||
llm-evaluation: ai-ml (confidenza: 0.59)
|
||||
llm-prompt-optimizer: ai-ml (confidenza: 0.59)
|
||||
n8n-code-javascript: workflow-automation (confidenza: 0.59)
|
||||
n8n-code-python: workflow-automation (confidenza: 0.59)
|
||||
n8n-expression-syntax: workflow-automation (confidenza: 0.59)
|
||||
n8n-mcp-tools-expert: workflow-automation (confidenza: 0.59)
|
||||
n8n-node-configuration: workflow-automation (confidenza: 0.59)
|
||||
n8n-validation-expert: workflow-automation (confidenza: 0.59)
|
||||
n8n-workflow-patterns: workflow-automation (confidenza: 0.59)
|
||||
nft-standards: web3-blockchain (confidenza: 0.59)
|
||||
pdf-official: documentation-content (confidenza: 0.59)
|
||||
php-pro: languages-frameworks (confidenza: 0.59)
|
||||
postgres-best-practices: database (confidenza: 0.59)
|
||||
postgresql: database (confidenza: 0.59)
|
||||
rag-engineer: ai-ml (confidenza: 0.59)
|
||||
red-team-tactics: languages-frameworks (confidenza: 0.59)
|
||||
red-team-tools: languages-frameworks (confidenza: 0.59)
|
||||
reddit-automation: languages-frameworks (confidenza: 0.59)
|
||||
seo-audit: marketing-growth (confidenza: 0.59)
|
||||
seo-authority-builder: marketing-growth (confidenza: 0.59)
|
||||
seo-cannibalization-detector: marketing-growth (confidenza: 0.59)
|
||||
seo-content-auditor: marketing-growth (confidenza: 0.59)
|
||||
seo-content-planner: marketing-growth (confidenza: 0.59)
|
||||
seo-content-refresher: marketing-growth (confidenza: 0.59)
|
||||
seo-content-writer: marketing-growth (confidenza: 0.59)
|
||||
seo-forensic-incident-response: marketing-growth (confidenza: 0.59)
|
||||
seo-fundamentals: marketing-growth (confidenza: 0.59)
|
||||
seo-keyword-strategist: marketing-growth (confidenza: 0.59)
|
||||
seo-meta-optimizer: marketing-growth (confidenza: 0.59)
|
||||
seo-snippet-hunter: marketing-growth (confidenza: 0.59)
|
||||
seo-structure-architect: marketing-growth (confidenza: 0.59)
|
||||
sql-optimization-patterns: database (confidenza: 0.59)
|
||||
sql-pro: database (confidenza: 0.59)
|
||||
sred-project-organizer: cloud-devops (confidenza: 0.59)
|
||||
sred-work-summary: cloud-devops (confidenza: 0.59)
|
||||
supabase-automation: database (confidenza: 0.59)
|
||||
agent-evaluation: ai-ml (confidenza: 0.60)
|
||||
agent-framework-azure-ai-py: ai-ml (confidenza: 0.60)
|
||||
agent-manager-skill: ai-ml (confidenza: 0.60)
|
||||
agent-memory-mcp: ai-ml (confidenza: 0.60)
|
||||
agent-memory-systems: ai-ml (confidenza: 0.60)
|
||||
agent-orchestration-improve-agent: ai-ml (confidenza: 0.60)
|
||||
agent-orchestration-multi-agent-optimize: ai-ml (confidenza: 0.60)
|
||||
agent-tool-builder: ai-ml (confidenza: 0.60)
|
||||
auth-implementation-patterns: security (confidenza: 0.60)
|
||||
basecamp-automation: web3-blockchain (confidenza: 0.60)
|
||||
baseline-ui: web3-blockchain (confidenza: 0.60)
|
||||
bash-defensive-patterns: languages-frameworks (confidenza: 0.60)
|
||||
bash-linux: languages-frameworks (confidenza: 0.60)
|
||||
bash-pro: languages-frameworks (confidenza: 0.60)
|
||||
bevy-ecs-expert: game-development (confidenza: 0.60)
|
||||
burp-suite-testing: security (confidenza: 0.60)
|
||||
burpsuite-project-parser: security (confidenza: 0.60)
|
||||
c-pro: languages-frameworks (confidenza: 0.60)
|
||||
defi-protocol-templates: web3-blockchain (confidenza: 0.60)
|
||||
expo-api-routes: mobile (confidenza: 0.60)
|
||||
expo-cicd-workflows: mobile (confidenza: 0.60)
|
||||
expo-deployment: mobile (confidenza: 0.60)
|
||||
expo-dev-client: mobile (confidenza: 0.60)
|
||||
expo-tailwind-setup: mobile (confidenza: 0.60)
|
||||
expo-ui-jetpack-compose: mobile (confidenza: 0.60)
|
||||
expo-ui-swift-ui: mobile (confidenza: 0.60)
|
||||
form-cro: frontend (confidenza: 0.60)
|
||||
game-development: game-development (confidenza: 0.60)
|
||||
grpc-golang: backend (confidenza: 0.60)
|
||||
helm-chart-scaffolding: cloud-devops (confidenza: 0.60)
|
||||
helpdesk-automation: product-business (confidenza: 0.60)
|
||||
idor-testing: security (confidenza: 0.60)
|
||||
java-pro: languages-frameworks (confidenza: 0.60)
|
||||
loki-mode: data-engineering (confidenza: 0.60)
|
||||
make-automation: workflow-automation (confidenza: 0.60)
|
||||
makepad-animation: workflow-automation (confidenza: 0.60)
|
||||
makepad-basics: workflow-automation (confidenza: 0.60)
|
||||
makepad-deployment: workflow-automation (confidenza: 0.60)
|
||||
makepad-dsl: workflow-automation (confidenza: 0.60)
|
||||
makepad-event-action: workflow-automation (confidenza: 0.60)
|
||||
makepad-font: workflow-automation (confidenza: 0.60)
|
||||
makepad-layout: workflow-automation (confidenza: 0.60)
|
||||
makepad-platform: workflow-automation (confidenza: 0.60)
|
||||
makepad-reference: workflow-automation (confidenza: 0.60)
|
||||
makepad-shaders: workflow-automation (confidenza: 0.60)
|
||||
makepad-skills: workflow-automation (confidenza: 0.60)
|
||||
makepad-splash: workflow-automation (confidenza: 0.60)
|
||||
makepad-widgets: workflow-automation (confidenza: 0.60)
|
||||
modern-javascript-patterns: data-engineering (confidenza: 0.60)
|
||||
pptx-official: documentation-content (confidenza: 0.60)
|
||||
risk-manager: security (confidenza: 0.60)
|
||||
risk-metrics-calculation: security (confidenza: 0.60)
|
||||
risk-modeling: security (confidenza: 0.60)
|
||||
ruby-pro: languages-frameworks (confidenza: 0.60)
|
||||
rust-async-patterns: languages-frameworks (confidenza: 0.60)
|
||||
rust-pro: languages-frameworks (confidenza: 0.60)
|
||||
saga-orchestration: api-integration (confidenza: 0.60)
|
||||
sast-configuration: security (confidenza: 0.60)
|
||||
skin-health-analyzer: product-business (confidenza: 0.60)
|
||||
test-automator: testing-qa (confidenza: 0.60)
|
||||
test-driven-development: testing-qa (confidenza: 0.60)
|
||||
test-fixing: testing-qa (confidenza: 0.60)
|
||||
wiki-architect: product-business (confidenza: 0.60)
|
||||
wiki-changelog: product-business (confidenza: 0.60)
|
||||
wiki-onboarding: product-business (confidenza: 0.60)
|
||||
wiki-page-writer: product-business (confidenza: 0.60)
|
||||
wiki-qa: product-business (confidenza: 0.60)
|
||||
wiki-researcher: product-business (confidenza: 0.60)
|
||||
wiki-vitepress: product-business (confidenza: 0.60)
|
||||
xlsx-official: documentation-content (confidenza: 0.60)
|
||||
zeroize-audit: web3-blockchain (confidenza: 0.60)
|
||||
zoom-automation: product-business (confidenza: 0.60)
|
||||
astropy: web3-blockchain (confidenza: 0.61)
|
||||
azure-ai-agents-persistent-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-agents-persistent-java: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-anomalydetector-java: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-contentsafety-java: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-contentsafety-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-contentsafety-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-contentunderstanding-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-document-intelligence-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-document-intelligence-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-formrecognizer-java: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-ml-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-openai-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-projects-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-projects-java: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-projects-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-projects-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-textanalytics-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-transcription-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-translation-document-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-translation-text-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-translation-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-vision-imageanalysis-java: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-vision-imageanalysis-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-voicelive-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-voicelive-java: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-voicelive-py: cloud-devops (confidenza: 0.61)
|
||||
azure-ai-voicelive-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-appconfiguration-java: cloud-devops (confidenza: 0.61)
|
||||
azure-appconfiguration-py: cloud-devops (confidenza: 0.61)
|
||||
azure-appconfiguration-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-communication-callautomation-java: cloud-devops (confidenza: 0.61)
|
||||
azure-communication-callingserver-java: cloud-devops (confidenza: 0.61)
|
||||
azure-communication-chat-java: cloud-devops (confidenza: 0.61)
|
||||
azure-communication-common-java: cloud-devops (confidenza: 0.61)
|
||||
azure-communication-sms-java: cloud-devops (confidenza: 0.61)
|
||||
azure-compute-batch-java: cloud-devops (confidenza: 0.61)
|
||||
azure-containerregistry-py: cloud-devops (confidenza: 0.61)
|
||||
azure-cosmos-db-py: cloud-devops (confidenza: 0.61)
|
||||
azure-cosmos-java: cloud-devops (confidenza: 0.61)
|
||||
azure-cosmos-py: cloud-devops (confidenza: 0.61)
|
||||
azure-cosmos-rust: cloud-devops (confidenza: 0.61)
|
||||
azure-cosmos-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-data-tables-java: cloud-devops (confidenza: 0.61)
|
||||
azure-data-tables-py: cloud-devops (confidenza: 0.61)
|
||||
azure-eventgrid-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-eventgrid-java: cloud-devops (confidenza: 0.61)
|
||||
azure-eventgrid-py: cloud-devops (confidenza: 0.61)
|
||||
azure-eventhub-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-eventhub-java: cloud-devops (confidenza: 0.61)
|
||||
azure-eventhub-py: cloud-devops (confidenza: 0.61)
|
||||
azure-eventhub-rust: cloud-devops (confidenza: 0.61)
|
||||
azure-eventhub-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-functions: cloud-devops (confidenza: 0.61)
|
||||
azure-identity-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-identity-java: cloud-devops (confidenza: 0.61)
|
||||
azure-identity-py: cloud-devops (confidenza: 0.61)
|
||||
azure-identity-rust: cloud-devops (confidenza: 0.61)
|
||||
azure-identity-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-keyvault-certificates-rust: cloud-devops (confidenza: 0.61)
|
||||
azure-keyvault-keys-rust: cloud-devops (confidenza: 0.61)
|
||||
azure-keyvault-keys-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-keyvault-py: cloud-devops (confidenza: 0.61)
|
||||
azure-keyvault-secrets-rust: cloud-devops (confidenza: 0.61)
|
||||
azure-keyvault-secrets-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-maps-search-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-messaging-webpubsub-java: cloud-devops (confidenza: 0.61)
|
||||
azure-messaging-webpubsubservice-py: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-apicenter-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-apicenter-py: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-apimanagement-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-apimanagement-py: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-applicationinsights-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-arizeaiobservabilityeval-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-botservice-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-botservice-py: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-fabric-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-fabric-py: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-mongodbatlas-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-mgmt-weightsandbiases-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-microsoft-playwright-testing-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-monitor-ingestion-java: cloud-devops (confidenza: 0.61)
|
||||
azure-monitor-ingestion-py: cloud-devops (confidenza: 0.61)
|
||||
azure-monitor-opentelemetry-exporter-java: cloud-devops (confidenza: 0.61)
|
||||
azure-monitor-opentelemetry-exporter-py: cloud-devops (confidenza: 0.61)
|
||||
azure-monitor-opentelemetry-py: cloud-devops (confidenza: 0.61)
|
||||
azure-monitor-opentelemetry-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-monitor-query-java: cloud-devops (confidenza: 0.61)
|
||||
azure-monitor-query-py: cloud-devops (confidenza: 0.61)
|
||||
azure-postgres-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-resource-manager-cosmosdb-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-resource-manager-durabletask-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-resource-manager-mysql-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-resource-manager-playwright-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-resource-manager-postgresql-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-resource-manager-redis-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-resource-manager-sql-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-search-documents-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-search-documents-py: cloud-devops (confidenza: 0.61)
|
||||
azure-search-documents-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-servicebus-dotnet: cloud-devops (confidenza: 0.61)
|
||||
azure-servicebus-py: cloud-devops (confidenza: 0.61)
|
||||
azure-servicebus-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-speech-to-text-rest-py: cloud-devops (confidenza: 0.61)
|
||||
azure-storage-blob-java: cloud-devops (confidenza: 0.61)
|
||||
azure-storage-blob-py: cloud-devops (confidenza: 0.61)
|
||||
azure-storage-blob-rust: cloud-devops (confidenza: 0.61)
|
||||
azure-storage-blob-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-storage-file-datalake-py: cloud-devops (confidenza: 0.61)
|
||||
azure-storage-file-share-py: cloud-devops (confidenza: 0.61)
|
||||
azure-storage-file-share-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-storage-queue-py: cloud-devops (confidenza: 0.61)
|
||||
azure-storage-queue-ts: cloud-devops (confidenza: 0.61)
|
||||
azure-web-pubsub-ts: cloud-devops (confidenza: 0.61)
|
||||
cloud-architect: cloud-devops (confidenza: 0.61)
|
||||
cloud-penetration-testing: cloud-devops (confidenza: 0.61)
|
||||
cloudflare-workers-expert: cloud-devops (confidenza: 0.61)
|
||||
cloudformation-best-practices: cloud-devops (confidenza: 0.61)
|
||||
email-sequence: marketing-growth (confidenza: 0.61)
|
||||
email-systems: marketing-growth (confidenza: 0.61)
|
||||
event-sourcing-architect: product-business (confidenza: 0.61)
|
||||
event-store-design: product-business (confidenza: 0.61)
|
||||
figma-automation: frontend (confidenza: 0.61)
|
||||
imagen: cloud-devops (confidenza: 0.61)
|
||||
istio-traffic-management: backend (confidenza: 0.61)
|
||||
julia-pro: languages-frameworks (confidenza: 0.61)
|
||||
linear-automation: web3-blockchain (confidenza: 0.61)
|
||||
linear-claude-skill: web3-blockchain (confidenza: 0.61)
|
||||
nosql-expert: database (confidenza: 0.61)
|
||||
radix-ui-design-system: frontend (confidenza: 0.61)
|
||||
react-best-practices: frontend (confidenza: 0.61)
|
||||
react-flow-architect: frontend (confidenza: 0.61)
|
||||
react-flow-node-ts: frontend (confidenza: 0.61)
|
||||
react-modernization: frontend (confidenza: 0.61)
|
||||
react-native-architecture: frontend (confidenza: 0.61)
|
||||
react-patterns: frontend (confidenza: 0.61)
|
||||
react-state-management: frontend (confidenza: 0.61)
|
||||
react-ui-patterns: frontend (confidenza: 0.61)
|
||||
sales-automator: product-business (confidenza: 0.61)
|
||||
salesforce-automation: product-business (confidenza: 0.61)
|
||||
salesforce-development: product-business (confidenza: 0.61)
|
||||
scala-pro: languages-frameworks (confidenza: 0.61)
|
||||
shellcheck-configuration: languages-frameworks (confidenza: 0.61)
|
||||
slack-automation: product-business (confidenza: 0.61)
|
||||
slack-bot-builder: product-business (confidenza: 0.61)
|
||||
slack-gif-creator: product-business (confidenza: 0.61)
|
||||
spark-optimization: data-engineering (confidenza: 0.61)
|
||||
swiftui-expert-skill: mobile (confidenza: 0.61)
|
||||
theme-factory: frontend (confidenza: 0.61)
|
||||
unity-developer: game-development (confidenza: 0.61)
|
||||
unity-ecs-patterns: game-development (confidenza: 0.61)
|
||||
viral-generator-builder: marketing-growth (confidenza: 0.61)
|
||||
ab-test-setup: marketing-growth (confidenza: 0.62)
|
||||
bamboohr-automation: cloud-devops (confidenza: 0.62)
|
||||
canvas-design: frontend (confidenza: 0.62)
|
||||
claude-ally-health: ai-ml (confidenza: 0.62)
|
||||
claude-code-guide: ai-ml (confidenza: 0.62)
|
||||
claude-d3js-skill: ai-ml (confidenza: 0.62)
|
||||
claude-in-chrome-troubleshooting: ai-ml (confidenza: 0.62)
|
||||
claude-scientific-skills: ai-ml (confidenza: 0.62)
|
||||
claude-settings-audit: ai-ml (confidenza: 0.62)
|
||||
claude-speed-reader: ai-ml (confidenza: 0.62)
|
||||
claude-win11-speckit-update-skill: ai-ml (confidenza: 0.62)
|
||||
commit: cloud-devops (confidenza: 0.62)
|
||||
convex: web3-blockchain (confidenza: 0.62)
|
||||
crypto-bd-agent: web3-blockchain (confidenza: 0.62)
|
||||
csharp-pro: languages-frameworks (confidenza: 0.62)
|
||||
devops-troubleshooter: cloud-devops (confidenza: 0.62)
|
||||
django-access-review: backend (confidenza: 0.62)
|
||||
django-perf-review: backend (confidenza: 0.62)
|
||||
django-pro: backend (confidenza: 0.62)
|
||||
dotnet-architect: languages-frameworks (confidenza: 0.62)
|
||||
dotnet-backend: languages-frameworks (confidenza: 0.62)
|
||||
dotnet-backend-patterns: languages-frameworks (confidenza: 0.62)
|
||||
elixir-pro: languages-frameworks (confidenza: 0.62)
|
||||
gemini-api-dev: ai-ml (confidenza: 0.62)
|
||||
gemini-api-integration: ai-ml (confidenza: 0.62)
|
||||
kotlin-coroutines-expert: mobile (confidenza: 0.62)
|
||||
mobile-design: mobile (confidenza: 0.62)
|
||||
mobile-developer: mobile (confidenza: 0.62)
|
||||
nextjs-app-router-patterns: frontend (confidenza: 0.62)
|
||||
nextjs-best-practices: frontend (confidenza: 0.62)
|
||||
nextjs-supabase-auth: frontend (confidenza: 0.62)
|
||||
nodejs-backend-patterns: backend (confidenza: 0.62)
|
||||
nodejs-best-practices: backend (confidenza: 0.62)
|
||||
pentest-checklist: security (confidenza: 0.62)
|
||||
pentest-commands: security (confidenza: 0.62)
|
||||
prompt-caching: ai-ml (confidenza: 0.62)
|
||||
prompt-engineering: ai-ml (confidenza: 0.62)
|
||||
prompt-engineering-patterns: ai-ml (confidenza: 0.62)
|
||||
prompt-library: ai-ml (confidenza: 0.62)
|
||||
python-development-python-scaffold: languages-frameworks (confidenza: 0.62)
|
||||
python-packaging: languages-frameworks (confidenza: 0.62)
|
||||
python-patterns: languages-frameworks (confidenza: 0.62)
|
||||
python-performance-optimization: languages-frameworks (confidenza: 0.62)
|
||||
python-pro: languages-frameworks (confidenza: 0.62)
|
||||
readme: documentation-content (confidenza: 0.62)
|
||||
render-automation: cloud-devops (confidenza: 0.62)
|
||||
schema-markup: database (confidenza: 0.62)
|
||||
scroll-experience: web3-blockchain (confidenza: 0.62)
|
||||
shodan-reconnaissance: security (confidenza: 0.62)
|
||||
social-content: marketing-growth (confidenza: 0.62)
|
||||
sqlmap-database-pentesting: security (confidenza: 0.62)
|
||||
stitch-loop: data-engineering (confidenza: 0.62)
|
||||
stitch-ui-design: data-engineering (confidenza: 0.62)
|
||||
threat-mitigation-mapping: security (confidenza: 0.62)
|
||||
threat-modeling-expert: security (confidenza: 0.62)
|
||||
unreal-engine-cpp-pro: game-development (confidenza: 0.62)
|
||||
vector-database-engineer: ai-ml (confidenza: 0.62)
|
||||
vector-index-tuning: ai-ml (confidenza: 0.62)
|
||||
vercel-automation: cloud-devops (confidenza: 0.62)
|
||||
vercel-deploy-claimable: cloud-devops (confidenza: 0.62)
|
||||
vercel-deployment: cloud-devops (confidenza: 0.62)
|
||||
zapier-make-patterns: workflow-automation (confidenza: 0.62)
|
||||
android-jetpack-compose-expert: mobile (confidenza: 0.63)
|
||||
android_ui_verification: mobile (confidenza: 0.63)
|
||||
angular: frontend (confidenza: 0.63)
|
||||
angular-best-practices: frontend (confidenza: 0.63)
|
||||
angular-migration: frontend (confidenza: 0.63)
|
||||
angular-state-management: frontend (confidenza: 0.63)
|
||||
angular-ui-patterns: frontend (confidenza: 0.63)
|
||||
backend-architect: backend (confidenza: 0.63)
|
||||
backend-dev-guidelines: backend (confidenza: 0.63)
|
||||
backend-development-feature-development: backend (confidenza: 0.63)
|
||||
browser-automation: frontend (confidenza: 0.63)
|
||||
browser-extension-builder: frontend (confidenza: 0.63)
|
||||
datadog-automation: data-engineering (confidenza: 0.63)
|
||||
discord-automation: product-business (confidenza: 0.63)
|
||||
discord-bot-architect: product-business (confidenza: 0.63)
|
||||
fastapi-pro: backend (confidenza: 0.63)
|
||||
fastapi-router-py: backend (confidenza: 0.63)
|
||||
fastapi-templates: backend (confidenza: 0.63)
|
||||
flutter-expert: mobile (confidenza: 0.63)
|
||||
grafana-dashboards: data-engineering (confidenza: 0.63)
|
||||
graphql: api-integration (confidenza: 0.63)
|
||||
graphql-architect: api-integration (confidenza: 0.63)
|
||||
haskell-pro: languages-frameworks (confidenza: 0.63)
|
||||
jupyter-workflow: data-engineering (confidenza: 0.63)
|
||||
laravel-expert: backend (confidenza: 0.63)
|
||||
linkerd-patterns: backend (confidenza: 0.63)
|
||||
openapi-spec-generation: backend (confidenza: 0.63)
|
||||
pricing-strategy: product-business (confidenza: 0.63)
|
||||
programmatic-seo: product-business (confidenza: 0.63)
|
||||
project-development: product-business (confidenza: 0.63)
|
||||
projection-patterns: product-business (confidenza: 0.63)
|
||||
segment-automation: data-engineering (confidenza: 0.63)
|
||||
segment-cdp: data-engineering (confidenza: 0.63)
|
||||
service-mesh-expert: product-business (confidenza: 0.63)
|
||||
service-mesh-observability: product-business (confidenza: 0.63)
|
||||
startup-analyst: product-business (confidenza: 0.63)
|
||||
startup-business-analyst-business-case: product-business (confidenza: 0.63)
|
||||
startup-business-analyst-financial-projections: product-business (confidenza: 0.63)
|
||||
startup-business-analyst-market-opportunity: product-business (confidenza: 0.63)
|
||||
startup-financial-modeling: product-business (confidenza: 0.63)
|
||||
startup-metrics-framework: product-business (confidenza: 0.63)
|
||||
trigger-dev: database (confidenza: 0.63)
|
||||
writing-plans: documentation-content (confidenza: 0.63)
|
||||
app-store-optimization: mobile (confidenza: 0.64)
|
||||
business-analyst: product-business (confidenza: 0.64)
|
||||
circleci-automation: cloud-devops (confidenza: 0.64)
|
||||
database-admin: database (confidenza: 0.64)
|
||||
database-architect: database (confidenza: 0.64)
|
||||
database-cloud-optimization-cost-optimize: database (confidenza: 0.64)
|
||||
database-design: database (confidenza: 0.64)
|
||||
database-migration: database (confidenza: 0.64)
|
||||
database-migrations-migration-observability: database (confidenza: 0.64)
|
||||
database-migrations-sql-migrations: database (confidenza: 0.64)
|
||||
database-optimizer: database (confidenza: 0.64)
|
||||
frontend-design: frontend (confidenza: 0.64)
|
||||
frontend-dev-guidelines: frontend (confidenza: 0.64)
|
||||
frontend-developer: frontend (confidenza: 0.64)
|
||||
frontend-mobile-development-component-scaffold: frontend (confidenza: 0.64)
|
||||
frontend-slides: frontend (confidenza: 0.64)
|
||||
frontend-ui-dark-ts: frontend (confidenza: 0.64)
|
||||
gitlab-ci-patterns: cloud-devops (confidenza: 0.64)
|
||||
incident-responder: infrastructure-sre (confidenza: 0.64)
|
||||
incident-response-incident-response: infrastructure-sre (confidenza: 0.64)
|
||||
incident-response-smart-fix: infrastructure-sre (confidenza: 0.64)
|
||||
incident-runbook-templates: infrastructure-sre (confidenza: 0.64)
|
||||
linkedin-automation: data-engineering (confidenza: 0.64)
|
||||
linkedin-cli: data-engineering (confidenza: 0.64)
|
||||
planning-with-files: product-business (confidenza: 0.64)
|
||||
referral-program: marketing-growth (confidenza: 0.64)
|
||||
tailwind-design-system: frontend (confidenza: 0.64)
|
||||
tailwind-patterns: frontend (confidenza: 0.64)
|
||||
telegram-automation: product-business (confidenza: 0.64)
|
||||
telegram-bot-builder: product-business (confidenza: 0.64)
|
||||
telegram-mini-app: product-business (confidenza: 0.64)
|
||||
temporal-golang-pro: data-engineering (confidenza: 0.64)
|
||||
temporal-python-pro: data-engineering (confidenza: 0.64)
|
||||
temporal-python-testing: data-engineering (confidenza: 0.64)
|
||||
tutorial-engineer: product-business (confidenza: 0.64)
|
||||
whatsapp-automation: product-business (confidenza: 0.64)
|
||||
workflow-automation: product-business (confidenza: 0.64)
|
||||
workflow-patterns: product-business (confidenza: 0.64)
|
||||
workflow-skill-design: product-business (confidenza: 0.64)
|
||||
algorithmic-art: product-business (confidenza: 0.65)
|
||||
amplitude-automation: game-development (confidenza: 0.65)
|
||||
conductor-implement: data-engineering (confidenza: 0.65)
|
||||
conductor-manage: data-engineering (confidenza: 0.65)
|
||||
conductor-new-track: data-engineering (confidenza: 0.65)
|
||||
conductor-revert: data-engineering (confidenza: 0.65)
|
||||
conductor-setup: data-engineering (confidenza: 0.65)
|
||||
conductor-status: data-engineering (confidenza: 0.65)
|
||||
conductor-validator: data-engineering (confidenza: 0.65)
|
||||
embedding-strategies: ai-ml (confidenza: 0.65)
|
||||
evolution: game-development (confidenza: 0.65)
|
||||
framework-migration-code-migrate: product-business (confidenza: 0.65)
|
||||
framework-migration-deps-upgrade: product-business (confidenza: 0.65)
|
||||
framework-migration-legacy-modernize: product-business (confidenza: 0.65)
|
||||
marketing-ideas: marketing-growth (confidenza: 0.65)
|
||||
marketing-psychology: marketing-growth (confidenza: 0.65)
|
||||
minecraft-bukkit-pro: game-development (confidenza: 0.65)
|
||||
terraform-aws-modules: cloud-devops (confidenza: 0.65)
|
||||
terraform-module-library: cloud-devops (confidenza: 0.65)
|
||||
terraform-skill: cloud-devops (confidenza: 0.65)
|
||||
terraform-specialist: cloud-devops (confidenza: 0.65)
|
||||
web-design-guidelines: frontend (confidenza: 0.65)
|
||||
wireshark-analysis: security (confidenza: 0.65)
|
||||
3d-web-experience: 3d-web (confidenza: 0.66)
|
||||
active-directory-attacks: security (confidenza: 0.66)
|
||||
attack-tree-construction: security (confidenza: 0.66)
|
||||
blockchain-developer: web3-blockchain (confidenza: 0.66)
|
||||
deployment-engineer: product-business (confidenza: 0.66)
|
||||
deployment-pipeline-design: product-business (confidenza: 0.66)
|
||||
deployment-procedures: product-business (confidenza: 0.66)
|
||||
deployment-validation-config-validate: product-business (confidenza: 0.66)
|
||||
evaluation: ai-ml (confidenza: 0.66)
|
||||
javascript-mastery: languages-frameworks (confidenza: 0.66)
|
||||
javascript-pro: languages-frameworks (confidenza: 0.66)
|
||||
javascript-typescript-typescript-scaffold: languages-frameworks (confidenza: 0.66)
|
||||
kubernetes-architect: cloud-devops (confidenza: 0.66)
|
||||
metasploit-framework: security (confidenza: 0.66)
|
||||
multi-cloud-architecture: cloud-devops (confidenza: 0.66)
|
||||
playwright-skill: testing-qa (confidenza: 0.66)
|
||||
powershell-windows: languages-frameworks (confidenza: 0.66)
|
||||
prometheus-configuration: data-engineering (confidenza: 0.66)
|
||||
typescript-advanced-types: languages-frameworks (confidenza: 0.66)
|
||||
typescript-pro: languages-frameworks (confidenza: 0.66)
|
||||
api-testing-observability-api-mock: testing-qa (confidenza: 0.67)
|
||||
backtesting-frameworks: testing-qa (confidenza: 0.67)
|
||||
bats-testing-patterns: testing-qa (confidenza: 0.67)
|
||||
data-quality-frameworks: data-engineering (confidenza: 0.67)
|
||||
e2e-testing-patterns: testing-qa (confidenza: 0.67)
|
||||
ethical-hacking-methodology: security (confidenza: 0.67)
|
||||
hybrid-cloud-architect: cloud-devops (confidenza: 0.67)
|
||||
hybrid-cloud-networking: cloud-devops (confidenza: 0.67)
|
||||
javascript-testing-patterns: testing-qa (confidenza: 0.67)
|
||||
malware-analyst: security (confidenza: 0.67)
|
||||
performance-engineer: product-business (confidenza: 0.67)
|
||||
performance-profiling: product-business (confidenza: 0.67)
|
||||
performance-testing-review-ai-review: testing-qa (confidenza: 0.67)
|
||||
performance-testing-review-multi-agent-review: testing-qa (confidenza: 0.67)
|
||||
python-testing-patterns: testing-qa (confidenza: 0.67)
|
||||
screen-reader-testing: testing-qa (confidenza: 0.67)
|
||||
smtp-penetration-testing: testing-qa (confidenza: 0.67)
|
||||
ssh-penetration-testing: testing-qa (confidenza: 0.67)
|
||||
testing-handbook-skills: testing-qa (confidenza: 0.67)
|
||||
testing-patterns: testing-qa (confidenza: 0.67)
|
||||
unit-testing-test-generate: testing-qa (confidenza: 0.67)
|
||||
web3-testing: testing-qa (confidenza: 0.67)
|
||||
webapp-testing: testing-qa (confidenza: 0.67)
|
||||
wordpress-penetration-testing: testing-qa (confidenza: 0.67)
|
||||
api-security-best-practices: security (confidenza: 0.68)
|
||||
azure-security-keyvault-keys-dotnet: security (confidenza: 0.68)
|
||||
azure-security-keyvault-keys-java: security (confidenza: 0.68)
|
||||
azure-security-keyvault-secrets-java: security (confidenza: 0.68)
|
||||
backend-security-coder: security (confidenza: 0.68)
|
||||
cc-skill-security-review: security (confidenza: 0.68)
|
||||
data-engineer: data-engineering (confidenza: 0.68)
|
||||
data-engineering-data-driven-feature: data-engineering (confidenza: 0.68)
|
||||
data-engineering-data-pipeline: data-engineering (confidenza: 0.68)
|
||||
frontend-mobile-security-xss-scan: security (confidenza: 0.68)
|
||||
frontend-security-coder: security (confidenza: 0.68)
|
||||
gha-security-review: security (confidenza: 0.68)
|
||||
golang-security-auditor: security (confidenza: 0.68)
|
||||
k8s-security-policies: security (confidenza: 0.68)
|
||||
laravel-security-audit: security (confidenza: 0.68)
|
||||
mobile-security-coder: security (confidenza: 0.68)
|
||||
odoo-security-rules: security (confidenza: 0.68)
|
||||
python-security-auditor: security (confidenza: 0.68)
|
||||
rust-security-auditor: security (confidenza: 0.68)
|
||||
scanning-tools: security (confidenza: 0.68)
|
||||
security-auditor: security (confidenza: 0.68)
|
||||
security-bluebook-builder: security (confidenza: 0.68)
|
||||
security-compliance-compliance-check: security (confidenza: 0.68)
|
||||
security-requirement-extraction: security (confidenza: 0.68)
|
||||
security-scanning-security-dependencies: security (confidenza: 0.68)
|
||||
security-scanning-security-hardening: security (confidenza: 0.68)
|
||||
security-scanning-security-sast: security (confidenza: 0.68)
|
||||
security-skill-creator: security (confidenza: 0.68)
|
||||
skill-creator-ms: meta (confidenza: 0.68)
|
||||
solidity-security: security (confidenza: 0.68)
|
||||
threejs-animation: 3d-web (confidenza: 0.68)
|
||||
threejs-fundamentals: 3d-web (confidenza: 0.68)
|
||||
threejs-geometry: 3d-web (confidenza: 0.68)
|
||||
threejs-interaction: 3d-web (confidenza: 0.68)
|
||||
threejs-lighting: 3d-web (confidenza: 0.68)
|
||||
threejs-loaders: 3d-web (confidenza: 0.68)
|
||||
threejs-materials: 3d-web (confidenza: 0.68)
|
||||
threejs-postprocessing: 3d-web (confidenza: 0.68)
|
||||
threejs-shaders: 3d-web (confidenza: 0.68)
|
||||
threejs-skills: 3d-web (confidenza: 0.68)
|
||||
threejs-textures: 3d-web (confidenza: 0.68)
|
||||
anti-reversing-techniques: security (confidenza: 0.69)
|
||||
documentation-generation-doc-generate: product-business (confidenza: 0.69)
|
||||
documentation-templates: product-business (confidenza: 0.69)
|
||||
github-actions-templates: cloud-devops (confidenza: 0.69)
|
||||
html-injection-testing: security (confidenza: 0.69)
|
||||
memory-forensics: security (confidenza: 0.69)
|
||||
microservices-patterns: backend (confidenza: 0.69)
|
||||
observability-engineer: infrastructure-sre (confidenza: 0.69)
|
||||
observability-monitoring-monitor-setup: infrastructure-sre (confidenza: 0.69)
|
||||
observability-monitoring-slo-implement: infrastructure-sre (confidenza: 0.69)
|
||||
sql-injection-testing: security (confidenza: 0.69)
|
||||
xss-html-injection: security (confidenza: 0.69)
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
SKILLS NON CATEGORIZZATE (472)
|
||||
--------------------------------------------------------------------------------
|
||||
accessibility-compliance-accessibility-audit
|
||||
activecampaign-automation
|
||||
address-github-comments
|
||||
advanced-evaluation
|
||||
agentfolio
|
||||
agentic-actions-auditor
|
||||
agentmail
|
||||
agents-md
|
||||
agents-v2-py
|
||||
algolia-search
|
||||
alpha-vantage
|
||||
analytics-tracking
|
||||
antigravity-workflows
|
||||
app-builder
|
||||
appdeploy
|
||||
application-performance-performance-optimization
|
||||
architect-review
|
||||
architecture
|
||||
architecture-decision-records
|
||||
architecture-patterns
|
||||
arm-cortex-expert
|
||||
asana-automation
|
||||
ask-questions-if-underspecified
|
||||
async-python-patterns
|
||||
audit-context-building
|
||||
automate-whatsapp
|
||||
autonomous-agent-patterns
|
||||
autonomous-agents
|
||||
azd-deployment
|
||||
bazel-build-optimization
|
||||
bdi-mental-states
|
||||
beautiful-prose
|
||||
behavioral-modes
|
||||
billing-automation
|
||||
binary-analysis-patterns
|
||||
biopython
|
||||
bitbucket-automation
|
||||
blockrun
|
||||
blog-writing-guide
|
||||
box-automation
|
||||
brainstorming
|
||||
brand-guidelines
|
||||
brand-guidelines-anthropic
|
||||
brand-guidelines-community
|
||||
brevo-automation
|
||||
broken-authentication
|
||||
build
|
||||
building-native-ui
|
||||
building-secure-contracts
|
||||
bullmq-specialist
|
||||
... e altre 422
|
||||
|
||||
================================================================================
|
||||
4119
categorize_skills.py
Normal file
4119
categorize_skills.py
Normal file
File diff suppressed because it is too large
Load Diff
@@ -1,69 +1,3 @@
|
||||
# Repo coherence and correctness audit
|
||||
# Audit
|
||||
|
||||
This document summarizes the audit performed to verify correctness and coherence across the repository.
|
||||
|
||||
## Scope
|
||||
|
||||
- Conteggi e numeri (README, package.json, CATALOG)
|
||||
- Validazione skill (frontmatter, risk, "When to Use", link)
|
||||
- Riferimenti incrociati (workflows.json, bundles.json, BUNDLES.md)
|
||||
- Documentazione (QUALITY_BAR, SKILL_ANATOMY, security/licenses)
|
||||
- Script e build (validate, index, readme, catalog, test)
|
||||
- Note su data/ e test YAML
|
||||
|
||||
## Outcomes
|
||||
|
||||
### 1. Conteggi
|
||||
|
||||
- **package.json** `description` aggiornato da "845+" a "883+ agentic skills".
|
||||
- README e CATALOG già allineati a 883; `npm run chain` e `npm run catalog` mantengono coerenza.
|
||||
|
||||
### 2. Validazione skill
|
||||
|
||||
- **validate_skills.py**: aggiunto `unknown` a `valid_risk_levels` per compatibilità con skill esistenti (790+ con `risk: unknown`).
|
||||
- Aggiunta sezione "## When to Use" a 6 skill che ne erano sprovvisti: context-compression, content-creator, tailwind-patterns, nodejs-best-practices, python-patterns, mcp-builder-ms.
|
||||
- Corretto frontmatter multilinea in: brainstorming, agents-v2-py, hosted-agents-v2-py (description in una riga, ≤200 caratteri).
|
||||
- `npm run validate` e `npm run validate:strict` passano senza errori.
|
||||
|
||||
### 3. Riferimenti incrociati
|
||||
|
||||
- Aggiunto **scripts/validate_references.py** che verifica:
|
||||
- ogni `recommendedSkills` in data/workflows.json esiste in skills/;
|
||||
- ogni `relatedBundles` esiste in data/bundles.json;
|
||||
- ogni slug in data/bundles.json (skills list) esiste in skills/;
|
||||
- ogni link `../skills/...` in docs/BUNDLES.md punta a uno skill esistente.
|
||||
- Esecuzione: `python3 scripts/validate_references.py`. Esito: tutti i riferimenti validi.
|
||||
|
||||
### 4. Documentazione
|
||||
|
||||
- **docs/QUALITY_BAR.md**: documentato che `risk` può essere anche `unknown` (per legacy/unclassified).
|
||||
- **docs/SKILL_ANATOMY.md**: allineata lunghezza description a 200 caratteri (come da validator).
|
||||
- SECURITY_GUARDRAILS, LICENSE, README link verificati.
|
||||
|
||||
### 5. Script e build
|
||||
|
||||
- **npm run build** (chain + catalog) esegue con successo.
|
||||
- **npm test**: il test `validate_skills_headings.test.js` richiedeva YAML frontmatter valido per tutti gli skill; molti skill hanno frontmatter multilinea che il parser YAML strict segnala. Il test è stato modificato per loggare warning invece di far fallire la suite; lo schema (name, description, risk, ecc.) resta verificato da `validate_skills.py`.
|
||||
- **.github/MAINTENANCE.md**: aggiunta nota su `data/package.json` (legacy; gli script usano la root).
|
||||
|
||||
### 6. Deliverable
|
||||
|
||||
- Numeri allineati (package.json 883+).
|
||||
- Zero errori da `npm run validate` e `npm run validate:strict`.
|
||||
- Riferimenti in workflows/bundles e link in BUNDLES.md verificati tramite `validate_references.py`.
|
||||
- Report in questo file (docs/AUDIT.md).
|
||||
|
||||
## Comandi utili
|
||||
|
||||
```bash
|
||||
npm run validate # validazione skill (soft)
|
||||
npm run validate:strict # validazione skill (CI)
|
||||
python3 scripts/validate_references.py # riferimenti workflows/bundles/BUNDLES.md
|
||||
npm run build # chain + catalog
|
||||
npm test # suite test
|
||||
```
|
||||
|
||||
## Issue aperte / follow-up
|
||||
|
||||
- Normalizzare frontmatter YAML in skill con description multilinea (opzionale, in batch) per far passare un eventuale test strict YAML in futuro.
|
||||
- Aggiornare CHANGELOG con voci "860+", "845+" se si vuole coerenza storica (opzionale).
|
||||
This document moved to [`maintainers/audit.md`](maintainers/audit.md).
|
||||
|
||||
465
docs/BUNDLES.md
465
docs/BUNDLES.md
@@ -1,464 +1,3 @@
|
||||
# 📦 Antigravity Skill Bundles
|
||||
# Bundles
|
||||
|
||||
> **Curated collections of skills organized by role and expertise level.** Don't know where to start? Pick a bundle below to get a curated set of skills for your role.
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
1. **Install the repository:**
|
||||
|
||||
```bash
|
||||
npx antigravity-awesome-skills
|
||||
# or clone manually
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
2. **Choose your bundle** from the list below based on your role or interests.
|
||||
|
||||
3. **Use skills** by referencing them in your AI assistant:
|
||||
- Claude Code: `>> /skill-name help me...`
|
||||
- Cursor: `@skill-name in chat`
|
||||
- Gemini CLI: `Use skill-name...`
|
||||
- Codex CLI: `Use skill-name...`
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Essentials & Core
|
||||
|
||||
### 🚀 The "Essentials" Starter Pack
|
||||
|
||||
_For everyone. Install these first._
|
||||
|
||||
- [`concise-planning`](../skills/concise-planning/): Always start with a plan.
|
||||
- [`lint-and-validate`](../skills/lint-and-validate/): Keep your code clean automatically.
|
||||
- [`git-pushing`](../skills/git-pushing/): Save your work safely.
|
||||
- [`kaizen`](../skills/kaizen/): Continuous improvement mindset.
|
||||
- [`systematic-debugging`](../skills/systematic-debugging/): Debug like a pro.
|
||||
|
||||
---
|
||||
|
||||
## 🛡️ Security & Compliance
|
||||
|
||||
### 🛡️ The "Security Engineer" Pack
|
||||
|
||||
_For pentesting, auditing, and hardening._
|
||||
|
||||
- [`ethical-hacking-methodology`](../skills/ethical-hacking-methodology/): The Bible of ethical hacking.
|
||||
- [`burp-suite-testing`](../skills/burp-suite-testing/): Web vulnerability scanning.
|
||||
- [`top-web-vulnerabilities`](../skills/top-web-vulnerabilities/): OWASP-aligned vulnerability taxonomy.
|
||||
- [`linux-privilege-escalation`](../skills/linux-privilege-escalation/): Advanced Linux security assessment.
|
||||
- [`cloud-penetration-testing`](../skills/cloud-penetration-testing/): AWS/Azure/GCP security.
|
||||
- [`security-auditor`](../skills/security-auditor/): Comprehensive security audits.
|
||||
- [`vulnerability-scanner`](../skills/vulnerability-scanner/): Advanced vulnerability analysis.
|
||||
|
||||
### 🔐 The "Security Developer" Pack
|
||||
|
||||
_For building secure applications._
|
||||
|
||||
- [`api-security-best-practices`](../skills/api-security-best-practices/): Secure API design patterns.
|
||||
- [`auth-implementation-patterns`](../skills/auth-implementation-patterns/): JWT, OAuth2, session management.
|
||||
- [`backend-security-coder`](../skills/backend-security-coder/): Secure backend coding practices.
|
||||
- [`frontend-security-coder`](../skills/frontend-security-coder/): XSS prevention and client-side security.
|
||||
- [`cc-skill-security-review`](../skills/cc-skill-security-review/): Security checklist for features.
|
||||
- [`pci-compliance`](../skills/pci-compliance/): Payment card security standards.
|
||||
|
||||
---
|
||||
|
||||
## 🌐 Web Development
|
||||
|
||||
### 🌐 The "Web Wizard" Pack
|
||||
|
||||
_For building modern, high-performance web apps._
|
||||
|
||||
- [`frontend-design`](../skills/frontend-design/): UI guidelines and aesthetics.
|
||||
- [`react-best-practices`](../skills/react-best-practices/): React & Next.js performance optimization.
|
||||
- [`react-patterns`](../skills/react-patterns/): Modern React patterns and principles.
|
||||
- [`nextjs-best-practices`](../skills/nextjs-best-practices/): Next.js App Router patterns.
|
||||
- [`tailwind-patterns`](../skills/tailwind-patterns/): Tailwind CSS v4 styling superpowers.
|
||||
- [`form-cro`](../skills/form-cro/): Optimize your forms for conversion.
|
||||
- [`seo-audit`](../skills/seo-audit/): Get found on Google.
|
||||
|
||||
### 🖌️ The "Web Designer" Pack
|
||||
|
||||
_For pixel-perfect experiences._
|
||||
|
||||
- [`ui-ux-pro-max`](../skills/ui-ux-pro-max/): Premium design systems and tokens.
|
||||
- [`frontend-design`](../skills/frontend-design/): The base layer of aesthetics.
|
||||
- [`3d-web-experience`](../skills/3d-web-experience/): Three.js & React Three Fiber magic.
|
||||
- [`canvas-design`](../skills/canvas-design/): Static visuals and posters.
|
||||
- [`mobile-design`](../skills/mobile-design/): Mobile-first design principles.
|
||||
- [`scroll-experience`](../skills/scroll-experience/): Immersive scroll-driven experiences.
|
||||
|
||||
### ⚡ The "Full-Stack Developer" Pack
|
||||
|
||||
_For end-to-end web application development._
|
||||
|
||||
- [`senior-fullstack`](../skills/senior-fullstack/): Complete fullstack development guide.
|
||||
- [`frontend-developer`](../skills/frontend-developer/): React 19+ and Next.js 15+ expertise.
|
||||
- [`backend-dev-guidelines`](../skills/backend-dev-guidelines/): Node.js/Express/TypeScript patterns.
|
||||
- [`api-patterns`](../skills/api-patterns/): REST vs GraphQL vs tRPC selection.
|
||||
- [`database-design`](../skills/database-design/): Schema design and ORM selection.
|
||||
- [`stripe-integration`](../skills/stripe-integration/): Payments and subscriptions.
|
||||
|
||||
---
|
||||
|
||||
## 🤖 AI & Agents
|
||||
|
||||
### 🤖 The "Agent Architect" Pack
|
||||
|
||||
_For building AI systems and autonomous agents._
|
||||
|
||||
- [`agent-evaluation`](../skills/agent-evaluation/): Test and benchmark your agents.
|
||||
- [`langgraph`](../skills/langgraph/): Build stateful agent workflows.
|
||||
- [`mcp-builder`](../skills/mcp-builder/): Create your own MCP tools.
|
||||
- [`prompt-engineering`](../skills/prompt-engineering/): Master the art of talking to LLMs.
|
||||
- [`ai-agents-architect`](../skills/ai-agents-architect/): Design autonomous AI agents.
|
||||
- [`rag-engineer`](../skills/rag-engineer/): Build RAG systems with vector search.
|
||||
|
||||
### 🧠 The "LLM Application Developer" Pack
|
||||
|
||||
_For building production LLM applications._
|
||||
|
||||
- [`llm-app-patterns`](../skills/llm-app-patterns/): Production-ready LLM patterns.
|
||||
- [`rag-implementation`](../skills/rag-implementation/): Retrieval-Augmented Generation.
|
||||
- [`prompt-caching`](../skills/prompt-caching/): Cache strategies for LLM prompts.
|
||||
- [`context-window-management`](../skills/context-window-management/): Manage LLM context efficiently.
|
||||
- [`langfuse`](../skills/langfuse/): LLM observability and tracing.
|
||||
|
||||
---
|
||||
|
||||
## 🎮 Game Development
|
||||
|
||||
### 🎮 The "Indie Game Dev" Pack
|
||||
|
||||
_For building games with AI assistants._
|
||||
|
||||
- [`game-development/game-design`](../skills/game-development/game-design/): Mechanics and loops.
|
||||
- [`game-development/2d-games`](../skills/game-development/2d-games/): Sprites and physics.
|
||||
- [`game-development/3d-games`](../skills/game-development/3d-games/): Models and shaders.
|
||||
- [`unity-developer`](../skills/unity-developer/): Unity 6 LTS development.
|
||||
- [`godot-gdscript-patterns`](../skills/godot-gdscript-patterns/): Godot 4 GDScript patterns.
|
||||
- [`algorithmic-art`](../skills/algorithmic-art/): Generate assets with code.
|
||||
|
||||
---
|
||||
|
||||
## 🐍 Backend & Languages
|
||||
|
||||
### 🐍 The "Python Pro" Pack
|
||||
|
||||
_For backend heavyweights and data scientists._
|
||||
|
||||
- [`python-pro`](../skills/python-pro/): Master Python 3.12+ with modern features.
|
||||
- [`python-patterns`](../skills/python-patterns/): Idiomatic Python code.
|
||||
- [`fastapi-pro`](../skills/fastapi-pro/): High-performance async APIs.
|
||||
- [`fastapi-templates`](../skills/fastapi-templates/): Production-ready FastAPI projects.
|
||||
- [`django-pro`](../skills/django-pro/): The battery-included framework.
|
||||
- [`python-testing-patterns`](../skills/python-testing-patterns/): Comprehensive testing with pytest.
|
||||
- [`async-python-patterns`](../skills/async-python-patterns/): Python asyncio mastery.
|
||||
|
||||
### 🟦 The "TypeScript & JavaScript" Pack
|
||||
|
||||
_For modern web development._
|
||||
|
||||
- [`typescript-expert`](../skills/typescript-expert/): TypeScript mastery and advanced types.
|
||||
- [`javascript-pro`](../skills/javascript-pro/): Modern JavaScript with ES6+.
|
||||
- [`react-best-practices`](../skills/react-best-practices/): React performance optimization.
|
||||
- [`nodejs-best-practices`](../skills/nodejs-best-practices/): Node.js development principles.
|
||||
- [`nextjs-app-router-patterns`](../skills/nextjs-app-router-patterns/): Next.js 14+ App Router.
|
||||
|
||||
### 🦀 The "Systems Programming" Pack
|
||||
|
||||
_For low-level and performance-critical code._
|
||||
|
||||
- [`rust-pro`](../skills/rust-pro/): Rust 1.75+ with async patterns.
|
||||
- [`go-concurrency-patterns`](../skills/go-concurrency-patterns/): Go concurrency mastery.
|
||||
- [`golang-pro`](../skills/golang-pro/): Go development expertise.
|
||||
- [`memory-safety-patterns`](../skills/memory-safety-patterns/): Memory-safe programming.
|
||||
- [`cpp-pro`](../skills/cpp-pro/): Modern C++ development.
|
||||
|
||||
---
|
||||
|
||||
## 🦄 Product & Business
|
||||
|
||||
### 🦄 The "Startup Founder" Pack
|
||||
|
||||
_For building products, not just code._
|
||||
|
||||
- [`product-manager-toolkit`](../skills/product-manager-toolkit/): RICE prioritization, PRD templates.
|
||||
- [`competitive-landscape`](../skills/competitive-landscape/): Competitor analysis.
|
||||
- [`competitor-alternatives`](../skills/competitor-alternatives/): Create comparison pages.
|
||||
- [`launch-strategy`](../skills/launch-strategy/): Product launch planning.
|
||||
- [`copywriting`](../skills/copywriting/): Marketing copy that converts.
|
||||
- [`stripe-integration`](../skills/stripe-integration/): Get paid from day one.
|
||||
|
||||
### 📊 The "Business Analyst" Pack
|
||||
|
||||
_For data-driven decision making._
|
||||
|
||||
- [`business-analyst`](../skills/business-analyst/): AI-powered analytics and KPIs.
|
||||
- [`startup-metrics-framework`](../skills/startup-metrics-framework/): SaaS metrics and unit economics.
|
||||
- [`startup-financial-modeling`](../skills/startup-financial-modeling/): 3-5 year financial projections.
|
||||
- [`market-sizing-analysis`](../skills/market-sizing-analysis/): TAM/SAM/SOM calculations.
|
||||
- [`kpi-dashboard-design`](../skills/kpi-dashboard-design/): Effective KPI dashboards.
|
||||
|
||||
### 📈 The "Marketing & Growth" Pack
|
||||
|
||||
_For driving user acquisition and retention._
|
||||
|
||||
- [`content-creator`](../skills/content-creator/): SEO-optimized marketing content.
|
||||
- [`seo-audit`](../skills/seo-audit/): Technical SEO health checks.
|
||||
- [`programmatic-seo`](../skills/programmatic-seo/): Create pages at scale.
|
||||
- [`analytics-tracking`](../skills/analytics-tracking/): Set up GA4/PostHog correctly.
|
||||
- [`ab-test-setup`](../skills/ab-test-setup/): Validated learning experiments.
|
||||
- [`email-sequence`](../skills/email-sequence/): Automated email campaigns.
|
||||
|
||||
---
|
||||
|
||||
## 🌧️ DevOps & Infrastructure
|
||||
|
||||
### 🌧️ The "DevOps & Cloud" Pack
|
||||
|
||||
_For infrastructure and scaling._
|
||||
|
||||
- [`docker-expert`](../skills/docker-expert/): Master containers and multi-stage builds.
|
||||
- [`aws-serverless`](../skills/aws-serverless/): Serverless on AWS (Lambda, DynamoDB).
|
||||
- [`kubernetes-architect`](../skills/kubernetes-architect/): K8s architecture and GitOps.
|
||||
- [`terraform-specialist`](../skills/terraform-specialist/): Infrastructure as Code mastery.
|
||||
- [`environment-setup-guide`](../skills/environment-setup-guide/): Standardization for teams.
|
||||
- [`deployment-procedures`](../skills/deployment-procedures/): Safe rollout strategies.
|
||||
- [`bash-linux`](../skills/bash-linux/): Terminal wizardry.
|
||||
|
||||
### 📊 The "Observability & Monitoring" Pack
|
||||
|
||||
_For production reliability._
|
||||
|
||||
- [`observability-engineer`](../skills/observability-engineer/): Comprehensive monitoring systems.
|
||||
- [`distributed-tracing`](../skills/distributed-tracing/): Track requests across microservices.
|
||||
- [`slo-implementation`](../skills/slo-implementation/): Service Level Objectives.
|
||||
- [`incident-responder`](../skills/incident-responder/): Rapid incident response.
|
||||
- [`postmortem-writing`](../skills/postmortem-writing/): Blameless postmortems.
|
||||
- [`performance-engineer`](../skills/performance-engineer/): Application performance optimization.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Data & Analytics
|
||||
|
||||
### 📊 The "Data & Analytics" Pack
|
||||
|
||||
_For making sense of the numbers._
|
||||
|
||||
- [`analytics-tracking`](../skills/analytics-tracking/): Set up GA4/PostHog correctly.
|
||||
- [`claude-d3js-skill`](../skills/claude-d3js-skill/): Beautiful custom visualizations with D3.js.
|
||||
- [`sql-pro`](../skills/sql-pro/): Modern SQL with cloud-native databases.
|
||||
- [`postgres-best-practices`](../skills/postgres-best-practices/): Postgres optimization.
|
||||
- [`ab-test-setup`](../skills/ab-test-setup/): Validated learning.
|
||||
- [`database-architect`](../skills/database-architect/): Database design from scratch.
|
||||
|
||||
### 🔄 The "Data Engineering" Pack
|
||||
|
||||
_For building data pipelines._
|
||||
|
||||
- [`data-engineer`](../skills/data-engineer/): Data pipeline architecture.
|
||||
- [`airflow-dag-patterns`](../skills/airflow-dag-patterns/): Apache Airflow DAGs.
|
||||
- [`dbt-transformation-patterns`](../skills/dbt-transformation-patterns/): Analytics engineering.
|
||||
- [`vector-database-engineer`](../skills/vector-database-engineer/): Vector databases for RAG.
|
||||
- [`embedding-strategies`](../skills/embedding-strategies/): Embedding model selection.
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Creative & Content
|
||||
|
||||
### 🎨 The "Creative Director" Pack
|
||||
|
||||
_For visuals, content, and branding._
|
||||
|
||||
- [`canvas-design`](../skills/canvas-design/): Generate posters and diagrams.
|
||||
- [`frontend-design`](../skills/frontend-design/): UI aesthetics.
|
||||
- [`content-creator`](../skills/content-creator/): SEO-optimized blog posts.
|
||||
- [`copy-editing`](../skills/copy-editing/): Polish your prose.
|
||||
- [`algorithmic-art`](../skills/algorithmic-art/): Code-generated masterpieces.
|
||||
- [`interactive-portfolio`](../skills/interactive-portfolio/): Portfolios that land jobs.
|
||||
|
||||
---
|
||||
|
||||
## 🐞 Quality Assurance
|
||||
|
||||
### 🐞 The "QA & Testing" Pack
|
||||
|
||||
_For breaking things before users do._
|
||||
|
||||
- [`test-driven-development`](../skills/test-driven-development/): Red, Green, Refactor.
|
||||
- [`systematic-debugging`](../skills/systematic-debugging/): Debug like Sherlock Holmes.
|
||||
- [`browser-automation`](../skills/browser-automation/): End-to-end testing with Playwright.
|
||||
- [`e2e-testing-patterns`](../skills/e2e-testing-patterns/): Reliable E2E test suites.
|
||||
- [`ab-test-setup`](../skills/ab-test-setup/): Validated experiments.
|
||||
- [`code-review-checklist`](../skills/code-review-checklist/): Catch bugs in PRs.
|
||||
- [`test-fixing`](../skills/test-fixing/): Fix failing tests systematically.
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Specialized Packs
|
||||
|
||||
### 📱 The "Mobile Developer" Pack
|
||||
|
||||
_For iOS, Android, and cross-platform apps._
|
||||
|
||||
- [`mobile-developer`](../skills/mobile-developer/): Cross-platform mobile development.
|
||||
- [`react-native-architecture`](../skills/react-native-architecture/): React Native with Expo.
|
||||
- [`flutter-expert`](../skills/flutter-expert/): Flutter multi-platform apps.
|
||||
- [`ios-developer`](../skills/ios-developer/): iOS development with Swift.
|
||||
- [`app-store-optimization`](../skills/app-store-optimization/): ASO for App Store and Play Store.
|
||||
|
||||
### 🔗 The "Integration & APIs" Pack
|
||||
|
||||
_For connecting services and building integrations._
|
||||
|
||||
- [`stripe-integration`](../skills/stripe-integration/): Payments and subscriptions.
|
||||
- [`twilio-communications`](../skills/twilio-communications/): SMS, voice, WhatsApp.
|
||||
- [`hubspot-integration`](../skills/hubspot-integration/): CRM integration.
|
||||
- [`plaid-fintech`](../skills/plaid-fintech/): Bank account linking and ACH.
|
||||
- [`algolia-search`](../skills/algolia-search/): Search implementation.
|
||||
|
||||
### 🎯 The "Architecture & Design" Pack
|
||||
|
||||
_For system design and technical decisions._
|
||||
|
||||
- [`senior-architect`](../skills/senior-architect/): Comprehensive software architecture.
|
||||
- [`architecture-patterns`](../skills/architecture-patterns/): Clean Architecture, DDD, Hexagonal.
|
||||
- [`microservices-patterns`](../skills/microservices-patterns/): Microservices architecture.
|
||||
- [`event-sourcing-architect`](../skills/event-sourcing-architect/): Event sourcing and CQRS.
|
||||
- [`architecture-decision-records`](../skills/architecture-decision-records/): Document technical decisions.
|
||||
|
||||
### 🧱 The "DDD & Evented Architecture" Pack
|
||||
|
||||
_For teams modeling complex domains and evolving toward evented systems._
|
||||
|
||||
- [`domain-driven-design`](../skills/domain-driven-design/): Route DDD work from strategic modeling to implementation patterns.
|
||||
- [`ddd-strategic-design`](../skills/ddd-strategic-design/): Subdomains, bounded contexts, and ubiquitous language.
|
||||
- [`ddd-context-mapping`](../skills/ddd-context-mapping/): Cross-context integration and anti-corruption boundaries.
|
||||
- [`ddd-tactical-patterns`](../skills/ddd-tactical-patterns/): Aggregates, value objects, repositories, and domain events.
|
||||
- [`cqrs-implementation`](../skills/cqrs-implementation/): Read/write model separation.
|
||||
- [`event-store-design`](../skills/event-store-design/): Event persistence and replay architecture.
|
||||
- [`saga-orchestration`](../skills/saga-orchestration/): Cross-context long-running transaction coordination.
|
||||
- [`projection-patterns`](../skills/projection-patterns/): Materialized read models from event streams.
|
||||
|
||||
---
|
||||
|
||||
## 🧰 Maintainer & OSS
|
||||
|
||||
### 🛠️ The "OSS Maintainer" Pack
|
||||
|
||||
_For shipping clean changes in public repositories._
|
||||
|
||||
- [`commit`](../skills/commit/): High-quality conventional commits.
|
||||
- [`create-pr`](../skills/create-pr/): PR creation with review-ready context.
|
||||
- [`requesting-code-review`](../skills/requesting-code-review/): Ask for targeted, high-signal reviews.
|
||||
- [`receiving-code-review`](../skills/receiving-code-review/): Apply feedback with technical rigor.
|
||||
- [`changelog-automation`](../skills/changelog-automation/): Keep release notes and changelogs consistent.
|
||||
- [`git-advanced-workflows`](../skills/git-advanced-workflows/): Rebase, cherry-pick, bisect, recovery.
|
||||
- [`documentation-templates`](../skills/documentation-templates/): Standardize docs and handoffs.
|
||||
|
||||
### 🧱 The "Skill Author" Pack
|
||||
|
||||
_For creating and maintaining high-quality SKILL.md assets._
|
||||
|
||||
- [`skill-creator`](../skills/skill-creator/): Design effective new skills.
|
||||
- [`skill-developer`](../skills/skill-developer/): Implement triggers, hooks, and skill lifecycle.
|
||||
- [`writing-skills`](../skills/writing-skills/): Improve clarity and structure of skill instructions.
|
||||
- [`documentation-generation-doc-generate`](../skills/documentation-generation-doc-generate/): Generate maintainable technical docs.
|
||||
- [`lint-and-validate`](../skills/lint-and-validate/): Validate quality after edits.
|
||||
- [`verification-before-completion`](../skills/verification-before-completion/): Confirm changes before claiming done.
|
||||
|
||||
---
|
||||
|
||||
## 📚 How to Use Bundles
|
||||
|
||||
### 1) Pick by immediate goal
|
||||
|
||||
- Need to ship a feature now: `Essentials` + one domain pack (`Web Wizard`, `Python Pro`, `DevOps & Cloud`).
|
||||
- Need reliability and hardening: add `QA & Testing` + `Security Developer`.
|
||||
- Need product growth: add `Startup Founder` or `Marketing & Growth`.
|
||||
|
||||
### 2) Start with 3-5 skills, not 20
|
||||
|
||||
Pick the minimum set for your current milestone. Expand only when you hit a real gap.
|
||||
|
||||
### 3) Invoke skills consistently
|
||||
|
||||
- **Claude Code**: `>> /skill-name help me...`
|
||||
- **Cursor**: `@skill-name` in chat
|
||||
- **Gemini CLI**: `Use skill-name...`
|
||||
- **Codex CLI**: `Use skill-name...`
|
||||
|
||||
### 4) Build your personal shortlist
|
||||
|
||||
Keep a small list of high-frequency skills and reuse it across tasks to reduce context switching.
|
||||
|
||||
## 🧩 Recommended Bundle Combos
|
||||
|
||||
### Ship a SaaS MVP (2 weeks)
|
||||
|
||||
`Essentials` + `Full-Stack Developer` + `QA & Testing` + `Startup Founder`
|
||||
|
||||
### Harden an existing production app
|
||||
|
||||
`Essentials` + `Security Developer` + `DevOps & Cloud` + `Observability & Monitoring`
|
||||
|
||||
### Build an AI product
|
||||
|
||||
`Essentials` + `Agent Architect` + `LLM Application Developer` + `Data Engineering`
|
||||
|
||||
### Grow traffic and conversions
|
||||
|
||||
`Web Wizard` + `Marketing & Growth` + `Data & Analytics`
|
||||
|
||||
### Launch and maintain open source
|
||||
|
||||
`Essentials` + `OSS Maintainer` + `Architecture & Design`
|
||||
|
||||
---
|
||||
|
||||
## 🎓 Learning Paths
|
||||
|
||||
### Beginner → Intermediate → Advanced
|
||||
|
||||
**Web Development:**
|
||||
|
||||
1. Start: `Essentials` → `Web Wizard`
|
||||
2. Grow: `Full-Stack Developer` → `Architecture & Design`
|
||||
3. Master: `Observability & Monitoring` → `Security Developer`
|
||||
|
||||
**AI/ML:**
|
||||
|
||||
1. Start: `Essentials` → `Agent Architect`
|
||||
2. Grow: `LLM Application Developer` → `Data Engineering`
|
||||
3. Master: Advanced RAG and agent orchestration
|
||||
|
||||
**Security:**
|
||||
|
||||
1. Start: `Essentials` → `Security Developer`
|
||||
2. Grow: `Security Engineer` → Advanced pentesting
|
||||
3. Master: Red team tactics and threat modeling
|
||||
|
||||
**Open Source Maintenance:**
|
||||
|
||||
1. Start: `Essentials` → `OSS Maintainer`
|
||||
2. Grow: `Architecture & Design` → `QA & Testing`
|
||||
3. Master: `Skill Author` + release automation workflows
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
Found a skill that should be in a bundle? Or want to create a new bundle? [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues) or submit a PR!
|
||||
|
||||
---
|
||||
|
||||
## 📖 Related Documentation
|
||||
|
||||
- [Getting Started Guide](GETTING_STARTED.md)
|
||||
- [Full Skill Catalog](../CATALOG.md)
|
||||
- [Contributing Guide](../CONTRIBUTING.md)
|
||||
|
||||
---
|
||||
|
||||
_Last updated: February 2026 | Total Skills: 954+ | Total Bundles: 26_
|
||||
This document moved to [`users/bundles.md`](users/bundles.md).
|
||||
|
||||
@@ -1,170 +1,3 @@
|
||||
# Smart Categorization Implementation - Complete Summary
|
||||
# Categorization Implementation
|
||||
|
||||
## ✅ What Was Done
|
||||
|
||||
### 1. **Intelligent Auto-Categorization Script**
|
||||
Created [scripts/auto_categorize_skills.py](scripts/auto_categorize_skills.py) that:
|
||||
- Analyzes skill names and descriptions
|
||||
- Matches against keyword libraries for 13 categories
|
||||
- Automatically assigns meaningful categories
|
||||
- Removes "uncategorized" bulk assignment
|
||||
|
||||
**Results:**
|
||||
- ✅ 776 skills auto-categorized
|
||||
- ✅ 46 already had categories preserved
|
||||
- ✅ 124 remaining uncategorized (edge cases)
|
||||
|
||||
### 2. **Category Distribution**
|
||||
|
||||
**Before:**
|
||||
```
|
||||
uncategorized: 926 (98%)
|
||||
game-development: 10
|
||||
libreoffice: 5
|
||||
security: 4
|
||||
```
|
||||
|
||||
**After:**
|
||||
```
|
||||
Backend: 164 ████████████████
|
||||
Web Dev: 107 ███████████
|
||||
Automation: 103 ███████████
|
||||
DevOps: 83 ████████
|
||||
AI/ML: 79 ████████
|
||||
Content: 47 █████
|
||||
Database: 44 █████
|
||||
Testing: 38 ████
|
||||
Security: 36 ████
|
||||
Cloud: 33 ███
|
||||
Mobile: 21 ██
|
||||
Game Dev: 15 ██
|
||||
Data Science: 14 ██
|
||||
Uncategorized: 126 █
|
||||
```
|
||||
|
||||
### 3. **Updated Index Generation**
|
||||
Modified [scripts/generate_index.py](scripts/generate_index.py):
|
||||
- **Frontmatter categories now take priority**
|
||||
- Falls back to folder structure if needed
|
||||
- Generates clean, organized skills_index.json
|
||||
- Exported to web-app/public/skills.json
|
||||
|
||||
### 4. **Improved Web App Filter**
|
||||
|
||||
**Home Page Changes:**
|
||||
- ✅ Categories sorted by skill count (most first)
|
||||
- ✅ "Uncategorized" moved to bottom
|
||||
- ✅ Each shows count: "Backend (164)", "Web Dev (107)"
|
||||
- ✅ Much easier to navigate
|
||||
|
||||
**Updated Code:**
|
||||
- [web-app/src/pages/Home.jsx](web-app/src/pages/Home.jsx) - Smart category sorting
|
||||
- Sorts categories by count using categoryStats
|
||||
- Uncategorized always last
|
||||
- Displays count in dropdown
|
||||
|
||||
### 5. **Categorization Keywords** (13 Categories)
|
||||
|
||||
| Category | Key Keywords |
|
||||
|----------|--------------|
|
||||
| **Backend** | nodejs, express, fastapi, django, server, api, database |
|
||||
| **Web Dev** | react, vue, angular, frontend, css, html, tailwind |
|
||||
| **Automation** | workflow, scripting, automation, robot, trigger |
|
||||
| **DevOps** | docker, kubernetes, ci/cd, deploy, container |
|
||||
| **AI/ML** | ai, machine learning, tensorflow, nlp, gpt, llm |
|
||||
| **Content** | markdown, documentation, content, writing |
|
||||
| **Database** | sql, postgres, mongodb, redis, orm |
|
||||
| **Testing** | test, jest, pytest, cypress, unit test |
|
||||
| **Security** | encryption, auth, oauth, jwt, vulnerability |
|
||||
| **Cloud** | aws, azure, gcp, serverless, lambda |
|
||||
| **Mobile** | react native, flutter, ios, android, swift |
|
||||
| **Game Dev** | game, unity, webgl, threejs, 3d, physics |
|
||||
| **Data Science** | pandas, numpy, analytics, statistics |
|
||||
|
||||
### 6. **Documentation**
|
||||
Created [docs/SMART_AUTO_CATEGORIZATION.md](docs/SMART_AUTO_CATEGORIZATION.md) with:
|
||||
- How the system works
|
||||
- Using the script (`--dry-run` and apply modes)
|
||||
- Category reference
|
||||
- Customization guide
|
||||
- Troubleshooting
|
||||
|
||||
## 🎯 The Result
|
||||
|
||||
### No More Uncategorized Chaos
|
||||
- **Before**: 98% of 946 skills lumped as "uncategorized"
|
||||
- **After**: 87% properly organized, only 13% needing review
|
||||
|
||||
### Better UX
|
||||
1. **Smarter Filtering**: Categories sorted by relevance
|
||||
2. **Visual Cues**: Shows count "(164 skills)""
|
||||
3. **Uncategorized Last**: Put bad options out of sight
|
||||
4. **Meaningful Groups**: Find skills by actual function
|
||||
|
||||
### Example Workflow
|
||||
User wants to find database skills:
|
||||
1. Opens web app
|
||||
2. Sees filter dropdown: "Backend (164) | Database (44) | Web Dev (107)..."
|
||||
3. Clicks "Database (44)"
|
||||
4. Gets 44 relevant SQL/MongoDB/Postgres skills
|
||||
5. Done! 🎉
|
||||
|
||||
## 🚀 Usage
|
||||
|
||||
### Run Auto-Categorization
|
||||
```bash
|
||||
# Test first
|
||||
python scripts/auto_categorize_skills.py --dry-run
|
||||
|
||||
# Apply changes
|
||||
python scripts/auto_categorize_skills.py
|
||||
|
||||
# Regenerate index
|
||||
python scripts/generate_index.py
|
||||
|
||||
# Deploy to web app
|
||||
cp skills_index.json web-app/public/skills.json
|
||||
```
|
||||
|
||||
### For New Skills
|
||||
Add to frontmatter:
|
||||
```yaml
|
||||
---
|
||||
name: my-skill
|
||||
description: "..."
|
||||
category: backend
|
||||
date_added: "2025-02-26"
|
||||
---
|
||||
```
|
||||
|
||||
## 📁 Files Changed
|
||||
|
||||
### New Files
|
||||
- `scripts/auto_categorize_skills.py` - Auto-categorization engine
|
||||
- `docs/SMART_AUTO_CATEGORIZATION.md` - Full documentation
|
||||
|
||||
### Modified Files
|
||||
- `scripts/generate_index.py` - Category priority logic
|
||||
- `web-app/src/pages/Home.jsx` - Smart category sorting
|
||||
- `web-app/public/skills.json` - Regenerated with categories
|
||||
|
||||
## 📊 Quality Metrics
|
||||
|
||||
- **Coverage**: 87% of skills in meaningful categories
|
||||
- **Accuracy**: Keyword-based matching with word boundaries
|
||||
- **Performance**: ~1-2 seconds to auto-categorize all 946 skills
|
||||
- **Maintainability**: Easily add keywords/categories for future growth
|
||||
|
||||
## 🎁 Bonus Features
|
||||
|
||||
1. **Dry-run mode**: See changes before applying
|
||||
2. **Weighted scoring**: Exact matches score 2x partial matches
|
||||
3. **Customizable keywords**: Easy to add more categories
|
||||
4. **Fallback logic**: folder → frontmatter → uncategorized
|
||||
5. **UTF-8 support**: Works on Windows/Mac/Linux
|
||||
|
||||
---
|
||||
|
||||
**Status**: ✅ Complete and deployed to web app!
|
||||
|
||||
The web app now has a clean, intelligent category filter instead of "uncategorized" chaos. 🚀
|
||||
This document moved to [`maintainers/categorization-implementation.md`](maintainers/categorization-implementation.md).
|
||||
|
||||
@@ -1,38 +1,3 @@
|
||||
# CI Drift Fix Guide
|
||||
# CI Drift Fix
|
||||
|
||||
**Problem**: The failing job is caused by uncommitted changes detected in `README.md`, `skills_index.json`, or catalog files after the update scripts run.
|
||||
|
||||
**Error**:
|
||||
|
||||
```
|
||||
❌ Detected uncommitted changes produced by registry/readme/catalog scripts.
|
||||
```
|
||||
|
||||
**Cause**:
|
||||
Scripts like `scripts/generate_index.py`, `scripts/update_readme.py`, and `scripts/build-catalog.js` modify `README.md`, `skills_index.json`, `data/catalog.json`, `data/bundles.json`, `data/aliases.json`, and `CATALOG.md`. The workflow expects these files to have no changes after the scripts run. Any differences mean the committed repo is out-of-sync with what the generation scripts produce.
|
||||
|
||||
**How to Fix (DO THIS EVERY TIME):**
|
||||
|
||||
1. Run the **FULL Validation Chain** locally:
|
||||
|
||||
```bash
|
||||
npm run chain
|
||||
npm run catalog
|
||||
```
|
||||
|
||||
2. Check for changes:
|
||||
|
||||
```bash
|
||||
git status
|
||||
git diff
|
||||
```
|
||||
|
||||
3. Commit and push any updates:
|
||||
```bash
|
||||
git add README.md skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md
|
||||
git commit -m "chore: sync generated registry files"
|
||||
git push
|
||||
```
|
||||
|
||||
**Summary**:
|
||||
Always commit and push all changes produced by the registry, readme, and catalog scripts. This keeps the CI workflow passing by ensuring the repository and generated files are synced.
|
||||
This document moved to [`maintainers/ci-drift-fix.md`](maintainers/ci-drift-fix.md).
|
||||
|
||||
@@ -1,33 +1,3 @@
|
||||
# Code of Conduct
|
||||
# Community Guidelines
|
||||
|
||||
## Our Pledge
|
||||
|
||||
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone.
|
||||
|
||||
## Our Standards
|
||||
|
||||
Examples of behavior that contributes to creating a positive environment include:
|
||||
|
||||
- Using welcoming and inclusive language
|
||||
- Being respectful of differing viewpoints and experiences
|
||||
- Gracefully accepting constructive criticism
|
||||
- Focusing on what is best for the community
|
||||
- Showing empathy towards other community members
|
||||
|
||||
Examples of unacceptable behavior by participants include:
|
||||
|
||||
- The use of sexualized language or imagery and unwelcome sexual attention or advances
|
||||
- Trolling, insulting/derogatory comments, and personal or political attacks
|
||||
- Public or private harassment
|
||||
- Publishing others' private information without explicit permission
|
||||
- Other conduct which could reasonably be considered inappropriate in a professional setting
|
||||
|
||||
## Enforcement
|
||||
|
||||
Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
|
||||
|
||||
## Attribution
|
||||
|
||||
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1.
|
||||
|
||||
[homepage]: https://www.contributor-covenant.org
|
||||
This document moved to [`contributors/community-guidelines.md`](contributors/community-guidelines.md).
|
||||
|
||||
@@ -1,156 +1,3 @@
|
||||
# Date Tracking Implementation Summary
|
||||
# Date Tracking Implementation
|
||||
|
||||
## ✅ What Was Implemented
|
||||
|
||||
### 1. **Frontmatter Template Update**
|
||||
All 946 skills now have the `date_added: "2025-02-26"` field in their `SKILL.md` frontmatter:
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: skill-name
|
||||
description: "Description"
|
||||
date_added: "2025-02-26"
|
||||
---
|
||||
```
|
||||
|
||||
### 2. **Web App Integration**
|
||||
|
||||
#### **Home Page (Skill List Cards)**
|
||||
- Each skill card now displays a small date badge: `📅 YYYY-MM-DD`
|
||||
- Shows alongside the risk level
|
||||
- Clean, compact format in the bottom metadata section
|
||||
|
||||
Example card now shows:
|
||||
```
|
||||
Risk: safe 📅 2025-02-26
|
||||
```
|
||||
|
||||
#### **Skill Detail Page**
|
||||
- Date appears as a green badge near the top with other metadata
|
||||
- Format: `📅 Added YYYY-MM-DD`
|
||||
- Shown alongside Category, Source, and Star buttons
|
||||
|
||||
### 3. **Validators Updated**
|
||||
Both validators now accept and validate the `date_added` field:
|
||||
|
||||
- **validate-skills.js**: Added to `ALLOWED_FIELDS`
|
||||
- **validate_skills.py**: Added YYYY-MM-DD format validation
|
||||
- Warns (dev mode) or fails (strict mode) on missing dates
|
||||
- Validates format strictly
|
||||
|
||||
### 4. **Index Generation**
|
||||
- **generate_index.py** updated to include `date_added` in `skills.json`
|
||||
- All 946 skills now have dates in the web app index
|
||||
- Dates are properly exported to web app's `/public/skills.json`
|
||||
|
||||
### 5. **Documentation**
|
||||
- **SKILL_TEMPLATE.md**: New template for creating skills with date field included
|
||||
- **SKILLS_DATE_TRACKING.md**: Complete usage guide for date management
|
||||
- **SKILL_ANATOMY.md**: Updated with date_added field documentation
|
||||
- **README.md**: Updated contribution guide to mention date tracking
|
||||
|
||||
### 6. **Script Tools**
|
||||
✅ All scripts handle UTF-8 encoding on Windows:
|
||||
|
||||
- **manage_skill_dates.py**: Add, update, list skill dates
|
||||
- **generate_skills_report.py**: Generate JSON report with dates
|
||||
- Both handle emoji output correctly on Windows
|
||||
|
||||
## 📊 Current Status
|
||||
|
||||
- ✅ **946/946 skills** have `date_added: "2025-02-26"`
|
||||
- ✅ **100% coverage** of date tracking
|
||||
- ✅ **Web app displays dates** on all skill cards
|
||||
- ✅ **Validators enforce format** (YYYY-MM-DD)
|
||||
- ✅ **Reports available** via CLI tools
|
||||
|
||||
## 🎨 UI Changes
|
||||
|
||||
### Skill Card (Home Page)
|
||||
Before:
|
||||
```
|
||||
Risk: safe
|
||||
```
|
||||
|
||||
After:
|
||||
```
|
||||
Risk: safe 📅 2025-02-26
|
||||
```
|
||||
|
||||
### Skill Detail Page
|
||||
Before:
|
||||
```
|
||||
[Category] [Source] [Stars]
|
||||
```
|
||||
|
||||
After:
|
||||
```
|
||||
[Category] [Source] [📅 Added 2025-02-26] [Stars]
|
||||
```
|
||||
|
||||
## 📝 Using the Date Field
|
||||
|
||||
### For New Skills
|
||||
Create with template:
|
||||
```bash
|
||||
cp docs/SKILL_TEMPLATE.md skills/my-new-skill/SKILL.md
|
||||
# Edit the template and set date_added to today's date
|
||||
```
|
||||
|
||||
### For Existing Skills
|
||||
Use the management script:
|
||||
```bash
|
||||
# Add missing dates
|
||||
python scripts/manage_skill_dates.py add-missing --date 2025-02-26
|
||||
|
||||
# Update a single skill
|
||||
python scripts/manage_skill_dates.py update skill-name 2025-02-26
|
||||
|
||||
# List all with dates
|
||||
python scripts/manage_skill_dates.py list
|
||||
|
||||
# Generate report
|
||||
python scripts/generate_skills_report.py --output report.json
|
||||
```
|
||||
|
||||
## 🔧 Technical Details
|
||||
|
||||
### Files Modified
|
||||
1. `scripts/generate_index.py` - Added date_added parsing
|
||||
2. `scripts/validate-skills.js` - Added to allowed fields
|
||||
3. `scripts/validate_skills.py` - Added format validation
|
||||
4. `web-app/src/pages/Home.jsx` - Display date in cards
|
||||
5. `web-app/src/pages/SkillDetail.jsx` - Display date in detail
|
||||
6. `README.md` - Updated contribution guide
|
||||
7. `docs/SKILL_ANATOMY.md` - Documented date_added field
|
||||
|
||||
### New Files Created
|
||||
1. `docs/SKILL_TEMPLATE.md` - Skill creation template
|
||||
2. `docs/SKILLS_DATE_TRACKING.md` - Comprehensive guide
|
||||
3. `scripts/manage_skill_dates.py` - Date management CLI
|
||||
4. `scripts/generate_skills_report.py` - Report generation
|
||||
|
||||
## 🚀 Next Steps
|
||||
|
||||
1. **In Web App**: Skills now show creation dates automatically
|
||||
2. **For Analytics**: Use report script to track skill growth over time
|
||||
3. **For Contributions**: Include date_added in new skill PRs
|
||||
4. **For Maintenance**: Run validators to ensure date format compliance
|
||||
|
||||
## 📈 Reporting Examples
|
||||
|
||||
Get a JSON report sorted by date:
|
||||
```bash
|
||||
python scripts/generate_skills_report.py --output skills_by_date.json
|
||||
```
|
||||
|
||||
Output includes:
|
||||
- Total skills count
|
||||
- Skills with/without dates
|
||||
- Coverage percentage
|
||||
- Full skill metadata with dates
|
||||
- Sortable by date or name
|
||||
|
||||
---
|
||||
|
||||
**Date Feature Ready!** 🎉 All skills now track when they were added to the collection.
|
||||
This document moved to [`maintainers/date-tracking-implementation.md`](maintainers/date-tracking-implementation.md).
|
||||
|
||||
761
docs/EXAMPLES.md
761
docs/EXAMPLES.md
@@ -1,760 +1,3 @@
|
||||
# 💡 Real-World Examples - See Skills in Action
|
||||
# Examples
|
||||
|
||||
**Learn by example!** This guide shows you real conversations using different skills.
|
||||
|
||||
---
|
||||
|
||||
## Example 1: Designing a Feature with @brainstorming
|
||||
|
||||
### The Scenario
|
||||
You want to add a "dark mode" feature to your app, but you're not sure how to approach it.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @brainstorming I want to add dark mode to my React app
|
||||
|
||||
AI: Great! Let me help you think through this. First, let me check your
|
||||
current project structure...
|
||||
|
||||
[AI examines your files]
|
||||
|
||||
I see you're using React with Tailwind CSS. Now, let's understand
|
||||
your requirements:
|
||||
|
||||
What's your primary goal for dark mode?
|
||||
a) User preference (toggle in settings)
|
||||
b) System preference (follow OS setting)
|
||||
c) Both (with manual override)
|
||||
|
||||
You: c) Both
|
||||
|
||||
AI: Perfect! That's the best user experience. Next question:
|
||||
|
||||
Where should the dark mode toggle be located?
|
||||
a) In the main navigation
|
||||
b) In a settings page
|
||||
c) In a dropdown menu
|
||||
d) Multiple locations
|
||||
|
||||
You: a) In the main navigation
|
||||
|
||||
AI: Good choice for accessibility. One more question:
|
||||
|
||||
Should dark mode preference persist across sessions?
|
||||
a) Yes, save to localStorage
|
||||
b) Yes, save to user account (requires backend)
|
||||
c) No, reset each session
|
||||
|
||||
You: a) Yes, save to localStorage
|
||||
|
||||
AI: Excellent! Now I have a clear picture. Let me present the design...
|
||||
|
||||
## Dark Mode Implementation Design
|
||||
|
||||
### Architecture Overview
|
||||
We'll use React Context for state management, Tailwind's dark mode
|
||||
utilities, and localStorage for persistence. The system will:
|
||||
1. Check OS preference on first visit
|
||||
2. Allow manual override via toggle
|
||||
3. Persist preference in localStorage
|
||||
|
||||
Does this approach look good so far?
|
||||
|
||||
You: Yes, continue
|
||||
|
||||
AI: [Continues with detailed design sections...]
|
||||
|
||||
[After design is complete]
|
||||
|
||||
I've saved the design to docs/plans/2026-01-20-dark-mode-design.md
|
||||
|
||||
Ready to set up for implementation?
|
||||
|
||||
You: Yes
|
||||
|
||||
AI: I'll create an isolated workspace using git worktrees and write an
|
||||
implementation plan. One moment...
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ AI asked focused questions one at a time
|
||||
- ✅ Explored your specific context
|
||||
- ✅ Presented design in sections
|
||||
- ✅ Saved documentation
|
||||
- ✅ Prepared for implementation
|
||||
|
||||
---
|
||||
|
||||
## Example 2: Debugging with @systematic-debugging
|
||||
|
||||
### The Scenario
|
||||
Your tests are failing, but you're not sure why.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @systematic-debugging My tests are failing with "Cannot read property
|
||||
'map' of undefined"
|
||||
|
||||
AI: Let me help you debug this systematically. First, I'll gather information:
|
||||
|
||||
1. Running the failing test to see the full error...
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
I see the error occurs in UserList.test.tsx at line 45. Let me examine
|
||||
the test file and the component...
|
||||
|
||||
[AI reads both files]
|
||||
|
||||
## Hypothesis
|
||||
The test is failing because `users` prop is undefined when the component
|
||||
renders. This suggests the mock data isn't being passed correctly.
|
||||
|
||||
## Verification
|
||||
Let me check the test setup...
|
||||
|
||||
[AI examines test]
|
||||
|
||||
Found it! The test is calling:
|
||||
```typescript
|
||||
render(<UserList />)
|
||||
```
|
||||
|
||||
But UserList requires a `users` prop. The component expects:
|
||||
```typescript
|
||||
interface UserListProps {
|
||||
users: User[];
|
||||
}
|
||||
```
|
||||
|
||||
## Solution
|
||||
The test should pass the users prop:
|
||||
```typescript
|
||||
const mockUsers = [
|
||||
{ id: 1, name: 'Alice' },
|
||||
{ id: 2, name: 'Bob' }
|
||||
];
|
||||
|
||||
render(<UserList users={mockUsers} />)
|
||||
```
|
||||
|
||||
Should I apply this fix?
|
||||
|
||||
You: Yes
|
||||
|
||||
AI: [Applies fix and runs tests]
|
||||
|
||||
✅ All tests passing!
|
||||
|
||||
## Root Cause
|
||||
The test was missing required props. This is a common issue when
|
||||
components are refactored to require props that were previously optional.
|
||||
|
||||
## Prevention
|
||||
Consider adding TypeScript strict mode to catch these at compile time:
|
||||
```json
|
||||
"strict": true,
|
||||
"strictNullChecks": true
|
||||
```
|
||||
|
||||
Would you like me to add this to your tsconfig.json?
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ Systematic investigation
|
||||
- ✅ Clear hypothesis
|
||||
- ✅ Verification before fixing
|
||||
- ✅ Root cause analysis
|
||||
- ✅ Prevention suggestions
|
||||
|
||||
---
|
||||
|
||||
## Example 3: Adding Payments with @stripe-integration
|
||||
|
||||
### The Scenario
|
||||
You need to add subscription billing to your SaaS app.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @stripe-integration I need to add monthly subscription billing
|
||||
|
||||
AI: I'll help you implement Stripe subscriptions. Let me understand your
|
||||
requirements:
|
||||
|
||||
Current stack detected:
|
||||
- Next.js 14 (App Router)
|
||||
- TypeScript
|
||||
- Prisma with PostgreSQL
|
||||
|
||||
For subscription billing, we'll need:
|
||||
|
||||
1. **Stripe Setup**
|
||||
- Stripe account and API keys
|
||||
- Webhook endpoint for events
|
||||
- Product and price IDs
|
||||
|
||||
2. **Backend Implementation**
|
||||
- API routes for checkout
|
||||
- Webhook handler
|
||||
- Database schema for subscriptions
|
||||
|
||||
3. **Frontend Implementation**
|
||||
- Pricing page
|
||||
- Checkout flow
|
||||
- Subscription management
|
||||
|
||||
Let's start with the backend. First, install dependencies:
|
||||
|
||||
```bash
|
||||
npm install stripe @stripe/stripe-js
|
||||
```
|
||||
|
||||
Now, let's create the database schema...
|
||||
|
||||
[AI provides Prisma schema]
|
||||
|
||||
```prisma
|
||||
model User {
|
||||
id String @id @default(cuid())
|
||||
email String @unique
|
||||
stripeCustomerId String? @unique
|
||||
subscriptions Subscription[]
|
||||
}
|
||||
|
||||
model Subscription {
|
||||
id String @id @default(cuid())
|
||||
userId String
|
||||
user User @relation(fields: [userId], references: [id])
|
||||
stripeSubscriptionId String @unique
|
||||
status String
|
||||
priceId String
|
||||
currentPeriodEnd DateTime
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
}
|
||||
```
|
||||
|
||||
Next, let's create the checkout API route...
|
||||
|
||||
[AI provides complete implementation with:]
|
||||
- API route for creating checkout sessions
|
||||
- Webhook handler for subscription events
|
||||
- Helper functions for Stripe operations
|
||||
- Error handling and logging
|
||||
- TypeScript types
|
||||
|
||||
Now for the frontend...
|
||||
|
||||
[AI provides:]
|
||||
- Pricing page component
|
||||
- Checkout button component
|
||||
- Subscription status display
|
||||
- Tailwind styling
|
||||
|
||||
Finally, let's set up the webhook:
|
||||
|
||||
1. In Stripe Dashboard, add webhook endpoint:
|
||||
`https://yourdomain.com/api/webhooks/stripe`
|
||||
|
||||
2. Select these events:
|
||||
- customer.subscription.created
|
||||
- customer.subscription.updated
|
||||
- customer.subscription.deleted
|
||||
- invoice.payment_succeeded
|
||||
- invoice.payment_failed
|
||||
|
||||
3. Copy the webhook secret to your .env:
|
||||
```
|
||||
STRIPE_WEBHOOK_SECRET=whsec_...
|
||||
```
|
||||
|
||||
## Testing
|
||||
|
||||
Test locally with Stripe CLI:
|
||||
```bash
|
||||
stripe listen --forward-to localhost:3000/api/webhooks/stripe
|
||||
stripe trigger customer.subscription.created
|
||||
```
|
||||
|
||||
## Security Checklist
|
||||
- ✅ API keys in environment variables
|
||||
- ✅ Webhook signature verification
|
||||
- ✅ Server-side price validation
|
||||
- ✅ Idempotency keys for operations
|
||||
|
||||
Ready to test the implementation?
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ Detected existing stack
|
||||
- ✅ Provided complete implementation
|
||||
- ✅ Included database schema
|
||||
- ✅ Added security best practices
|
||||
- ✅ Included testing instructions
|
||||
|
||||
---
|
||||
|
||||
## Example 4: Writing Copy with @copywriting
|
||||
|
||||
### The Scenario
|
||||
You need compelling copy for your SaaS landing page.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @copywriting Write homepage copy for my project management tool
|
||||
|
||||
AI: I'll help you create compelling homepage copy. First, let me understand
|
||||
your product:
|
||||
|
||||
What makes your project management tool different from competitors
|
||||
like Asana, Trello, or Monday.com?
|
||||
|
||||
You: It's specifically built for remote teams with built-in video standups
|
||||
and async communication features
|
||||
|
||||
AI: Excellent differentiator! Who is your primary target audience?
|
||||
a) Startups and small teams (2-20 people)
|
||||
b) Mid-size companies (20-200 people)
|
||||
c) Enterprise (200+ people)
|
||||
d) Freelancers and agencies
|
||||
|
||||
You: a) Startups and small teams
|
||||
|
||||
AI: Perfect. What's the main pain point you solve?
|
||||
|
||||
You: Remote teams waste time in unnecessary meetings and lose context
|
||||
in async communication
|
||||
|
||||
AI: Great! Now I have what I need. Here's your homepage copy:
|
||||
|
||||
---
|
||||
|
||||
## Hero Section
|
||||
|
||||
**Headline:**
|
||||
Run Your Remote Team Without the Meeting Overload
|
||||
|
||||
**Subheadline:**
|
||||
The project management tool built for distributed teams. Replace
|
||||
status meetings with async video standups and keep everyone in sync
|
||||
without the Zoom fatigue.
|
||||
|
||||
**CTA:**
|
||||
Start Free Trial → (No credit card required)
|
||||
|
||||
---
|
||||
|
||||
## Problem Section
|
||||
|
||||
**Headline:**
|
||||
Remote Work Shouldn't Mean More Meetings
|
||||
|
||||
**Body:**
|
||||
Your team is distributed across time zones. You're spending hours in
|
||||
status meetings just to stay aligned. Async updates get lost in Slack.
|
||||
Context disappears. Productivity suffers.
|
||||
|
||||
Sound familiar?
|
||||
|
||||
---
|
||||
|
||||
## Solution Section
|
||||
|
||||
**Headline:**
|
||||
Stay Aligned Without the Meeting Marathon
|
||||
|
||||
**Features:**
|
||||
|
||||
📹 **Async Video Standups**
|
||||
Record quick video updates on your schedule. Your team watches when
|
||||
it works for them. No more 9am calls for your teammate in Tokyo.
|
||||
|
||||
💬 **Context-Rich Communication**
|
||||
Every task, comment, and decision stays connected. No more hunting
|
||||
through Slack threads or email chains.
|
||||
|
||||
📊 **Visual Progress Tracking**
|
||||
See what's happening at a glance. Kanban boards, timelines, and
|
||||
dashboards that actually make sense.
|
||||
|
||||
🔔 **Smart Notifications**
|
||||
Get notified about what matters. Ignore the rest. Your focus time
|
||||
is sacred.
|
||||
|
||||
---
|
||||
|
||||
## Social Proof Section
|
||||
|
||||
**Headline:**
|
||||
Trusted by Remote Teams Worldwide
|
||||
|
||||
[Testimonial placeholders with structure]
|
||||
|
||||
---
|
||||
|
||||
## CTA Section
|
||||
|
||||
**Headline:**
|
||||
Ready to Reclaim Your Calendar?
|
||||
|
||||
**Body:**
|
||||
Join 500+ remote teams who've cut meeting time by 60% while staying
|
||||
more aligned than ever.
|
||||
|
||||
**CTA:**
|
||||
Start Your Free 14-Day Trial →
|
||||
|
||||
No credit card required. Cancel anytime.
|
||||
|
||||
---
|
||||
|
||||
## Copy Notes
|
||||
|
||||
**Tone:** Professional but conversational
|
||||
**Focus:** Pain point (too many meetings) → Solution (async video)
|
||||
**Differentiation:** Built specifically for remote teams
|
||||
**Social proof:** Quantified benefit (60% fewer meetings)
|
||||
|
||||
Would you like me to:
|
||||
1. Write alternative versions for A/B testing?
|
||||
2. Create copy for specific feature pages?
|
||||
3. Write email sequences for onboarding?
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ Asked clarifying questions
|
||||
- ✅ Identified unique value proposition
|
||||
- ✅ Created benefit-focused copy
|
||||
- ✅ Included clear CTAs
|
||||
- ✅ Provided copy notes for consistency
|
||||
|
||||
---
|
||||
|
||||
## Example 5: Test-Driven Development with @test-driven-development
|
||||
|
||||
### The Scenario
|
||||
You need to implement a new feature: user authentication.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @test-driven-development I need to implement user login functionality
|
||||
|
||||
AI: Perfect! Let's use TDD to build this. Following the Red-Green-Refactor
|
||||
cycle, we'll write tests first, then implement.
|
||||
|
||||
## Step 1: Write the First Test (RED)
|
||||
|
||||
Let's start with the simplest case - successful login:
|
||||
|
||||
```typescript
|
||||
// auth.test.ts
|
||||
import { login } from './auth';
|
||||
|
||||
describe('login', () => {
|
||||
it('should return user data for valid credentials', async () => {
|
||||
const result = await login({
|
||||
email: 'user@example.com',
|
||||
password: 'correct-password'
|
||||
});
|
||||
|
||||
expect(result.success).toBe(true);
|
||||
expect(result.user).toHaveProperty('id');
|
||||
expect(result.user).toHaveProperty('email');
|
||||
expect(result.token).toBeDefined();
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
Let's run this test to see it fail:
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
✅ Test fails as expected (auth.ts doesn't exist yet)
|
||||
|
||||
## Step 2: Write Minimal Implementation (GREEN)
|
||||
|
||||
Now let's write just enough code to make this test pass:
|
||||
|
||||
```typescript
|
||||
// auth.ts
|
||||
interface LoginCredentials {
|
||||
email: string;
|
||||
password: string;
|
||||
}
|
||||
|
||||
interface LoginResult {
|
||||
success: boolean;
|
||||
user?: {
|
||||
id: string;
|
||||
email: string;
|
||||
};
|
||||
token?: string;
|
||||
}
|
||||
|
||||
export async function login(
|
||||
credentials: LoginCredentials
|
||||
): Promise<LoginResult> {
|
||||
// Minimal implementation to pass the test
|
||||
return {
|
||||
success: true,
|
||||
user: {
|
||||
id: '1',
|
||||
email: credentials.email
|
||||
},
|
||||
token: 'fake-token'
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
✅ Test passes!
|
||||
|
||||
## Step 3: Add Next Test (RED)
|
||||
|
||||
Now let's test the failure case:
|
||||
|
||||
```typescript
|
||||
it('should return error for invalid credentials', async () => {
|
||||
const result = await login({
|
||||
email: 'user@example.com',
|
||||
password: 'wrong-password'
|
||||
});
|
||||
|
||||
expect(result.success).toBe(false);
|
||||
expect(result.error).toBe('Invalid credentials');
|
||||
expect(result.user).toBeUndefined();
|
||||
expect(result.token).toBeUndefined();
|
||||
});
|
||||
```
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
❌ Test fails (always returns success)
|
||||
|
||||
## Step 4: Implement Real Logic (GREEN)
|
||||
|
||||
Now let's add actual authentication:
|
||||
|
||||
```typescript
|
||||
import bcrypt from 'bcrypt';
|
||||
import jwt from 'jsonwebtoken';
|
||||
import { db } from './db';
|
||||
|
||||
export async function login(
|
||||
credentials: LoginCredentials
|
||||
): Promise<LoginResult> {
|
||||
// Find user
|
||||
const user = await db.user.findUnique({
|
||||
where: { email: credentials.email }
|
||||
});
|
||||
|
||||
if (!user) {
|
||||
return {
|
||||
success: false,
|
||||
error: 'Invalid credentials'
|
||||
};
|
||||
}
|
||||
|
||||
// Verify password
|
||||
const validPassword = await bcrypt.compare(
|
||||
credentials.password,
|
||||
user.passwordHash
|
||||
);
|
||||
|
||||
if (!validPassword) {
|
||||
return {
|
||||
success: false,
|
||||
error: 'Invalid credentials'
|
||||
};
|
||||
}
|
||||
|
||||
// Generate token
|
||||
const token = jwt.sign(
|
||||
{ userId: user.id },
|
||||
process.env.JWT_SECRET!,
|
||||
{ expiresIn: '7d' }
|
||||
);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
user: {
|
||||
id: user.id,
|
||||
email: user.email
|
||||
},
|
||||
token
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
✅ All tests pass!
|
||||
|
||||
## Step 5: Add Edge Cases
|
||||
|
||||
Let's add more tests for edge cases:
|
||||
|
||||
```typescript
|
||||
it('should handle missing email', async () => {
|
||||
const result = await login({
|
||||
email: '',
|
||||
password: 'password'
|
||||
});
|
||||
|
||||
expect(result.success).toBe(false);
|
||||
expect(result.error).toBe('Email is required');
|
||||
});
|
||||
|
||||
it('should handle missing password', async () => {
|
||||
const result = await login({
|
||||
email: 'user@example.com',
|
||||
password: ''
|
||||
});
|
||||
|
||||
expect(result.success).toBe(false);
|
||||
expect(result.error).toBe('Password is required');
|
||||
});
|
||||
|
||||
it('should handle database errors gracefully', async () => {
|
||||
// Mock database error
|
||||
jest.spyOn(db.user, 'findUnique').mockRejectedValue(
|
||||
new Error('Database connection failed')
|
||||
);
|
||||
|
||||
const result = await login({
|
||||
email: 'user@example.com',
|
||||
password: 'password'
|
||||
});
|
||||
|
||||
expect(result.success).toBe(false);
|
||||
expect(result.error).toBe('An error occurred');
|
||||
});
|
||||
```
|
||||
|
||||
[AI implements validation and error handling]
|
||||
|
||||
## Step 6: Refactor (REFACTOR)
|
||||
|
||||
Now that all tests pass, let's refactor for better code quality:
|
||||
|
||||
```typescript
|
||||
// Extract validation
|
||||
function validateCredentials(credentials: LoginCredentials): string | null {
|
||||
if (!credentials.email) return 'Email is required';
|
||||
if (!credentials.password) return 'Password is required';
|
||||
return null;
|
||||
}
|
||||
|
||||
// Extract user verification
|
||||
async function verifyUser(
|
||||
email: string,
|
||||
password: string
|
||||
): Promise<User | null> {
|
||||
const user = await db.user.findUnique({ where: { email } });
|
||||
if (!user) return null;
|
||||
|
||||
const valid = await bcrypt.compare(password, user.passwordHash);
|
||||
return valid ? user : null;
|
||||
}
|
||||
|
||||
// Main function is now cleaner
|
||||
export async function login(
|
||||
credentials: LoginCredentials
|
||||
): Promise<LoginResult> {
|
||||
try {
|
||||
const validationError = validateCredentials(credentials);
|
||||
if (validationError) {
|
||||
return { success: false, error: validationError };
|
||||
}
|
||||
|
||||
const user = await verifyUser(
|
||||
credentials.email,
|
||||
credentials.password
|
||||
);
|
||||
|
||||
if (!user) {
|
||||
return { success: false, error: 'Invalid credentials' };
|
||||
}
|
||||
|
||||
const token = generateToken(user.id);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
user: { id: user.id, email: user.email },
|
||||
token
|
||||
};
|
||||
} catch (error) {
|
||||
console.error('Login error:', error);
|
||||
return { success: false, error: 'An error occurred' };
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
✅ All tests still pass after refactoring!
|
||||
|
||||
## Summary
|
||||
|
||||
We've implemented login functionality using TDD:
|
||||
- ✅ 5 tests covering happy path, errors, and edge cases
|
||||
- ✅ Clean, testable code
|
||||
- ✅ Proper error handling
|
||||
- ✅ Type safety with TypeScript
|
||||
|
||||
Next steps:
|
||||
1. Add rate limiting tests
|
||||
2. Add session management tests
|
||||
3. Add logout functionality
|
||||
|
||||
Should I continue with these?
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ Followed Red-Green-Refactor cycle
|
||||
- ✅ Wrote tests before implementation
|
||||
- ✅ Covered edge cases
|
||||
- ✅ Refactored with confidence
|
||||
- ✅ Maintained test coverage
|
||||
|
||||
---
|
||||
|
||||
## Key Takeaways
|
||||
|
||||
### What Makes These Examples Effective?
|
||||
|
||||
1. **Skills ask clarifying questions** before jumping to solutions
|
||||
2. **Skills provide context-aware help** based on your project
|
||||
3. **Skills follow best practices** for their domain
|
||||
4. **Skills include complete examples** not just snippets
|
||||
5. **Skills explain the "why"** not just the "how"
|
||||
|
||||
### How to Get Similar Results
|
||||
|
||||
1. **Be specific** in your requests
|
||||
2. **Provide context** about your project
|
||||
3. **Answer questions** the skill asks
|
||||
4. **Review suggestions** before applying
|
||||
5. **Iterate** based on results
|
||||
|
||||
---
|
||||
|
||||
## Try These Yourself!
|
||||
|
||||
Pick a skill and try it with your own project:
|
||||
|
||||
- **Planning:** `@brainstorming` or `@writing-plans`
|
||||
- **Development:** `@test-driven-development` or `@react-best-practices`
|
||||
- **Debugging:** `@systematic-debugging` or `@test-fixing`
|
||||
- **Integration:** `@stripe-integration` or `@firebase`
|
||||
- **Marketing:** `@copywriting` or `@seo-audit`
|
||||
|
||||
---
|
||||
|
||||
**Want more examples?** Check individual skill folders for additional examples and use cases!
|
||||
This document moved to [`contributors/examples.md`](contributors/examples.md).
|
||||
|
||||
198
docs/FAQ.md
198
docs/FAQ.md
@@ -1,197 +1,3 @@
|
||||
# ❓ Frequently Asked Questions (FAQ)
|
||||
# FAQ
|
||||
|
||||
**Got questions?** You're not alone! Here are answers to the most common questions about Antigravity Awesome Skills.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 General Questions
|
||||
|
||||
### What are "skills" exactly?
|
||||
|
||||
Skills are specialized instruction files that teach AI assistants how to handle specific tasks. Think of them as expert knowledge modules that your AI can load on-demand.
|
||||
**Simple analogy:** Just like you might consult different experts (a lawyer, a doctor, a mechanic), these skills let your AI become an expert in different areas when you need them.
|
||||
|
||||
### Do I need to install all 1006+ skills?
|
||||
|
||||
**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 books are there, but you only read the ones you need.
|
||||
**Pro Tip:** Use [Starter Packs](BUNDLES.md) to install only what matches your role.
|
||||
|
||||
### What is the difference between Bundles and Workflows?
|
||||
|
||||
- **Bundles** are curated recommendations grouped by role or domain.
|
||||
- **Workflows** are ordered execution playbooks for concrete outcomes.
|
||||
|
||||
Use bundles when you are deciding _which skills_ to include. Use workflows when you need _step-by-step execution_.
|
||||
|
||||
Start from:
|
||||
|
||||
- [BUNDLES.md](BUNDLES.md)
|
||||
- [WORKFLOWS.md](WORKFLOWS.md)
|
||||
|
||||
### Which AI tools work with these skills?
|
||||
|
||||
- ✅ **Claude Code** (Anthropic CLI)
|
||||
- ✅ **Gemini CLI** (Google)
|
||||
- ✅ **Codex CLI** (OpenAI)
|
||||
- ✅ **Cursor** (AI IDE)
|
||||
- ✅ **Antigravity IDE**
|
||||
- ✅ **OpenCode**
|
||||
- ⚠️ **GitHub Copilot** (partial support via copy-paste)
|
||||
|
||||
### Are these skills free to use?
|
||||
|
||||
**Yes!** This repository is licensed under MIT License.
|
||||
|
||||
- ✅ Free for personal use
|
||||
- ✅ Free for commercial use
|
||||
- ✅ You can modify them
|
||||
|
||||
### Do skills work offline?
|
||||
|
||||
The skill files themselves are stored locally on your computer, but your AI assistant needs an internet connection to function.
|
||||
|
||||
---
|
||||
|
||||
## 🔒 Security & Trust (V4 Update)
|
||||
|
||||
### What do the Risk Labels mean?
|
||||
|
||||
We classify skills so you know what you're running:
|
||||
|
||||
- ⚪ **Safe (White/Blue)**: Read-only, planning, or benign skills.
|
||||
- 🔴 **Risk (Red)**: Skills that modify files (delete), use network scanners, or perform destructive actions. **Use with caution.**
|
||||
- 🟣 **Official (Purple)**: Maintained by trusted vendors (Anthropic, DeepMind, etc.).
|
||||
|
||||
### Can these skills hack my computer?
|
||||
|
||||
**No.** Skills are text files. However, they _instruct_ the AI to run commands. If a skill says "delete all files", a compliant AI might try to do it.
|
||||
_Always check the Risk label and review the code._
|
||||
|
||||
---
|
||||
|
||||
## 📦 Installation & Setup
|
||||
|
||||
### Where should I install the skills?
|
||||
|
||||
The universal path that works with most tools is `.agent/skills/`.
|
||||
|
||||
**Using npx:** `npx antigravity-awesome-skills` (or `npx github:sickn33/antigravity-awesome-skills` if you get a 404).
|
||||
|
||||
**Using git clone:**
|
||||
|
||||
```bash
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
**Tool-specific paths:**
|
||||
|
||||
- Claude Code: `.claude/skills/`
|
||||
- Gemini CLI: `.gemini/skills/`
|
||||
- Codex CLI: `.codex/skills/`
|
||||
- Cursor: `.cursor/skills/` or project root
|
||||
|
||||
### Does this work with Windows?
|
||||
|
||||
**Yes**, but some "Official" skills use **symlinks** which Windows handles poorly by default.
|
||||
Run git with:
|
||||
|
||||
```bash
|
||||
git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
Or enable "Developer Mode" in Windows Settings.
|
||||
|
||||
### How do I update skills?
|
||||
|
||||
Navigate to your skills directory and pull the latest changes:
|
||||
|
||||
```bash
|
||||
cd .agent/skills
|
||||
git pull origin main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Using Skills
|
||||
|
||||
> **💡 For a complete guide with examples, see [USAGE.md](USAGE.md)**
|
||||
|
||||
### How do I invoke a skill?
|
||||
|
||||
Use the `@` symbol followed by the skill name:
|
||||
|
||||
```bash
|
||||
@brainstorming help me design a todo app
|
||||
```
|
||||
|
||||
### Can I use multiple skills at once?
|
||||
|
||||
**Yes!** You can invoke multiple skills:
|
||||
|
||||
```bash
|
||||
@brainstorming help me design this, then use @writing-plans to create a task list.
|
||||
```
|
||||
|
||||
### How do I know which skill to use?
|
||||
|
||||
1. **Browse the catalog**: Check the [Skill Catalog](../CATALOG.md).
|
||||
2. **Search**: `ls skills/ | grep "keyword"`
|
||||
3. **Ask your AI**: "What skills do you have for testing?"
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ Troubleshooting
|
||||
|
||||
### My AI assistant doesn't recognize skills
|
||||
|
||||
**Possible causes:**
|
||||
|
||||
1. **Wrong installation path**: Check your tool's docs. Try `.agent/skills/`.
|
||||
2. **Restart Needed**: Restart your AI/IDE after installing.
|
||||
3. **Typos**: Did you type `@brain-storming` instead of `@brainstorming`?
|
||||
|
||||
### A skill gives incorrect or outdated advice
|
||||
|
||||
Please [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues)!
|
||||
Include:
|
||||
|
||||
- Which skill
|
||||
- What went wrong
|
||||
- What should happen instead
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Contribution
|
||||
|
||||
### I'm new to open source. Can I contribute?
|
||||
|
||||
**Absolutely!** We welcome beginners.
|
||||
|
||||
- Fix typos
|
||||
- Add examples
|
||||
- Improve docs
|
||||
Check out [CONTRIBUTING.md](../CONTRIBUTING.md) for instructions.
|
||||
|
||||
### My PR failed "Quality Bar" check. Why?
|
||||
|
||||
V4 introduces automated quality control. Your skill might be missing:
|
||||
|
||||
1. A valid `description`.
|
||||
2. Usage examples.
|
||||
Run `python3 scripts/validate_skills.py` locally to check before you push.
|
||||
|
||||
### Can I update an "Official" skill?
|
||||
|
||||
**No.** Official skills (in `skills/official/`) are mirrored from vendors. Open an issue instead.
|
||||
|
||||
---
|
||||
|
||||
## 💡 Pro Tips
|
||||
|
||||
- Start with `@brainstorming` before building anything new
|
||||
- Use `@systematic-debugging` when stuck on bugs
|
||||
- Try `@test-driven-development` for better code quality
|
||||
- Explore `@skill-creator` to make your own skills
|
||||
|
||||
**Still confused?** [Open a discussion](https://github.com/sickn33/antigravity-awesome-skills/discussions) and we'll help you out! 🙌
|
||||
This document moved to [`users/faq.md`](users/faq.md).
|
||||
|
||||
@@ -1,142 +1,3 @@
|
||||
# Getting Started with Antigravity Awesome Skills (V7.0.0)
|
||||
# Getting Started
|
||||
|
||||
**New here? This guide will help you supercharge your AI Agent in 5 minutes.**
|
||||
|
||||
> **💡 Confused about what to do after installation?** Check out the [**Complete Usage Guide**](USAGE.md) for detailed explanations and examples!
|
||||
|
||||
---
|
||||
|
||||
## 🤔 What Are "Skills"?
|
||||
|
||||
AI Agents (like **Claude Code**, **Gemini**, **Cursor**) are smart, but they lack specific knowledge about your tools.
|
||||
**Skills** are specialized instruction manuals (markdown files) that teach your AI how to perform specific tasks perfectly, every time.
|
||||
|
||||
**Analogy:** Your AI is a brilliant intern. **Skills** are the SOPs (Standard Operating Procedures) that make them a Senior Engineer.
|
||||
|
||||
---
|
||||
|
||||
## ⚡️ Quick Start: The "Starter Packs"
|
||||
|
||||
Don't panic about the 1,200+ skills. You don't need them all at once.
|
||||
We have curated **Starter Packs** to get you running immediately.
|
||||
|
||||
You **install the full repo once** (npx or clone); Starter Packs are curated lists to help you **pick which skills to use** by role (e.g. Web Wizard, Hacker Pack)—they are not a different way to install.
|
||||
|
||||
### 1. Install the Repo
|
||||
|
||||
**Option A — npx (easiest):**
|
||||
|
||||
```bash
|
||||
npx antigravity-awesome-skills
|
||||
```
|
||||
|
||||
This clones to `~/.gemini/antigravity/skills` by default. Use `--cursor`, `--claude`, `--gemini`, `--codex`, or `--kiro` to install for a specific tool, or `--path <dir>` for a custom location. Run `npx antigravity-awesome-skills --help` for details.
|
||||
|
||||
If you see a 404 error, use: `npx github:sickn33/antigravity-awesome-skills`
|
||||
|
||||
**Option B — git clone:**
|
||||
|
||||
```bash
|
||||
# Universal (works for most agents)
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
### 2. Pick Your Persona
|
||||
|
||||
Find the bundle that matches your role (see [BUNDLES.md](BUNDLES.md)):
|
||||
|
||||
| Persona | Bundle Name | What's Inside? |
|
||||
| :-------------------- | :------------- | :------------------------------------------------ |
|
||||
| **Web Developer** | `Web Wizard` | React Patterns, Tailwind mastery, Frontend Design |
|
||||
| **Security Engineer** | `Hacker Pack` | OWASP, Metasploit, Pentest Methodology |
|
||||
| **Manager / PM** | `Product Pack` | Brainstorming, Planning, SEO, Strategy |
|
||||
| **Everything** | `Essentials` | Clean Code, Planning, Validation (The Basics) |
|
||||
|
||||
---
|
||||
|
||||
## 🧭 Bundles vs Workflows
|
||||
|
||||
Bundles and workflows solve different problems:
|
||||
|
||||
- **Bundles** = curated sets by role (what to pick).
|
||||
- **Workflows** = step-by-step playbooks (how to execute).
|
||||
|
||||
Start with bundles in [BUNDLES.md](BUNDLES.md), then run a workflow from [WORKFLOWS.md](WORKFLOWS.md) when you need guided execution.
|
||||
|
||||
Example:
|
||||
|
||||
> "Use **@antigravity-workflows** and run `ship-saas-mvp` for my project idea."
|
||||
|
||||
---
|
||||
|
||||
## 🚀 How to Use a Skill
|
||||
|
||||
Once installed, just talk to your AI naturally.
|
||||
|
||||
### Example 1: Planning a Feature (**Essentials**)
|
||||
|
||||
> "Use **@brainstorming** to help me design a new login flow."
|
||||
|
||||
**What happens:** The AI loads the brainstorming skill, asks you structured questions, and produces a professional spec.
|
||||
|
||||
### Example 2: Checking Your Code (**Web Wizard**)
|
||||
|
||||
> "Run **@lint-and-validate** on this file and fix errors."
|
||||
|
||||
**What happens:** The AI follows strict linting rules defined in the skill to clean your code.
|
||||
|
||||
### Example 3: Security Audit (**Hacker Pack**)
|
||||
|
||||
> "Use **@api-security-best-practices** to review my API endpoints."
|
||||
|
||||
**What happens:** The AI audits your code against OWASP standards.
|
||||
|
||||
---
|
||||
|
||||
## 🔌 Supported Tools
|
||||
|
||||
| Tool | Status | Path |
|
||||
| :-------------- | :-------------- | :-------------------------------------------------------------------- |
|
||||
| **Claude Code** | ✅ Full Support | `.claude/skills/` |
|
||||
| **Gemini CLI** | ✅ Full Support | `.gemini/skills/` |
|
||||
| **Codex CLI** | ✅ Full Support | `.codex/skills/` |
|
||||
| **Kiro CLI** | ✅ Full Support | Global: `~/.kiro/skills/` · Workspace: `.kiro/skills/` |
|
||||
| **Kiro IDE** | ✅ Full Support | Global: `~/.kiro/skills/` · Workspace: `.kiro/skills/` |
|
||||
| **Antigravity** | ✅ Native | Global: `~/.gemini/antigravity/skills/` · Workspace: `.agent/skills/` |
|
||||
| **Cursor** | ✅ Native | `.cursor/skills/` |
|
||||
| **OpenCode** | ✅ Full Support | `.agents/skills/` |
|
||||
| **AdaL CLI** | ✅ Full Support | `.adal/skills/` |
|
||||
| **Copilot** | ⚠️ Text Only | Manual copy-paste |
|
||||
|
||||
---
|
||||
|
||||
## 🛡️ Trust & Safety (New in V4)
|
||||
|
||||
We classify skills so you know what you're running:
|
||||
|
||||
- 🟣 **Official**: Maintained by Anthropic/Google/Vendors (High Trust).
|
||||
- 🔵 **Safe**: Community skills that are non-destructive (Read-only/Planning).
|
||||
- 🔴 **Risk**: Skills that modify systems or perform security tests (Authorized Use Only).
|
||||
|
||||
_Check the [Skill Catalog](../CATALOG.md) for the full list._
|
||||
|
||||
---
|
||||
|
||||
## ❓ FAQ
|
||||
|
||||
**Q: Do I need to install all 1006+ skills?**
|
||||
A: You clone the whole repo once; your AI only _reads_ the skills you invoke (or that are relevant), so it stays lightweight. **Starter Packs** in [BUNDLES.md](BUNDLES.md) are curated lists to help you discover the right skills for your role—they don't change how you install.
|
||||
|
||||
**Q: Can I make my own skills?**
|
||||
A: Yes! Use the **@skill-creator** skill to build your own.
|
||||
|
||||
**Q: Is this free?**
|
||||
A: Yes, MIT License. Open Source forever.
|
||||
|
||||
---
|
||||
|
||||
## ⏭️ Next Steps
|
||||
|
||||
1. [Browse the Bundles](BUNDLES.md)
|
||||
2. [See Real-World Examples](EXAMPLES.md)
|
||||
3. [Contribute a Skill](../CONTRIBUTING.md)
|
||||
This document moved to [`users/getting-started.md`](users/getting-started.md).
|
||||
|
||||
@@ -1,304 +1,3 @@
|
||||
# Kiro CLI Integration Guide
|
||||
# Kiro Integration
|
||||
|
||||
## Overview
|
||||
|
||||
This guide explains how to use Antigravity Awesome Skills with **Kiro CLI**, AWS's agentic AI-powered coding assistant.
|
||||
|
||||
## What is Kiro?
|
||||
|
||||
Kiro is AWS's agentic AI IDE that combines:
|
||||
|
||||
- **Autonomous coding agents** that work independently for extended periods
|
||||
- **Context-aware assistance** with deep understanding of your codebase
|
||||
- **AWS service integration** with native support for CDK, SAM, and Terraform
|
||||
- **MCP (Model Context Protocol)** for secure external API and database calls
|
||||
- **Spec-driven development** that turns natural language into structured specifications
|
||||
|
||||
## Why Use Skills with Kiro?
|
||||
|
||||
Kiro's agentic capabilities are enhanced by skills that provide:
|
||||
|
||||
- **Domain expertise** across 954+ specialized areas
|
||||
- **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
|
||||
- **Workflow automation** for common development tasks
|
||||
- **AWS-specific patterns** for serverless, infrastructure, and cloud architecture
|
||||
|
||||
## Installation
|
||||
|
||||
### Quick Install
|
||||
|
||||
```bash
|
||||
# Install to Kiro's default skills directory
|
||||
npx antigravity-awesome-skills --kiro
|
||||
```
|
||||
|
||||
This installs skills to `~/.kiro/skills/`
|
||||
|
||||
### Manual Installation
|
||||
|
||||
```bash
|
||||
# Clone directly to Kiro's skills directory
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.kiro/skills
|
||||
```
|
||||
|
||||
### Verification
|
||||
|
||||
```bash
|
||||
# Verify installation
|
||||
test -d ~/.kiro/skills && echo "✓ Skills installed successfully"
|
||||
ls ~/.kiro/skills/skills/ | head -10
|
||||
```
|
||||
|
||||
## Using Skills with Kiro
|
||||
|
||||
### Basic Invocation
|
||||
|
||||
Kiro uses natural language prompts to invoke skills:
|
||||
|
||||
```
|
||||
Use the @brainstorming skill to help me design a serverless API
|
||||
```
|
||||
|
||||
```
|
||||
Apply @aws-serverless patterns to this Lambda function
|
||||
```
|
||||
|
||||
```
|
||||
Run @security-audit on my CDK stack
|
||||
```
|
||||
|
||||
### Recommended Skills for Kiro Users
|
||||
|
||||
#### AWS & Cloud Infrastructure
|
||||
|
||||
- `@aws-serverless` - Serverless architecture patterns
|
||||
- `@aws-cdk` - AWS CDK best practices
|
||||
- `@aws-sam` - SAM template patterns
|
||||
- `@terraform-expert` - Terraform infrastructure as code
|
||||
- `@docker-expert` - Container optimization
|
||||
- `@kubernetes-expert` - K8s deployment patterns
|
||||
|
||||
#### Architecture & Design
|
||||
|
||||
- `@architecture` - System design and ADRs
|
||||
- `@c4-context` - C4 model diagrams
|
||||
- `@senior-architect` - Scalable architecture patterns
|
||||
- `@microservices-patterns` - Microservices design
|
||||
|
||||
#### Security
|
||||
|
||||
- `@api-security-best-practices` - API security hardening
|
||||
- `@vulnerability-scanner` - Security vulnerability detection
|
||||
- `@owasp-top-10` - OWASP security patterns
|
||||
- `@aws-security-best-practices` - AWS security configuration
|
||||
|
||||
#### Development
|
||||
|
||||
- `@typescript-expert` - TypeScript best practices
|
||||
- `@python-patterns` - Python design patterns
|
||||
- `@react-patterns` - React component patterns
|
||||
- `@test-driven-development` - TDD workflows
|
||||
|
||||
#### DevOps & Automation
|
||||
|
||||
- `@ci-cd-pipeline` - CI/CD automation
|
||||
- `@github-actions` - GitHub Actions workflows
|
||||
- `@monitoring-observability` - Observability patterns
|
||||
- `@incident-response` - Incident management
|
||||
|
||||
## Kiro-Specific Workflows
|
||||
|
||||
### 1. Serverless Application Development
|
||||
|
||||
```
|
||||
1. Use @brainstorming to design the application architecture
|
||||
2. Apply @aws-serverless to create Lambda functions
|
||||
3. Use @aws-cdk to generate infrastructure code
|
||||
4. Run @test-driven-development to add tests
|
||||
5. Apply @ci-cd-pipeline to set up deployment
|
||||
```
|
||||
|
||||
### 2. Infrastructure as Code
|
||||
|
||||
```
|
||||
1. Use @architecture to document the system design
|
||||
2. Apply @terraform-expert to write Terraform modules
|
||||
3. Run @security-audit to check for vulnerabilities
|
||||
4. Use @documentation to generate README and runbooks
|
||||
```
|
||||
|
||||
### 3. API Development
|
||||
|
||||
```
|
||||
1. Use @api-design to plan endpoints
|
||||
2. Apply @typescript-expert for implementation
|
||||
3. Run @api-security-best-practices for hardening
|
||||
4. Use @openapi-spec to generate documentation
|
||||
```
|
||||
|
||||
## Advanced Features
|
||||
|
||||
### MCP Integration
|
||||
|
||||
Kiro's MCP support allows skills to:
|
||||
|
||||
- Call external APIs securely
|
||||
- Query databases with context
|
||||
- Integrate with AWS services
|
||||
- Access documentation in real-time
|
||||
|
||||
Skills that leverage MCP:
|
||||
|
||||
- `@rag-engineer` - RAG system implementation
|
||||
- `@langgraph` - Agent workflow orchestration
|
||||
- `@prompt-engineer` - LLM prompt optimization
|
||||
|
||||
### Autonomous Operation
|
||||
|
||||
Kiro can work independently for extended periods. Use skills to guide long-running tasks:
|
||||
|
||||
```
|
||||
Use @systematic-debugging to investigate and fix all TypeScript errors in the codebase,
|
||||
then apply @test-driven-development to add missing tests, and finally run @documentation
|
||||
to update all README files.
|
||||
```
|
||||
|
||||
### Context-Aware Assistance
|
||||
|
||||
Kiro maintains deep context. Reference multiple skills in complex workflows:
|
||||
|
||||
```
|
||||
I'm building a SaaS application. Use @brainstorming for the MVP plan,
|
||||
@aws-serverless for the backend, @react-patterns for the frontend,
|
||||
@stripe-integration for payments, and @security-audit for hardening.
|
||||
```
|
||||
|
||||
## Bundles for Kiro Users
|
||||
|
||||
Pre-curated skill collections optimized for common Kiro use cases:
|
||||
|
||||
### AWS Developer Bundle
|
||||
|
||||
- `@aws-serverless`
|
||||
- `@aws-cdk`
|
||||
- `@aws-sam`
|
||||
- `@lambda-best-practices`
|
||||
- `@dynamodb-patterns`
|
||||
- `@api-gateway-patterns`
|
||||
|
||||
### Full-Stack AWS Bundle
|
||||
|
||||
- `@aws-serverless`
|
||||
- `@react-patterns`
|
||||
- `@typescript-expert`
|
||||
- `@api-design`
|
||||
- `@test-driven-development`
|
||||
- `@ci-cd-pipeline`
|
||||
|
||||
### DevOps & Infrastructure Bundle
|
||||
|
||||
- `@terraform-expert`
|
||||
- `@docker-expert`
|
||||
- `@kubernetes-expert`
|
||||
- `@monitoring-observability`
|
||||
- `@incident-response`
|
||||
- `@security-audit`
|
||||
|
||||
See [BUNDLES.md](BUNDLES.md) for complete bundle listings.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Skills Not Loading
|
||||
|
||||
```bash
|
||||
# Check installation path
|
||||
ls -la ~/.kiro/skills/
|
||||
|
||||
# Reinstall if needed
|
||||
rm -rf ~/.kiro/skills
|
||||
npx antigravity-awesome-skills --kiro
|
||||
```
|
||||
|
||||
### Skill Not Found
|
||||
|
||||
Ensure you're using the correct skill name:
|
||||
|
||||
```bash
|
||||
# List all available skills
|
||||
ls ~/.kiro/skills/skills/
|
||||
```
|
||||
|
||||
### Permission Issues
|
||||
|
||||
```bash
|
||||
# Fix permissions
|
||||
chmod -R 755 ~/.kiro/skills/
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Start with bundles** - Use pre-curated collections for your role
|
||||
2. **Combine skills** - Reference multiple skills in complex tasks
|
||||
3. **Be specific** - Clearly state which skill to use and what to do
|
||||
4. **Iterate** - Let Kiro work autonomously, then refine with additional skills
|
||||
5. **Document** - Use `@documentation` to keep your codebase well-documented
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1: Build a Serverless API
|
||||
|
||||
```
|
||||
I need to build a REST API for a todo application using AWS Lambda and DynamoDB.
|
||||
|
||||
Use @brainstorming to design the architecture, then apply @aws-serverless
|
||||
to implement the Lambda functions, @dynamodb-patterns for data modeling,
|
||||
and @api-security-best-practices for security hardening.
|
||||
|
||||
Generate the infrastructure using @aws-cdk and add tests with @test-driven-development.
|
||||
```
|
||||
|
||||
### Example 2: Migrate to Microservices
|
||||
|
||||
```
|
||||
I want to break down this monolithic application into microservices.
|
||||
|
||||
Use @architecture to create an ADR for the migration strategy,
|
||||
apply @microservices-patterns for service boundaries,
|
||||
@docker-expert for containerization, and @kubernetes-expert for orchestration.
|
||||
|
||||
Document the migration plan with @documentation.
|
||||
```
|
||||
|
||||
### Example 3: Security Audit
|
||||
|
||||
```
|
||||
Perform a comprehensive security audit of this application.
|
||||
|
||||
Use @security-audit to scan for vulnerabilities, @owasp-top-10 to check
|
||||
for common issues, @api-security-best-practices for API hardening,
|
||||
and @aws-security-best-practices for cloud configuration.
|
||||
|
||||
Generate a report with findings and remediation steps.
|
||||
```
|
||||
|
||||
## Resources
|
||||
|
||||
- [Kiro Official Documentation](https://kiro.dev)
|
||||
- [AWS Blog: Transform DevOps with Kiro](https://aws.amazon.com/blogs/publicsector/transform-devops-practice-with-kiro-ai-powered-agents/)
|
||||
- [Complete Skills Catalog](../CATALOG.md)
|
||||
- [Usage Guide](USAGE.md)
|
||||
- [Workflow Examples](WORKFLOWS.md)
|
||||
|
||||
## Contributing
|
||||
|
||||
Found a Kiro-specific use case or workflow? Contribute to this guide:
|
||||
|
||||
1. Fork the repository
|
||||
2. Add your examples to this file
|
||||
3. Submit a pull request
|
||||
|
||||
## Support
|
||||
|
||||
- **Issues**: [GitHub Issues](https://github.com/sickn33/antigravity-awesome-skills/issues)
|
||||
- **Discussions**: [GitHub Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions)
|
||||
- **Community**: [Community Guidelines](COMMUNITY_GUIDELINES.md)
|
||||
This document moved to [`users/kiro-integration.md`](users/kiro-integration.md).
|
||||
|
||||
@@ -1,66 +1,3 @@
|
||||
# 🏆 Quality Bar & Validation Standards
|
||||
# Quality Bar
|
||||
|
||||
To transform **Antigravity Awesome Skills** from a collection of scripts into a trusted platform, every skill must meet a specific standard of quality and safety.
|
||||
|
||||
## The "Validated" Badge ✅
|
||||
|
||||
A skill earns the "Validated" badge only if it passes these **5 automated checks**:
|
||||
|
||||
### 1. Metadata Integrity
|
||||
|
||||
The `SKILL.md` frontmatter must be valid YAML and contain:
|
||||
|
||||
- `name`: Kebab-case, matches folder name.
|
||||
- `description`: Under 200 chars, clear value prop.
|
||||
- `risk`: One of `[none, safe, critical, offensive, unknown]`. Use `unknown` only for legacy or unclassified skills; prefer a concrete level for new skills.
|
||||
- `source`: URL to original source (or "self" if original).
|
||||
|
||||
### 2. Clear Triggers ("When to use")
|
||||
|
||||
The skill MUST have a section explicitly stating when to trigger it.
|
||||
|
||||
- **Good**: "Use when the user asks to debug a React component."
|
||||
- **Bad**: "This skill helps you with code."
|
||||
Accepted headings: `## When to Use`, `## Use this skill when`, `## When to Use This Skill`.
|
||||
|
||||
### 3. Safety & Risk Classification
|
||||
|
||||
Every skill must declare its risk level:
|
||||
|
||||
- 🟢 **none**: Pure text/reasoning (e.g., Brainstorming).
|
||||
- 🔵 **safe**: Reads files, runs safe commands (e.g., Linter).
|
||||
- 🟠 **critical**: Modifies state, deletes files, pushes to prod (e.g., Git Push).
|
||||
- 🔴 **offensive**: Pentesting/Red Team tools. **MUST** have "Authorized Use Only" warning.
|
||||
|
||||
### 4. Copy-Pasteable Examples
|
||||
|
||||
At least one code block or interaction example that a user (or agent) can immediately use.
|
||||
|
||||
### 5. Explicit Limitations
|
||||
|
||||
A list of known edge cases or things the skill _cannot_ do.
|
||||
|
||||
- _Example_: "Does not work on Windows without WSL."
|
||||
|
||||
---
|
||||
|
||||
## Support Levels
|
||||
|
||||
We also categorize skills by who maintains them:
|
||||
|
||||
| Level | Badge | Meaning |
|
||||
| :------------ | :---- | :-------------------------------------------------- |
|
||||
| **Official** | 🟣 | Maintained by the core team. High reliability. |
|
||||
| **Community** | ⚪ | Contributed by the ecosystem. Best effort support. |
|
||||
| **Verified** | ✨ | Community skill that has passed deep manual review. |
|
||||
|
||||
---
|
||||
|
||||
## How to Validate Your Skill
|
||||
|
||||
The canonical validator is `scripts/validate_skills.py`. Run `npm run validate` (or `npm run validate:strict`) before submitting a PR:
|
||||
|
||||
```bash
|
||||
npm run validate # soft mode (warnings only)
|
||||
npm run validate:strict # strict mode (CI uses this)
|
||||
```
|
||||
This document moved to [`contributors/quality-bar.md`](contributors/quality-bar.md).
|
||||
|
||||
38
docs/README.md
Normal file
38
docs/README.md
Normal file
@@ -0,0 +1,38 @@
|
||||
# Documentation Index
|
||||
|
||||
## Users
|
||||
|
||||
- [`users/getting-started.md`](users/getting-started.md)
|
||||
- [`users/usage.md`](users/usage.md)
|
||||
- [`users/faq.md`](users/faq.md)
|
||||
- [`users/bundles.md`](users/bundles.md)
|
||||
- [`users/workflows.md`](users/workflows.md)
|
||||
- [`users/kiro-integration.md`](users/kiro-integration.md)
|
||||
- [`users/visual-guide.md`](users/visual-guide.md)
|
||||
|
||||
## Contributors
|
||||
|
||||
- [`../CONTRIBUTING.md`](../CONTRIBUTING.md)
|
||||
- [`contributors/skill-template.md`](contributors/skill-template.md)
|
||||
- [`contributors/skill-anatomy.md`](contributors/skill-anatomy.md)
|
||||
- [`contributors/examples.md`](contributors/examples.md)
|
||||
- [`contributors/quality-bar.md`](contributors/quality-bar.md)
|
||||
- [`contributors/security-guardrails.md`](contributors/security-guardrails.md)
|
||||
- [`contributors/community-guidelines.md`](contributors/community-guidelines.md)
|
||||
|
||||
## Maintainers
|
||||
|
||||
- [`maintainers/release-process.md`](maintainers/release-process.md)
|
||||
- [`maintainers/rollback-procedure.md`](maintainers/rollback-procedure.md)
|
||||
- [`maintainers/audit.md`](maintainers/audit.md)
|
||||
- [`maintainers/ci-drift-fix.md`](maintainers/ci-drift-fix.md)
|
||||
- [`maintainers/skills-update-guide.md`](maintainers/skills-update-guide.md)
|
||||
- [`maintainers/categorization-implementation.md`](maintainers/categorization-implementation.md)
|
||||
- [`maintainers/date-tracking-implementation.md`](maintainers/date-tracking-implementation.md)
|
||||
- [`maintainers/skills-date-tracking.md`](maintainers/skills-date-tracking.md)
|
||||
|
||||
## Sources
|
||||
|
||||
- [`sources/sources.md`](sources/sources.md)
|
||||
- [`sources/LICENSE-MICROSOFT`](sources/LICENSE-MICROSOFT)
|
||||
- [`sources/microsoft-skills-attribution.json`](sources/microsoft-skills-attribution.json)
|
||||
@@ -1,51 +1,3 @@
|
||||
# 🛡️ Security Guardrails & Policy
|
||||
# Security Guardrails
|
||||
|
||||
Antigravity Awesome Skills is a powerful toolkit. With great power comes great responsibility. This document defines the **Rules of Engagement** for all security and offensive capabilities in this repository.
|
||||
|
||||
## 🔴 Offensive Skills Policy (The "Red Line")
|
||||
|
||||
**What is an Offensive Skill?**
|
||||
Any skill designed to penetrate, exploit, disrupt, or simulate attacks against systems.
|
||||
_Examples: Pentesting, SQL Injection, Phishing Simulation, Red Teaming._
|
||||
|
||||
### 1. The "Authorized Use Only" Disclaimer
|
||||
|
||||
Every offensive skill **MUST** begin with this exact disclaimer in its `SKILL.md`:
|
||||
|
||||
> **⚠️ AUTHORIZED USE ONLY**
|
||||
> This skill is for educational purposes or authorized security assessments only.
|
||||
> You must have explicit, written permission from the system owner before using this tool.
|
||||
> Misuse of this tool is illegal and strictly prohibited.
|
||||
|
||||
### 2. Mandatory User Confirmation
|
||||
|
||||
Offensive skills must **NEVER** run fully autonomously.
|
||||
|
||||
- **Requirement**: The skill description/instructions must explicitly tell the agent to _ask for user confirmation_ before executing any exploit or attack command.
|
||||
- **Agent Instruction**: "Ask the user to verify the target URL/IP before running."
|
||||
|
||||
### 3. Safe by Design
|
||||
|
||||
- **No Weaponized Payloads**: Skills should not include active malware, ransomware, or non-educational exploits.
|
||||
- **Sandbox Recommended**: Instructions should recommend running in a contained environment (Docker/VM).
|
||||
|
||||
---
|
||||
|
||||
## 🔵 Defensive Skills Policy
|
||||
|
||||
**What is a Defensive Skill?**
|
||||
Tools for hardening, auditing, monitoring, or protecting systems.
|
||||
_Examples: Linting, Log Analysis, Configuration Auditing._
|
||||
|
||||
- **Data Privacy**: Defensive skills must not upload data to 3rd party servers without explicit user consent.
|
||||
- **Non-Destructive**: Audits should be read-only by default.
|
||||
|
||||
---
|
||||
|
||||
## ⚖️ Legal Disclaimer
|
||||
|
||||
By using this repository, you agree that:
|
||||
|
||||
1. You are responsible for your own actions.
|
||||
2. The authors and contributors are not liable for any damage caused by these tools.
|
||||
3. You will comply with all local, state, and federal laws regarding cybersecurity.
|
||||
This document moved to [`contributors/security-guardrails.md`](contributors/security-guardrails.md).
|
||||
|
||||
1723
docs/SEC_SKILLS.md
1723
docs/SEC_SKILLS.md
File diff suppressed because it is too large
Load Diff
@@ -1,221 +1,3 @@
|
||||
# Skills Date Tracking Guide
|
||||
# Skills Date Tracking
|
||||
|
||||
This guide explains how to use the new `date_added` feature for tracking when skills were created or added to the collection.
|
||||
|
||||
## Overview
|
||||
|
||||
The `date_added` field in skill frontmatter allows you to track when each skill was created. This is useful for:
|
||||
|
||||
- **Versioning**: Understanding skill age and maturity
|
||||
- **Changelog generation**: Tracking new skills over time
|
||||
- **Reporting**: Analyzing skill collection growth
|
||||
- **Organization**: Grouping skills by creation date
|
||||
|
||||
## Format
|
||||
|
||||
The `date_added` field uses ISO 8601 date format: **YYYY-MM-DD**
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: my-skill-name
|
||||
description: "Brief description"
|
||||
date_added: "2024-01-15"
|
||||
---
|
||||
```
|
||||
|
||||
## Quick Start
|
||||
|
||||
### 1. View All Skills with Their Dates
|
||||
|
||||
```bash
|
||||
python scripts/manage_skill_dates.py list
|
||||
```
|
||||
|
||||
Output example:
|
||||
```
|
||||
📅 Skills with Date Added (245):
|
||||
============================================================
|
||||
2025-02-26 │ recent-skill
|
||||
2025-02-20 │ another-new-skill
|
||||
2024-12-15 │ older-skill
|
||||
...
|
||||
|
||||
⏳ Skills without Date Added (5):
|
||||
============================================================
|
||||
some-legacy-skill
|
||||
undated-skill
|
||||
...
|
||||
|
||||
📊 Coverage: 245/250 (98.0%)
|
||||
```
|
||||
|
||||
### 2. Add Missing Dates
|
||||
|
||||
Add today's date to all skills that don't have a `date_added` field:
|
||||
|
||||
```bash
|
||||
python scripts/manage_skill_dates.py add-missing
|
||||
```
|
||||
|
||||
Or specify a custom date:
|
||||
|
||||
```bash
|
||||
python scripts/manage_skill_dates.py add-missing --date 2024-01-15
|
||||
```
|
||||
|
||||
### 3. Add/Update All Skills
|
||||
|
||||
Set a date for all skills at once:
|
||||
|
||||
```bash
|
||||
python scripts/manage_skill_dates.py add-all --date 2024-01-01
|
||||
```
|
||||
|
||||
### 4. Update a Single Skill
|
||||
|
||||
Update a specific skill's date:
|
||||
|
||||
```bash
|
||||
python scripts/manage_skill_dates.py update my-skill-name 2024-06-15
|
||||
```
|
||||
|
||||
### 5. Generate a Report
|
||||
|
||||
Generate a JSON report of all skills with their metadata:
|
||||
|
||||
```bash
|
||||
python scripts/generate_skills_report.py
|
||||
```
|
||||
|
||||
Save to file:
|
||||
|
||||
```bash
|
||||
python scripts/generate_skills_report.py --output skills_report.json
|
||||
```
|
||||
|
||||
Sort by name:
|
||||
|
||||
```bash
|
||||
python scripts/generate_skills_report.py --sort name --output sorted_skills.json
|
||||
```
|
||||
|
||||
## Usage in Your Workflow
|
||||
|
||||
### When Creating a New Skill
|
||||
|
||||
Add the `date_added` field to your SKILL.md frontmatter:
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: new-awesome-skill
|
||||
description: "Does something awesome"
|
||||
date_added: "2025-02-26"
|
||||
---
|
||||
```
|
||||
|
||||
### Automated Addition
|
||||
|
||||
When onboarding many skills, use:
|
||||
|
||||
```bash
|
||||
python scripts/manage_skill_dates.py add-missing --date 2025-02-26
|
||||
```
|
||||
|
||||
This adds today's date to all skills that are missing the field.
|
||||
|
||||
### Validation
|
||||
|
||||
The validators now check `date_added` format:
|
||||
|
||||
```bash
|
||||
# Run Python validator (strict mode)
|
||||
python scripts/validate_skills.py --strict
|
||||
|
||||
# Run JavaScript validator
|
||||
npm run validate
|
||||
```
|
||||
|
||||
Both will flag invalid dates (must be YYYY-MM-DD format).
|
||||
|
||||
## Generated Reports
|
||||
|
||||
The `generate_skills_report.py` script produces a JSON report with statistics:
|
||||
|
||||
```json
|
||||
{
|
||||
"generated_at": "2025-02-26T10:30:00.123456",
|
||||
"total_skills": 250,
|
||||
"skills_with_dates": 245,
|
||||
"skills_without_dates": 5,
|
||||
"coverage_percentage": 98.0,
|
||||
"sorted_by": "date",
|
||||
"skills": [
|
||||
{
|
||||
"id": "recent-skill",
|
||||
"name": "recent-skill",
|
||||
"description": "A newly added skill",
|
||||
"date_added": "2025-02-26",
|
||||
"source": "community",
|
||||
"risk": "safe",
|
||||
"category": "recent"
|
||||
},
|
||||
...
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Use this for:
|
||||
- Dashboard displays
|
||||
- Growth metrics
|
||||
- Automated reports
|
||||
- Analytics
|
||||
|
||||
## Integration with CI/CD
|
||||
|
||||
Add to your pipeline:
|
||||
|
||||
```bash
|
||||
# In pre-commit or CI pipeline
|
||||
python scripts/validate_skills.py --strict
|
||||
|
||||
# Generate stats report
|
||||
python scripts/generate_skills_report.py --output reports/skills_report.json
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Use consistent format**: Always use `YYYY-MM-DD`
|
||||
2. **Use real dates**: Reflect actual skill creation dates when possible
|
||||
3. **Update on creation**: Add the date when creating new skills
|
||||
4. **Validate regularly**: Run validators to catch format errors
|
||||
5. **Review reports**: Use generated reports to understand collection trends
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Invalid date_added format"
|
||||
|
||||
Make sure the date is in `YYYY-MM-DD` format:
|
||||
- ✅ Correct: `2024-01-15`
|
||||
- ❌ Wrong: `01/15/2024` or `2024-1-15`
|
||||
|
||||
### Script not found
|
||||
|
||||
Make sure you're running from the project root:
|
||||
```bash
|
||||
cd path/to/antigravity-awesome-skills
|
||||
python scripts/manage_skill_dates.py list
|
||||
```
|
||||
|
||||
### Python not found
|
||||
|
||||
Install Python 3.x from [python.org](https://python.org/)
|
||||
|
||||
## Related Documentation
|
||||
|
||||
- [SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md) - Complete skill structure guide
|
||||
- [SKILLS_UPDATE_GUIDE.md](SKILLS_UPDATE_GUIDE.md) - How to update the skill collection
|
||||
- [EXAMPLES.md](docs/EXAMPLES.md) - Example skills
|
||||
|
||||
## Questions or Issues?
|
||||
|
||||
See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
|
||||
This document moved to [`maintainers/skills-date-tracking.md`](maintainers/skills-date-tracking.md).
|
||||
|
||||
@@ -1,545 +1,3 @@
|
||||
# Anatomy of a Skill - Understanding the Structure
|
||||
# Skill Anatomy
|
||||
|
||||
**Want to understand how skills work under the hood?** This guide breaks down every part of a skill file.
|
||||
|
||||
---
|
||||
|
||||
## 📁 Basic Folder Structure
|
||||
|
||||
```
|
||||
skills/
|
||||
└── my-skill-name/
|
||||
├── SKILL.md ← Required: The main skill definition
|
||||
├── examples/ ← Optional: Example files
|
||||
│ ├── example1.js
|
||||
│ └── example2.py
|
||||
├── scripts/ ← Optional: Helper scripts
|
||||
│ └── helper.sh
|
||||
├── templates/ ← Optional: Code templates
|
||||
│ └── template.tsx
|
||||
├── references/ ← Optional: Reference documentation
|
||||
│ └── api-docs.md
|
||||
└── README.md ← Optional: Additional documentation
|
||||
```
|
||||
|
||||
**Key Rule:** Only `SKILL.md` is required. Everything else is optional!
|
||||
|
||||
---
|
||||
|
||||
## SKILL.md Structure
|
||||
|
||||
Every `SKILL.md` file has two main parts:
|
||||
|
||||
### 1. Frontmatter (Metadata)
|
||||
### 2. Content (Instructions)
|
||||
|
||||
Let's break down each part:
|
||||
|
||||
---
|
||||
|
||||
## Part 1: Frontmatter
|
||||
|
||||
The frontmatter is at the very top, wrapped in `---`:
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: my-skill-name
|
||||
description: "Brief description of what this skill does"
|
||||
---
|
||||
```
|
||||
|
||||
### Required Fields
|
||||
|
||||
#### `name`
|
||||
- **What it is:** The skill's identifier
|
||||
- **Format:** lowercase-with-hyphens
|
||||
- **Must match:** The folder name exactly
|
||||
- **Example:** `stripe-integration`
|
||||
|
||||
#### `description`
|
||||
- **What it is:** One-sentence summary
|
||||
- **Format:** String in quotes
|
||||
- **Length:** Keep it under 150 characters
|
||||
- **Example:** `"Stripe payment integration patterns including checkout, subscriptions, and webhooks"`
|
||||
|
||||
### Optional Fields
|
||||
|
||||
Some skills include additional metadata:
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: my-skill-name
|
||||
description: "Brief description"
|
||||
version: "1.0.0"
|
||||
author: "Your Name"
|
||||
tags: ["react", "typescript", "testing"]
|
||||
---
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Part 2: Content
|
||||
|
||||
After the frontmatter comes the actual skill content. Here's the recommended structure:
|
||||
|
||||
### Recommended Sections
|
||||
|
||||
#### 1. Title (H1)
|
||||
```markdown
|
||||
# Skill Title
|
||||
```
|
||||
- Use a clear, descriptive title
|
||||
- Usually matches or expands on the skill name
|
||||
|
||||
#### 2. Overview
|
||||
```markdown
|
||||
## Overview
|
||||
|
||||
A brief explanation of what this skill does and why it exists.
|
||||
2-4 sentences is perfect.
|
||||
```
|
||||
|
||||
#### 3. When to Use
|
||||
```markdown
|
||||
## When to Use This Skill
|
||||
|
||||
- Use when you need to [scenario 1]
|
||||
- Use when working with [scenario 2]
|
||||
- Use when the user asks about [scenario 3]
|
||||
```
|
||||
|
||||
**Why this matters:** Helps the AI know when to activate this skill
|
||||
|
||||
#### 4. Core Instructions
|
||||
```markdown
|
||||
## How It Works
|
||||
|
||||
### Step 1: [Action]
|
||||
Detailed instructions...
|
||||
|
||||
### Step 2: [Action]
|
||||
More instructions...
|
||||
```
|
||||
|
||||
**This is the heart of your skill** - clear, actionable steps
|
||||
|
||||
#### 5. Examples
|
||||
```markdown
|
||||
## Examples
|
||||
|
||||
### Example 1: [Use Case]
|
||||
\`\`\`javascript
|
||||
// Example code
|
||||
\`\`\`
|
||||
|
||||
### Example 2: [Another Use Case]
|
||||
\`\`\`javascript
|
||||
// More code
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
**Why examples matter:** They show the AI exactly what good output looks like
|
||||
|
||||
#### 6. Best Practices
|
||||
```markdown
|
||||
## Best Practices
|
||||
|
||||
- ✅ Do this
|
||||
- ✅ Also do this
|
||||
- ❌ Don't do this
|
||||
- ❌ Avoid this
|
||||
```
|
||||
|
||||
#### 7. Common Pitfalls
|
||||
```markdown
|
||||
## Common Pitfalls
|
||||
|
||||
- **Problem:** Description
|
||||
**Solution:** How to fix it
|
||||
```
|
||||
|
||||
#### 8. Related Skills
|
||||
```markdown
|
||||
## Related Skills
|
||||
|
||||
- `@other-skill` - When to use this instead
|
||||
- `@complementary-skill` - How this works together
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Writing Effective Instructions
|
||||
|
||||
### Use Clear, Direct Language
|
||||
|
||||
**❌ Bad:**
|
||||
```markdown
|
||||
You might want to consider possibly checking if the user has authentication.
|
||||
```
|
||||
|
||||
**✅ Good:**
|
||||
```markdown
|
||||
Check if the user is authenticated before proceeding.
|
||||
```
|
||||
|
||||
### Use Action Verbs
|
||||
|
||||
**❌ Bad:**
|
||||
```markdown
|
||||
The file should be created...
|
||||
```
|
||||
|
||||
**✅ Good:**
|
||||
```markdown
|
||||
Create the file...
|
||||
```
|
||||
|
||||
### Be Specific
|
||||
|
||||
**❌ Bad:**
|
||||
```markdown
|
||||
Set up the database properly.
|
||||
```
|
||||
|
||||
**✅ Good:**
|
||||
```markdown
|
||||
1. Create a PostgreSQL database
|
||||
2. Run migrations: `npm run migrate`
|
||||
3. Seed initial data: `npm run seed`
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Optional Components
|
||||
|
||||
### Scripts Directory
|
||||
|
||||
If your skill needs helper scripts:
|
||||
|
||||
```
|
||||
scripts/
|
||||
├── setup.sh ← Setup automation
|
||||
├── validate.py ← Validation tools
|
||||
└── generate.js ← Code generators
|
||||
```
|
||||
|
||||
**Reference them in SKILL.md:**
|
||||
```markdown
|
||||
Run the setup script:
|
||||
\`\`\`bash
|
||||
bash scripts/setup.sh
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
### Examples Directory
|
||||
|
||||
Real-world examples that demonstrate the skill:
|
||||
|
||||
```
|
||||
examples/
|
||||
├── basic-usage.js
|
||||
├── advanced-pattern.ts
|
||||
└── full-implementation/
|
||||
├── index.js
|
||||
└── config.json
|
||||
```
|
||||
|
||||
### Templates Directory
|
||||
|
||||
Reusable code templates:
|
||||
|
||||
```
|
||||
templates/
|
||||
├── component.tsx
|
||||
├── test.spec.ts
|
||||
└── config.json
|
||||
```
|
||||
|
||||
**Reference in SKILL.md:**
|
||||
```markdown
|
||||
Use this template as a starting point:
|
||||
\`\`\`typescript
|
||||
{{#include templates/component.tsx}}
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
### References Directory
|
||||
|
||||
External documentation or API references:
|
||||
|
||||
```
|
||||
references/
|
||||
├── api-docs.md
|
||||
├── best-practices.md
|
||||
└── troubleshooting.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Skill Size Guidelines
|
||||
|
||||
### Minimum Viable Skill
|
||||
- **Frontmatter:** name + description
|
||||
- **Content:** 100-200 words
|
||||
- **Sections:** Overview + Instructions
|
||||
|
||||
### Standard Skill
|
||||
- **Frontmatter:** name + description
|
||||
- **Content:** 300-800 words
|
||||
- **Sections:** Overview + When to Use + Instructions + Examples
|
||||
|
||||
### Comprehensive Skill
|
||||
- **Frontmatter:** name + description + optional fields
|
||||
- **Content:** 800-2000 words
|
||||
- **Sections:** All recommended sections
|
||||
- **Extras:** Scripts, examples, templates
|
||||
|
||||
**Rule of thumb:** Start small, expand based on feedback
|
||||
|
||||
---
|
||||
|
||||
## Formatting Best Practices
|
||||
|
||||
### Use Markdown Effectively
|
||||
|
||||
#### Code Blocks
|
||||
Always specify the language:
|
||||
```markdown
|
||||
\`\`\`javascript
|
||||
const example = "code";
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
#### Lists
|
||||
Use consistent formatting:
|
||||
```markdown
|
||||
- Item 1
|
||||
- Item 2
|
||||
- Sub-item 2.1
|
||||
- Sub-item 2.2
|
||||
```
|
||||
|
||||
#### Emphasis
|
||||
- **Bold** for important terms: `**important**`
|
||||
- *Italic* for emphasis: `*emphasis*`
|
||||
- `Code` for commands/code: `` `code` ``
|
||||
|
||||
#### Links
|
||||
```markdown
|
||||
[Link text](https://example.com)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Quality Checklist
|
||||
|
||||
Before finalizing your skill:
|
||||
|
||||
### Content Quality
|
||||
- [ ] Instructions are clear and actionable
|
||||
- [ ] Examples are realistic and helpful
|
||||
- [ ] No typos or grammar errors
|
||||
- [ ] Technical accuracy verified
|
||||
|
||||
### Structure
|
||||
- [ ] Frontmatter is valid YAML
|
||||
- [ ] Name matches folder name
|
||||
- [ ] Sections are logically organized
|
||||
- [ ] Headings follow hierarchy (H1 → H2 → H3)
|
||||
|
||||
### Completeness
|
||||
- [ ] Overview explains the "why"
|
||||
- [ ] Instructions explain the "how"
|
||||
- [ ] Examples show the "what"
|
||||
- [ ] Edge cases are addressed
|
||||
|
||||
### Usability
|
||||
- [ ] A beginner could follow this
|
||||
- [ ] An expert would find it useful
|
||||
- [ ] The AI can parse it correctly
|
||||
- [ ] It solves a real problem
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Real-World Example Analysis
|
||||
|
||||
Let's analyze a real skill: `brainstorming`
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: brainstorming
|
||||
description: "You MUST use this before any creative work..."
|
||||
---
|
||||
```
|
||||
|
||||
**Analysis:**
|
||||
- ✅ Clear name
|
||||
- ✅ Strong description with urgency ("MUST use")
|
||||
- ✅ Explains when to use it
|
||||
|
||||
```markdown
|
||||
# Brainstorming Ideas Into Designs
|
||||
|
||||
## Overview
|
||||
Help turn ideas into fully formed designs...
|
||||
```
|
||||
|
||||
**Analysis:**
|
||||
- ✅ Clear title
|
||||
- ✅ Concise overview
|
||||
- ✅ Explains the value proposition
|
||||
|
||||
```markdown
|
||||
## The Process
|
||||
|
||||
**Understanding the idea:**
|
||||
- Check out the current project state first
|
||||
- Ask questions one at a time
|
||||
```
|
||||
|
||||
**Analysis:**
|
||||
- ✅ Broken into clear phases
|
||||
- ✅ Specific, actionable steps
|
||||
- ✅ Easy to follow
|
||||
|
||||
---
|
||||
|
||||
## Advanced Patterns
|
||||
|
||||
### Conditional Logic
|
||||
|
||||
```markdown
|
||||
## Instructions
|
||||
|
||||
If the user is working with React:
|
||||
- Use functional components
|
||||
- Prefer hooks over class components
|
||||
|
||||
If the user is working with Vue:
|
||||
- Use Composition API
|
||||
- Follow Vue 3 patterns
|
||||
```
|
||||
|
||||
### Progressive Disclosure
|
||||
|
||||
```markdown
|
||||
## Basic Usage
|
||||
[Simple instructions for common cases]
|
||||
|
||||
## Advanced Usage
|
||||
[Complex patterns for power users]
|
||||
```
|
||||
|
||||
### Cross-References
|
||||
|
||||
```markdown
|
||||
## Related Workflows
|
||||
|
||||
1. First, use `@brainstorming` to design
|
||||
2. Then, use `@writing-plans` to plan
|
||||
3. Finally, use `@test-driven-development` to implement
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Skill Effectiveness Metrics
|
||||
|
||||
How to know if your skill is good:
|
||||
|
||||
### Clarity Test
|
||||
- Can someone unfamiliar with the topic follow it?
|
||||
- Are there any ambiguous instructions?
|
||||
|
||||
### Completeness Test
|
||||
- Does it cover the happy path?
|
||||
- Does it handle edge cases?
|
||||
- Are error scenarios addressed?
|
||||
|
||||
### Usefulness Test
|
||||
- Does it solve a real problem?
|
||||
- Would you use this yourself?
|
||||
- Does it save time or improve quality?
|
||||
|
||||
---
|
||||
|
||||
## Learning from Existing Skills
|
||||
|
||||
### Study These Examples
|
||||
|
||||
**For Beginners:**
|
||||
- `skills/brainstorming/SKILL.md` - Clear structure
|
||||
- `skills/git-pushing/SKILL.md` - Simple and focused
|
||||
- `skills/copywriting/SKILL.md` - Good examples
|
||||
|
||||
**For Advanced:**
|
||||
- `skills/systematic-debugging/SKILL.md` - Comprehensive
|
||||
- `skills/react-best-practices/SKILL.md` - Multiple files
|
||||
- `skills/loki-mode/SKILL.md` - Complex workflows
|
||||
|
||||
---
|
||||
|
||||
## 💡 Pro Tips
|
||||
|
||||
1. **Start with the "When to Use" section** - This clarifies the skill's purpose
|
||||
2. **Write examples first** - They help you understand what you're teaching
|
||||
3. **Test with an AI** - See if it actually works before submitting
|
||||
4. **Get feedback** - Ask others to review your skill
|
||||
5. **Iterate** - Skills improve over time based on usage
|
||||
|
||||
---
|
||||
|
||||
## Common Mistakes to Avoid
|
||||
|
||||
### ❌ Mistake 1: Too Vague
|
||||
```markdown
|
||||
## Instructions
|
||||
Make the code better.
|
||||
```
|
||||
|
||||
**✅ Fix:**
|
||||
```markdown
|
||||
## Instructions
|
||||
1. Extract repeated logic into functions
|
||||
2. Add error handling for edge cases
|
||||
3. Write unit tests for core functionality
|
||||
```
|
||||
|
||||
### ❌ Mistake 2: Too Complex
|
||||
```markdown
|
||||
## Instructions
|
||||
[5000 words of dense technical jargon]
|
||||
```
|
||||
|
||||
**✅ Fix:**
|
||||
Break into multiple skills or use progressive disclosure
|
||||
|
||||
### ❌ Mistake 3: No Examples
|
||||
```markdown
|
||||
## Instructions
|
||||
[Instructions without any code examples]
|
||||
```
|
||||
|
||||
**✅ Fix:**
|
||||
Add at least 2-3 realistic examples
|
||||
|
||||
### ❌ Mistake 4: Outdated Information
|
||||
```markdown
|
||||
Use React class components...
|
||||
```
|
||||
|
||||
**✅ Fix:**
|
||||
Keep skills updated with current best practices
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Next Steps
|
||||
|
||||
1. **Read 3-5 existing skills** to see different styles
|
||||
2. **Try the skill template** from CONTRIBUTING_GUIDE.md
|
||||
3. **Create a simple skill** for something you know well
|
||||
4. **Test it** with your AI assistant
|
||||
5. **Share it** via Pull Request
|
||||
|
||||
---
|
||||
|
||||
**Remember:** Every expert was once a beginner. Start simple, learn from feedback, and improve over time! 🚀
|
||||
This document moved to [`contributors/skill-anatomy.md`](contributors/skill-anatomy.md).
|
||||
|
||||
@@ -1,62 +1,3 @@
|
||||
---
|
||||
name: your-skill-name
|
||||
description: "Brief one-sentence description of what this skill does (under 200 characters)"
|
||||
category: your-category
|
||||
risk: safe
|
||||
source: community
|
||||
date_added: "YYYY-MM-DD"
|
||||
---
|
||||
# Skill Template
|
||||
|
||||
# Skill Title
|
||||
|
||||
## Overview
|
||||
|
||||
A brief explanation of what this skill does and why it exists.
|
||||
2-4 sentences is perfect.
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
- Use when you need to [scenario 1]
|
||||
- Use when working with [scenario 2]
|
||||
- Use when the user asks about [scenario 3]
|
||||
|
||||
## How It Works
|
||||
|
||||
### Step 1: [Action]
|
||||
|
||||
Detailed instructions...
|
||||
|
||||
### Step 2: [Action]
|
||||
|
||||
More instructions...
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1: [Use Case]
|
||||
|
||||
\`\`\`javascript
|
||||
// Example code
|
||||
\`\`\`
|
||||
|
||||
### Example 2: [Another Use Case]
|
||||
|
||||
\`\`\`javascript
|
||||
// More code
|
||||
\`\`\`
|
||||
|
||||
## Best Practices
|
||||
|
||||
- ✅ Do this
|
||||
- ✅ Also do this
|
||||
- ❌ Don't do this
|
||||
- ❌ Avoid this
|
||||
|
||||
## Common Pitfalls
|
||||
|
||||
- **Problem:** Description
|
||||
**Solution:** How to fix it
|
||||
|
||||
## Related Skills
|
||||
|
||||
- `@other-skill` - When to use this instead
|
||||
- `@complementary-skill` - How this works together
|
||||
This document moved to [`contributors/skill-template.md`](contributors/skill-template.md).
|
||||
|
||||
@@ -1,219 +1,3 @@
|
||||
# Smart Auto-Categorization Guide
|
||||
# Smart Auto Categorization
|
||||
|
||||
## Overview
|
||||
|
||||
The skill collection now uses intelligent auto-categorization to eliminate "uncategorized" and organize skills into meaningful categories based on their content.
|
||||
|
||||
## Current Status
|
||||
|
||||
✅ **946 total skills**
|
||||
- 820 skills in meaningful categories (87%)
|
||||
- 126 skills still uncategorized (13%)
|
||||
- 11 primary categories
|
||||
- Categories sorted by skill count (most first)
|
||||
|
||||
## Category Distribution
|
||||
|
||||
| Category | Count | Examples |
|
||||
|----------|-------|----------|
|
||||
| Backend | 164 | Node.js, Django, Express, FastAPI |
|
||||
| Web Development | 107 | React, Vue, Tailwind, CSS |
|
||||
| Automation | 103 | Workflow, Scripting, RPA |
|
||||
| DevOps | 83 | Docker, Kubernetes, CI/CD, Git |
|
||||
| AI/ML | 79 | TensorFlow, PyTorch, NLP, LLM |
|
||||
| Content | 47 | Documentation, SEO, Writing |
|
||||
| Database | 44 | SQL, MongoDB, PostgreSQL |
|
||||
| Testing | 38 | Jest, Cypress, Unit Testing |
|
||||
| Security | 36 | Encryption, Authentication |
|
||||
| Cloud | 33 | AWS, Azure, GCP |
|
||||
| Mobile | 21 | React Native, Flutter, iOS |
|
||||
| Game Dev | 15 | Unity, WebGL, 3D |
|
||||
| Data Science | 14 | Pandas, NumPy, Analytics |
|
||||
|
||||
## How It Works
|
||||
|
||||
### 1. **Keyword-Based Analysis**
|
||||
The system analyzes skill names and descriptions for keywords:
|
||||
- **Backend**: nodejs, express, fastapi, django, server, api, database
|
||||
- **Web Dev**: react, vue, angular, frontend, css, html, tailwind
|
||||
- **AI/ML**: ai, machine learning, tensorflow, nlp, gpt
|
||||
- **DevOps**: docker, kubernetes, ci/cd, deploy
|
||||
- And more...
|
||||
|
||||
### 2. **Priority System**
|
||||
Frontmatter category > Detected Keywords > Fallback (uncategorized)
|
||||
|
||||
If a skill already has a category in frontmatter, that's preserved.
|
||||
|
||||
### 3. **Scope-Based Matching**
|
||||
- Exact phrase matches weighted 2x higher than partial matches
|
||||
- Uses word boundaries to avoid false positives
|
||||
|
||||
## Using the Auto-Categorization
|
||||
|
||||
### Run on Uncategorized Skills
|
||||
```bash
|
||||
python scripts/auto_categorize_skills.py
|
||||
```
|
||||
|
||||
### Preview Changes First (Dry Run)
|
||||
```bash
|
||||
python scripts/auto_categorize_skills.py --dry-run
|
||||
```
|
||||
|
||||
### Output
|
||||
```
|
||||
======================================================================
|
||||
AUTO-CATEGORIZATION REPORT
|
||||
======================================================================
|
||||
|
||||
Summary:
|
||||
✅ Categorized: 776
|
||||
⏭️ Already categorized: 46
|
||||
❌ Failed to categorize: 124
|
||||
📈 Total processed: 946
|
||||
|
||||
Sample changes:
|
||||
• 3d-web-experience
|
||||
uncategorized → web-development
|
||||
• ab-test-setup
|
||||
uncategorized → testing
|
||||
• agent-framework-azure-ai-py
|
||||
uncategorized → backend
|
||||
```
|
||||
|
||||
## Web App Improvements
|
||||
|
||||
### Category Filter
|
||||
**Before:**
|
||||
- Unordered list including "uncategorized"
|
||||
- No indication of category size
|
||||
|
||||
**After:**
|
||||
- Categories sorted by skill count (most first, "uncategorized" last)
|
||||
- Shows count: "Backend (164)" "Web Development (107)"
|
||||
- Much easier to browse
|
||||
|
||||
### Example Dropdowns
|
||||
|
||||
**Sorted Order:**
|
||||
1. All Categories
|
||||
2. Backend (164)
|
||||
3. Web Development (107)
|
||||
4. Automation (103)
|
||||
5. DevOps (83)
|
||||
6. AI/ML (79)
|
||||
7. ... more categories ...
|
||||
8. Uncategorized (126) ← at the end
|
||||
|
||||
## For Skill Creators
|
||||
|
||||
### When Adding a New Skill
|
||||
|
||||
Include category in frontmatter:
|
||||
```yaml
|
||||
---
|
||||
name: my-skill
|
||||
description: "..."
|
||||
category: web-development
|
||||
date_added: "2025-02-26"
|
||||
---
|
||||
```
|
||||
|
||||
### If You're Not Sure
|
||||
|
||||
The system will automatically categorize on next index regeneration:
|
||||
```bash
|
||||
python scripts/generate_index.py
|
||||
```
|
||||
|
||||
## Keyword Reference
|
||||
|
||||
Available auto-categorization keywords by category:
|
||||
|
||||
**Backend**: nodejs, node.js, express, fastapi, django, flask, spring, java, python, golang, rust, server, api, rest, graphql, database, sql, mongodb
|
||||
|
||||
**Web Development**: react, vue, angular, html, css, javascript, typescript, frontend, tailwind, bootstrap, webpack, vite, pwa, responsive, seo
|
||||
|
||||
**Database**: database, sql, postgres, mysql, mongodb, firestore, redis, orm, schema
|
||||
|
||||
**AI/ML**: ai, machine learning, ml, tensorflow, pytorch, nlp, llm, gpt, transformer, embedding, training
|
||||
|
||||
**DevOps**: docker, kubernetes, ci/cd, git, jenkins, terraform, ansible, deploy, container, monitoring
|
||||
|
||||
**Cloud**: aws, azure, gcp, serverless, lambda, storage, cdn
|
||||
|
||||
**Security**: encryption, cryptography, jwt, oauth, authentication, authorization, vulnerability
|
||||
|
||||
**Testing**: test, jest, mocha, pytest, cypress, selenium, unit test, e2e
|
||||
|
||||
**Mobile**: mobile, react native, flutter, ios, android, swift, kotlin
|
||||
|
||||
**Automation**: automation, workflow, scripting, robot, trigger, integration
|
||||
|
||||
**Game Development**: game, unity, unreal, godot, threejs, 2d, 3d, physics
|
||||
|
||||
**Data Science**: data, analytics, pandas, numpy, statistics, visualization
|
||||
|
||||
## Customization
|
||||
|
||||
### Add Custom Keywords
|
||||
|
||||
Edit [scripts/auto_categorize_skills.py](scripts/auto_categorize_skills.py):
|
||||
|
||||
```python
|
||||
CATEGORY_KEYWORDS = {
|
||||
'your-category': [
|
||||
'keyword1', 'keyword2', 'exact phrase', 'another-keyword'
|
||||
],
|
||||
# ... other categories
|
||||
}
|
||||
```
|
||||
|
||||
Then re-run:
|
||||
```bash
|
||||
python scripts/auto_categorize_skills.py
|
||||
python scripts/generate_index.py
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Failed to categorize" Skills
|
||||
|
||||
Some skills may be too generic or unique. You can:
|
||||
|
||||
1. **Manually set category** in the skill's frontmatter:
|
||||
```yaml
|
||||
category: your-chosen-category
|
||||
```
|
||||
|
||||
2. **Add keywords** to CATEGORY_KEYWORDS config
|
||||
|
||||
3. **Move to folder** if it fits a broader category:
|
||||
```
|
||||
skills/backend/my-new-skill/SKILL.md
|
||||
```
|
||||
|
||||
### Regenerating Index
|
||||
|
||||
After making changes to SKILL.md files:
|
||||
```bash
|
||||
python scripts/generate_index.py
|
||||
```
|
||||
|
||||
This will:
|
||||
- Parse frontmatter categories
|
||||
- Fallback to folder structure
|
||||
- Generate new skills_index.json
|
||||
- Copy to web-app/public/skills.json
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Test in web app**: Try the improved category filter
|
||||
2. **Add missing keywords**: If certain skills are still uncategorized
|
||||
3. **Organize remaining 126**: Either auto-assign or manually review
|
||||
4. **Monitor growth**: Use reports to track new vs categorized skills
|
||||
|
||||
---
|
||||
|
||||
**Result**: Much cleaner category filter with smart, meaningful organization! 🎉
|
||||
This document moved to [`maintainers/smart-auto-categorization.md`](maintainers/smart-auto-categorization.md).
|
||||
|
||||
146
docs/SOURCES.md
146
docs/SOURCES.md
@@ -1,145 +1,3 @@
|
||||
# 📜 Sources & Attributions
|
||||
# Sources
|
||||
|
||||
We believe in giving credit where credit is due.
|
||||
If you recognize your work here and it is not properly attributed, please open an Issue.
|
||||
|
||||
| Skill / Category | Original Source | License | Notes |
|
||||
| :-------------------------- | :------------------------------------------------------------------------- | :------------- | :---------------------------- |
|
||||
| `cloud-penetration-testing` | [HackTricks](https://book.hacktricks.xyz/) | MIT / CC-BY-SA | Adapted for agentic use. |
|
||||
| `active-directory-attacks` | [HackTricks](https://book.hacktricks.xyz/) | MIT / CC-BY-SA | Adapted for agentic use. |
|
||||
| `owasp-top-10` | [OWASP](https://owasp.org/) | CC-BY-SA | Methodology adapted. |
|
||||
| `burp-suite-testing` | [PortSwigger](https://portswigger.net/burp) | N/A | Usage guide only (no binary). |
|
||||
| `crewai` | [CrewAI](https://github.com/joaomdmoura/crewAI) | MIT | Framework guides. |
|
||||
| `langgraph` | [LangGraph](https://github.com/langchain-ai/langgraph) | MIT | Framework guides. |
|
||||
| `react-patterns` | [React Docs](https://react.dev/) | CC-BY | Official patterns. |
|
||||
| **All Official Skills** | [Anthropic / Google / OpenAI / Microsoft / Supabase / Apify / Vercel Labs] | Proprietary | Usage encouraged by vendors. |
|
||||
|
||||
## Skills from VoltAgent/awesome-agent-skills
|
||||
|
||||
The following skills were added from the curated collection at [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills):
|
||||
|
||||
### Official Team Skills
|
||||
|
||||
| Skill | Original Source | License | Notes |
|
||||
| :------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------ | :--------- | :--------------------------------- |
|
||||
| `vercel-deploy-claimable` | [Vercel Labs](https://github.com/vercel-labs/agent-skills) | MIT | Official Vercel skill |
|
||||
| `design-md` | [Google Labs (Stitch)](https://github.com/google-labs-code/stitch-skills) | Compatible | Google Labs Stitch skills |
|
||||
| `hugging-face-cli`, `hugging-face-jobs` | [Hugging Face](https://github.com/huggingface/skills) | Compatible | Official Hugging Face skills |
|
||||
| `culture-index`, `fix-review`, `sharp-edges` | [Trail of Bits](https://github.com/trailofbits/skills) | Compatible | Security skills from Trail of Bits |
|
||||
| `expo-deployment`, `upgrading-expo` | [Expo](https://github.com/expo/skills) | Compatible | Official Expo skills |
|
||||
| `commit`, `create-pr`, `find-bugs`, `iterate-pr` | [Sentry](https://github.com/getsentry/skills) | Compatible | Sentry dev team skills |
|
||||
| `using-neon` | [Neon](https://github.com/neondatabase/agent-skills) | Compatible | Neon Postgres best practices |
|
||||
| `fal-audio`, `fal-generate`, `fal-image-edit`, `fal-platform`, `fal-upscale`, `fal-workflow` | [fal.ai Community](https://github.com/fal-ai-community/skills) | Compatible | fal.ai AI model skills |
|
||||
|
||||
### Community Skills
|
||||
|
||||
| Skill | Original Source | License | Notes |
|
||||
| :------------------------------------------------------------------ | :-------------------------------------------------------------------------- | :--------- | :----------------------------- |
|
||||
| `automate-whatsapp`, `observe-whatsapp` | [gokapso](https://github.com/gokapso/agent-skills) | Compatible | WhatsApp automation skills |
|
||||
| `readme` | [Shpigford](https://github.com/Shpigford/skills) | Compatible | README generation |
|
||||
| `screenshots` | [Shpigford](https://github.com/Shpigford/skills) | Compatible | Marketing screenshots |
|
||||
| `aws-skills` | [zxkane](https://github.com/zxkane/aws-skills) | Compatible | AWS development patterns |
|
||||
| `deep-research` | [sanjay3290](https://github.com/sanjay3290/ai-skills) | Compatible | Gemini Deep Research Agent |
|
||||
| `ffuf-claude-skill` | [jthack](https://github.com/jthack/ffuf_claude_skill) | Compatible | Web fuzzing with ffuf |
|
||||
| `ui-skills` | [ibelick](https://github.com/ibelick/ui-skills) | Compatible | UI development constraints |
|
||||
| `vexor` | [scarletkc](https://github.com/scarletkc/vexor) | Compatible | Vector-powered CLI |
|
||||
| `pypict-skill` | [omkamal](https://github.com/omkamal/pypict-claude-skill) | Compatible | Pairwise test generation |
|
||||
| `makepad-skills` | [ZhangHanDong](https://github.com/ZhangHanDong/makepad-skills) | Compatible | Makepad UI development |
|
||||
| `swiftui-expert-skill` | [AvdLee](https://github.com/AvdLee/SwiftUI-Agent-Skill) | Compatible | SwiftUI best practices |
|
||||
| `threejs-skills` | [CloudAI-X](https://github.com/CloudAI-X/threejs-skills) | Compatible | Three.js 3D experiences |
|
||||
| `claude-scientific-skills` | [K-Dense-AI](https://github.com/K-Dense-AI/claude-scientific-skills) | Compatible | Scientific research skills |
|
||||
| `claude-win11-speckit-update-skill` | [NotMyself](https://github.com/NotMyself/claude-win11-speckit-update-skill) | Compatible | Windows 11 management |
|
||||
| `imagen` | [sanjay3290](https://github.com/sanjay3290/ai-skills) | Compatible | Google Gemini image generation |
|
||||
| `security-bluebook-builder` | [SHADOWPR0](https://github.com/SHADOWPR0/security-bluebook-builder) | Compatible | Security documentation |
|
||||
| `claude-ally-health` | [huifer](https://github.com/huifer/Claude-Ally-Health) | Compatible | Health assistant |
|
||||
| `clarity-gate` | [frmoretto](https://github.com/frmoretto/clarity-gate) | Compatible | RAG quality verification |
|
||||
| `n8n-code-python`, `n8n-mcp-tools-expert`, `n8n-node-configuration` | [czlonkowski](https://github.com/czlonkowski/n8n-skills) | Compatible | n8n automation skills |
|
||||
| `varlock-claude-skill` | [wrsmith108](https://github.com/wrsmith108/varlock-claude-skill) | Compatible | Secure environment variables |
|
||||
| `beautiful-prose` | [SHADOWPR0](https://github.com/SHADOWPR0/beautiful_prose) | Compatible | Writing style guide |
|
||||
| `claude-speed-reader` | [SeanZoR](https://github.com/SeanZoR/claude-speed-reader) | Compatible | Speed reading tool |
|
||||
| `skill-seekers` | [yusufkaraaslan](https://github.com/yusufkaraaslan/Skill_Seekers) | Compatible | Skill conversion tool |
|
||||
|
||||
- **frontend-slides** - [zarazhangrui](https://github.com/zarazhangrui/frontend-slides)
|
||||
- **linear-claude-skill** - [wrsmith108](https://github.com/wrsmith108/linear-claude-skill)
|
||||
- **skill-rails-upgrade** - [robzolkos](https://github.com/robzolkos/skill-rails-upgrade)
|
||||
- **context-fundamentals** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **context-degradation** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **context-compression** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **context-optimization** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **multi-agent-patterns** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **tool-design** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **evaluation** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **memory-systems** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **terraform-skill** - [antonbabenko](https://github.com/antonbabenko/terraform-skill)
|
||||
|
||||
## Skills from whatiskadudoing/fp-ts-skills (v4.4.0)
|
||||
|
||||
| Skill | Original Source | License | Notes |
|
||||
| :---------------- | :------------------------------------------------------------------------------ | :--------- | :------------------------------------------------------- |
|
||||
| `fp-ts-pragmatic` | [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Compatible | Pragmatic fp-ts guide – pipe, Option, Either, TaskEither |
|
||||
| `fp-ts-react` | [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Compatible | fp-ts with React 18/19 and Next.js |
|
||||
| `fp-ts-errors` | [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Compatible | Type-safe error handling with Either and TaskEither |
|
||||
|
||||
---
|
||||
|
||||
## Recently Added Skills (March 2026)
|
||||
|
||||
The following skills were added during the March 2026 skills update:
|
||||
|
||||
### UI/UX & Frontend
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `baseline-ui`, `fixing-accessibility`, `fixing-metadata`, `fixing-motion-performance` | [ibelick/ui-skills](https://github.com/ibelick/ui-skills) | Compatible | UI polish and validation |
|
||||
| `expo-ui-swift-ui`, `expo-ui-jetpack-compose`, `expo-tailwind-setup`, `building-native-ui`, `expo-api-routes`, `expo-dev-client`, `expo-cicd-workflows`, `native-data-fetching` | [expo/skills](https://github.com/expo/skills) | MIT | Expo/React Native skills |
|
||||
| `swiftui-expert-skill` | [AvdLee/SwiftUI-Agent-Skill](https://github.com/AvdLee/SwiftUI-Agent-Skill) | Compatible | SwiftUI development |
|
||||
| `threejs-fundamentals`, `threejs-geometry`, `threejs-materials`, `threejs-lighting`, `threejs-textures`, `threejs-animation`, `threejs-loaders`, `threejs-shaders`, `threejs-postprocessing`, `threejs-interaction` | [CloudAI-X/threejs-skills](https://github.com/CloudAI-X/threejs-skills) | Compatible | Three.js 3D graphics |
|
||||
| `frontend-slides` | [zarazhangrui](https://github.com/zarazhangrui/frontend-slides) | Compatible | HTML presentations |
|
||||
|
||||
### Automation & Integration
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `gmail-automation`, `google-calendar-automation`, `google-docs-automation`, `google-sheets-automation`, `google-drive-automation`, `google-slides-automation` | [sanjay3290/ai-skills](https://github.com/sanjay3290/ai-skills) | Compatible | Google Workspace integration |
|
||||
| `n8n-expression-syntax`, `n8n-mcp-tools-expert`, `n8n-workflow-patterns`, `n8n-validation-expert`, `n8n-node-configuration`, `n8n-code-javascript`, `n8n-code-python` | [czlonkowski/n8n-skills](https://github.com/czlonkowski/n8n-skills) | Compatible | n8n workflow automation |
|
||||
| `automate-whatsapp` | [gokapso/agent-skills](https://github.com/gokapso/agent-skills) | Compatible | WhatsApp automation |
|
||||
| `linear` | [wrsmith108/linear-claude-skill](https://github.com/wrsmith108/linear-claude-skill) | Compatible | Linear project management |
|
||||
| `rails-upgrade` | [robzolkos](https://github.com/robzolkos/skill-rails-upgrade) | Compatible | Rails upgrade assistant |
|
||||
| `vexor-cli` | [scarletkc/vexor](https://github.com/scarletkc/vexor) | Compatible | Semantic file discovery |
|
||||
|
||||
### Machine Learning & Data
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `hugging-face-dataset-viewer`, `hugging-face-datasets`, `hugging-face-evaluation`, `hugging-face-model-trainer`, `hugging-face-paper-publisher`, `hugging-face-tool-builder` | [huggingface/skills](https://github.com/huggingface/skills) | Compatible | HuggingFace ML tools |
|
||||
| `numpy`, `pandas`, `scipy`, `matplotlib`, `scikit-learn`, `jupyter-workflow` | [K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) | Compatible | Data science essentials |
|
||||
| `biopython`, `scanpy`, `uniprot-database`, `pubmed-database` | [K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) | Compatible | Bioinformatics tools |
|
||||
|
||||
### Security & Auditing
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `semgrep-rule-creator`, `semgrep-rule-variant-creator`, `static-analysis`, `variant-analysis` | [trailofbits/skills](https://github.com/trailofbits/skills) | Compatible | Code security analysis |
|
||||
| `golang-security-auditor`, `python-security-auditor`, `rust-security-auditor` | [trailofbits/skills](https://github.com/trailofbits/skills) | Compatible | Language-specific security |
|
||||
| `burpsuite-project-parser`, `agentic-actions-auditor`, `audit-context-building`, `proof-of-vulnerability`, `yara-authoring` | [trailofbits/skills](https://github.com/trailofbits/skills) | Compatible | Security testing tools |
|
||||
|
||||
### Context Engineering & AI
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `context-fundamentals`, `context-degradation`, `context-compression`, `context-optimization`, `multi-agent-patterns`, `filesystem-context` | [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) | Compatible | Context engineering patterns |
|
||||
|
||||
### Health & Wellness
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `sleep-analyzer`, `nutrition-analyzer`, `fitness-analyzer` | [huifer/Claude-Ally-Health](https://github.com/huifer/Claude-Ally-Health) | Compatible | Health tracking |
|
||||
|
||||
### Quality & Verification
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `clarity-gate` | [frmoretto/clarity-gate](https://github.com/frmoretto/clarity-gate) | Compatible | RAG quality verification |
|
||||
|
||||
**Total: 80+ new skills added**
|
||||
|
||||
---
|
||||
|
||||
## License Policy
|
||||
|
||||
- **Code**: All original code in this repository is **MIT**.
|
||||
- **Content**: Documentation is **CC-BY-4.0**.
|
||||
- **Third Party**: We respect the upstream licenses. If an imported skill is GPL, it will be marked clearly or excluded (we aim for MIT/Apache compatibility).
|
||||
This document moved to [`sources/sources.md`](sources/sources.md).
|
||||
|
||||
395
docs/USAGE.md
395
docs/USAGE.md
@@ -1,394 +1,3 @@
|
||||
# 📖 Usage Guide: How to Actually Use These Skills
|
||||
# Usage Guide
|
||||
|
||||
> **Confused after installation?** This guide walks you through exactly what to do next, step by step.
|
||||
|
||||
---
|
||||
|
||||
## 🤔 "I just installed the repository. Now what?"
|
||||
|
||||
Great question! Here's what just happened and what to do next:
|
||||
|
||||
### What You Just Did
|
||||
|
||||
When you ran `npx antigravity-awesome-skills` or cloned the repository, you:
|
||||
|
||||
✅ **Downloaded 978+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or `~/.agent/skills/` if you used `--path`)
|
||||
✅ **Made them available** to your AI assistant
|
||||
❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
|
||||
|
||||
Think of it like installing a toolbox. You have all the tools now, but you need to **pick which ones to use** for each job.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Step 1: Understanding "Bundles" (This is NOT Another Install!)
|
||||
|
||||
**Common confusion:** "Do I need to download each skill separately?"
|
||||
|
||||
**Answer: NO!** Here's what bundles actually are:
|
||||
|
||||
### What Bundles Are
|
||||
|
||||
Bundles are **recommended lists** of skills grouped by role. They help you decide which skills to start using.
|
||||
|
||||
**Analogy:**
|
||||
|
||||
- You installed a toolbox with 978+ tools (✅ done)
|
||||
- Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools"
|
||||
- You don't install bundles—you **pick skills from them**
|
||||
|
||||
### What Bundles Are NOT
|
||||
|
||||
❌ Separate installations
|
||||
❌ Different download commands
|
||||
❌ Something you need to "activate"
|
||||
|
||||
### Example: The "Web Wizard" Bundle
|
||||
|
||||
When you see the [Web Wizard bundle](BUNDLES.md#-the-web-wizard-pack), it lists:
|
||||
|
||||
- `frontend-design`
|
||||
- `react-best-practices`
|
||||
- `tailwind-patterns`
|
||||
- etc.
|
||||
|
||||
These are **recommendations** for which skills a web developer should try first. They're already installed—you just need to **use them in your prompts**.
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Step 2: How to Actually Execute/Use a Skill
|
||||
|
||||
This is the part that should have been explained better! Here's how to use skills:
|
||||
|
||||
### The Simple Answer
|
||||
|
||||
**Just mention the skill name in your conversation with your AI assistant.**
|
||||
|
||||
### Different Tools, Different Syntax
|
||||
|
||||
The exact syntax varies by tool, but it's always simple:
|
||||
|
||||
#### Claude Code (CLI)
|
||||
|
||||
```bash
|
||||
# In your terminal/chat with Claude Code:
|
||||
>> Use @brainstorming to help me design a todo app
|
||||
```
|
||||
|
||||
#### Cursor (IDE)
|
||||
|
||||
```bash
|
||||
# In the Cursor chat panel:
|
||||
@brainstorming help me design a todo app
|
||||
```
|
||||
|
||||
#### Gemini CLI
|
||||
|
||||
```bash
|
||||
# In your conversation with Gemini:
|
||||
Use the brainstorming skill to help me plan my app
|
||||
```
|
||||
|
||||
#### Codex CLI
|
||||
|
||||
```bash
|
||||
# In your conversation with Codex:
|
||||
Apply @brainstorming to design a new feature
|
||||
```
|
||||
|
||||
#### Antigravity IDE
|
||||
|
||||
```bash
|
||||
# In agent mode:
|
||||
Use @brainstorming to plan this feature
|
||||
```
|
||||
|
||||
> **Pro Tip:** Most modern tools use the `@skill-name` syntax. When in doubt, try that first!
|
||||
|
||||
---
|
||||
|
||||
## 💬 Step 3: What Should My Prompts Look Like?
|
||||
|
||||
Here are **real-world examples** of good prompts:
|
||||
|
||||
### Example 1: Starting a New Project
|
||||
|
||||
**Bad Prompt:**
|
||||
|
||||
> "Help me build a todo app"
|
||||
|
||||
**Good Prompt:**
|
||||
|
||||
> "Use @brainstorming to help me design a todo app with user authentication and cloud sync"
|
||||
|
||||
**Why it's better:** You're explicitly invoking the skill and providing context.
|
||||
|
||||
---
|
||||
|
||||
### Example 2: Reviewing Code
|
||||
|
||||
**Bad Prompt:**
|
||||
|
||||
> "Check my code"
|
||||
|
||||
**Good Prompt:**
|
||||
|
||||
> "Use @lint-and-validate to check `src/components/Button.tsx` for issues"
|
||||
|
||||
**Why it's better:** Specific skill + specific file = precise results.
|
||||
|
||||
---
|
||||
|
||||
### Example 3: Security Audit
|
||||
|
||||
**Bad Prompt:**
|
||||
|
||||
> "Make my API secure"
|
||||
|
||||
**Good Prompt:**
|
||||
|
||||
> "Use @api-security-best-practices to review my REST endpoints in `routes/api/users.js`"
|
||||
|
||||
**Why it's better:** The AI knows exactly which skill's standards to apply.
|
||||
|
||||
---
|
||||
|
||||
### Example 4: Combining Multiple Skills
|
||||
|
||||
**Good Prompt:**
|
||||
|
||||
> "Use @brainstorming to design a payment flow, then apply @stripe-integration to implement it"
|
||||
|
||||
**Why it's good:** You can chain skills together in a single prompt!
|
||||
|
||||
---
|
||||
|
||||
## 🎓 Step 4: Your First Skill (Hands-On Tutorial)
|
||||
|
||||
Let's actually use a skill right now. Follow these steps:
|
||||
|
||||
### Scenario: You want to plan a new feature
|
||||
|
||||
1. **Pick a skill:** Let's use `brainstorming` (from the "Essentials" bundle)
|
||||
|
||||
2. **Open your AI assistant** (Claude Code, Cursor, etc.)
|
||||
|
||||
3. **Type this exact prompt:**
|
||||
|
||||
```
|
||||
Use @brainstorming to help me design a user profile page for my app
|
||||
```
|
||||
|
||||
4. **Press Enter**
|
||||
|
||||
5. **What happens next:**
|
||||
- The AI loads the brainstorming skill
|
||||
- It will start asking you structured questions (one at a time)
|
||||
- It will guide you through understanding, requirements, and design
|
||||
- You answer each question, and it builds a complete spec
|
||||
|
||||
6. **Result:** You'll end up with a detailed design document—without writing a single line of code yet!
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ Step 5: Picking Your First Skills (Practical Advice)
|
||||
|
||||
Don't try to use all 954+ skills! Here's a sensible approach:
|
||||
|
||||
### Start with "The Essentials" (5 skills, everyone needs these)
|
||||
|
||||
1. **`@brainstorming`** - Plan before you build
|
||||
2. **`@lint-and-validate`** - Keep code clean
|
||||
3. **`@git-pushing`** - Save work safely
|
||||
4. **`@systematic-debugging`** - Fix bugs faster
|
||||
5. **`@concise-planning`** - Organize tasks
|
||||
|
||||
**How to use them:**
|
||||
|
||||
- Before writing new code → `@brainstorming`
|
||||
- After writing code → `@lint-and-validate`
|
||||
- Before committing → `@git-pushing`
|
||||
- When stuck → `@systematic-debugging`
|
||||
|
||||
### Then Add Role-Specific Skills (5-10 more)
|
||||
|
||||
Find your role in [BUNDLES.md](BUNDLES.md) and pick 5-10 skills from that bundle.
|
||||
|
||||
**Example for Web Developer:**
|
||||
|
||||
- `@frontend-design`
|
||||
- `@react-best-practices`
|
||||
- `@tailwind-patterns`
|
||||
- `@seo-audit`
|
||||
|
||||
**Example for Security Engineer:**
|
||||
|
||||
- `@api-security-best-practices`
|
||||
- `@vulnerability-scanner`
|
||||
- `@ethical-hacking-methodology`
|
||||
|
||||
### Finally, Add On-Demand Skills (as needed)
|
||||
|
||||
Keep the [CATALOG.md](../CATALOG.md) open as reference. When you need something specific:
|
||||
|
||||
> "I need to integrate Stripe payments"
|
||||
> → Search catalog → Find `@stripe-integration` → Use it!
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Complete Example: Building a Feature End-to-End
|
||||
|
||||
Let's walk through a realistic scenario:
|
||||
|
||||
### Task: "Add a blog to my Next.js website"
|
||||
|
||||
#### Step 1: Plan (use @brainstorming)
|
||||
|
||||
```
|
||||
You: Use @brainstorming to design a blog system for my Next.js site
|
||||
|
||||
AI: [Asks structured questions about requirements]
|
||||
You: [Answer questions]
|
||||
AI: [Produces detailed design spec]
|
||||
```
|
||||
|
||||
#### Step 2: Implement (use @nextjs-best-practices)
|
||||
|
||||
```
|
||||
You: Use @nextjs-best-practices to scaffold the blog with App Router
|
||||
|
||||
AI: [Creates file structure, sets up routes, adds components]
|
||||
```
|
||||
|
||||
#### Step 3: Style (use @tailwind-patterns)
|
||||
|
||||
```
|
||||
You: Use @tailwind-patterns to make the blog posts look modern
|
||||
|
||||
AI: [Applies Tailwind styling with responsive design]
|
||||
```
|
||||
|
||||
#### Step 4: SEO (use @seo-audit)
|
||||
|
||||
```
|
||||
You: Use @seo-audit to optimize the blog for search engines
|
||||
|
||||
AI: [Adds meta tags, sitemaps, structured data]
|
||||
```
|
||||
|
||||
#### Step 5: Test & Deploy
|
||||
|
||||
```
|
||||
You: Use @test-driven-development to add tests, then @vercel-deployment to deploy
|
||||
|
||||
AI: [Creates tests, sets up CI/CD, deploys to Vercel]
|
||||
```
|
||||
|
||||
**Result:** Professional blog built with best practices, without manually researching each step!
|
||||
|
||||
---
|
||||
|
||||
## 🆘 Common Questions
|
||||
|
||||
### "Which tool should I use? Claude Code, Cursor, Gemini?"
|
||||
|
||||
**Any of them!** Skills work universally. Pick the tool you already use or prefer:
|
||||
|
||||
- **Claude Code** - Best for terminal/CLI workflows
|
||||
- **Cursor** - Best for IDE integration
|
||||
- **Gemini CLI** - Best for Google ecosystem
|
||||
- **Codex CLI** - Best for OpenAI ecosystem
|
||||
|
||||
### "Can I see all available skills?"
|
||||
|
||||
Yes! Three ways:
|
||||
|
||||
1. Browse [CATALOG.md](../CATALOG.md) (searchable list)
|
||||
2. Run `ls ~/.agent/skills/` (if installed there)
|
||||
3. Ask your AI: "What skills do you have for [topic]?"
|
||||
|
||||
### "Do I need to restart my IDE after installing?"
|
||||
|
||||
Usually no, but if your AI doesn't recognize a skill:
|
||||
|
||||
1. Try restarting your IDE/CLI
|
||||
2. Check the installation path matches your tool
|
||||
3. Try the explicit path: `npx antigravity-awesome-skills --claude` (or `--cursor`, `--gemini`, etc.)
|
||||
|
||||
### "Can I create my own skills?"
|
||||
|
||||
Yes! Use the `@skill-creator` skill:
|
||||
|
||||
```
|
||||
Use @skill-creator to help me build a custom skill for [your task]
|
||||
```
|
||||
|
||||
### "What if a skill doesn't work as expected?"
|
||||
|
||||
1. Check the skill's SKILL.md file directly: `~/.agent/skills/[skill-name]/SKILL.md`
|
||||
2. Read the description to ensure you're using it correctly
|
||||
3. [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues) with details
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Quick Reference Card
|
||||
|
||||
**Save this for quick lookup:**
|
||||
|
||||
| Task | Skill to Use | Example Prompt |
|
||||
| ---------------- | ------------------------------ | --------------------------------------------------- |
|
||||
| Plan new feature | `@brainstorming` | `Use @brainstorming to design a login system` |
|
||||
| Review code | `@lint-and-validate` | `Use @lint-and-validate on src/app.js` |
|
||||
| Debug issue | `@systematic-debugging` | `Use @systematic-debugging to fix login error` |
|
||||
| Security audit | `@api-security-best-practices` | `Use @api-security-best-practices on my API routes` |
|
||||
| SEO check | `@seo-audit` | `Use @seo-audit on my landing page` |
|
||||
| React component | `@react-patterns` | `Use @react-patterns to build a form component` |
|
||||
| Deploy app | `@vercel-deployment` | `Use @vercel-deployment to ship this to production` |
|
||||
|
||||
---
|
||||
|
||||
## 🚦 Next Steps
|
||||
|
||||
Now that you understand how to use skills:
|
||||
|
||||
1. ✅ **Try one skill right now** - Start with `@brainstorming` on any idea you have
|
||||
2. 📚 **Pick 3-5 skills** from your role's bundle in [BUNDLES.md](BUNDLES.md)
|
||||
3. 🔖 **Bookmark** [CATALOG.md](../CATALOG.md) for when you need something specific
|
||||
4. 🎯 **Try a workflow** from [WORKFLOWS.md](WORKFLOWS.md) for a complete end-to-end process
|
||||
|
||||
---
|
||||
|
||||
## 💡 Pro Tips for Maximum Effectiveness
|
||||
|
||||
### Tip 1: Start Every Feature with @brainstorming
|
||||
|
||||
> Before writing code, use `@brainstorming` to plan. You'll save hours of refactoring.
|
||||
|
||||
### Tip 2: Chain Skills in Order
|
||||
|
||||
> Don't try to do everything at once. Use skills sequentially: Plan → Build → Test → Deploy
|
||||
|
||||
### Tip 3: Be Specific in Prompts
|
||||
|
||||
> Bad: "Use @react-patterns"
|
||||
> Good: "Use @react-patterns to build a modal component with animations"
|
||||
|
||||
### Tip 4: Reference File Paths
|
||||
|
||||
> Help the AI focus: "Use @security-auditor on routes/api/auth.js"
|
||||
|
||||
### Tip 5: Combine Skills for Complex Tasks
|
||||
|
||||
> "Use @brainstorming to design, then @test-driven-development to implement with tests"
|
||||
|
||||
---
|
||||
|
||||
## 📞 Still Confused?
|
||||
|
||||
If something still doesn't make sense:
|
||||
|
||||
1. Check the [FAQ](FAQ.md)
|
||||
2. See [Real-World Examples](EXAMPLES.md)
|
||||
3. [Open a Discussion](https://github.com/sickn33/antigravity-awesome-skills/discussions)
|
||||
4. [File an Issue](https://github.com/sickn33/antigravity-awesome-skills/issues) to help us improve this guide!
|
||||
|
||||
Remember: You're not alone! The whole point of this project is to make AI assistants easier to use. If this guide didn't help, let us know so we can fix it. 🙌
|
||||
This document moved to [`users/usage.md`](users/usage.md).
|
||||
|
||||
@@ -1,504 +1,3 @@
|
||||
# Visual Quick Start Guide
|
||||
# Visual Guide
|
||||
|
||||
**Learn by seeing!** This guide uses diagrams and visual examples to help you understand skills.
|
||||
|
||||
---
|
||||
|
||||
## The Big Picture
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ YOU (Developer) │
|
||||
│ ↓ │
|
||||
│ "Help me build a payment system" │
|
||||
│ ↓ │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ AI ASSISTANT │
|
||||
│ ↓ │
|
||||
│ Loads @stripe-integration skill │
|
||||
│ ↓ │
|
||||
│ Becomes an expert in Stripe payments │
|
||||
│ ↓ │
|
||||
│ Provides specialized help with code examples │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📦 Repository Structure (Visual)
|
||||
|
||||
```
|
||||
antigravity-awesome-skills/
|
||||
│
|
||||
├── 📄 README.md ← Overview & skill list
|
||||
├── 📄 GETTING_STARTED.md ← Start here! (NEW)
|
||||
├── 📄 CONTRIBUTING_GUIDE.md ← How to contribute (NEW)
|
||||
│
|
||||
├── 📁 skills/ ← All 179 skills live here
|
||||
│ │
|
||||
│ ├── 📁 brainstorming/
|
||||
│ │ └── 📄 SKILL.md ← Skill definition
|
||||
│ │
|
||||
│ ├── 📁 stripe-integration/
|
||||
│ │ ├── 📄 SKILL.md
|
||||
│ │ └── 📁 examples/ ← Optional extras
|
||||
│ │
|
||||
│ ├── 📁 react-best-practices/
|
||||
│ │ ├── 📄 SKILL.md
|
||||
│ │ ├── 📁 rules/
|
||||
│ │ └── 📄 README.md
|
||||
│ │
|
||||
│ └── ... (176 more skills)
|
||||
│
|
||||
├── 📁 scripts/ ← Validation & management
|
||||
│ ├── validate_skills.py
|
||||
│ └── generate_index.py
|
||||
│
|
||||
└── 📁 docs/ ← Documentation (NEW)
|
||||
├── 📄 SKILL_ANATOMY.md ← How skills work
|
||||
└── 📄 QUICK_START_VISUAL.md ← This file!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## How Skills Work (Flow Diagram)
|
||||
|
||||
```
|
||||
┌──────────────┐
|
||||
│ 1. INSTALL │ Copy skills to .agent/skills/
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 2. INVOKE │ Type: @skill-name in AI chat
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 3. LOAD │ AI reads SKILL.md file
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 4. EXECUTE │ AI follows skill instructions
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 5. RESULT │ You get specialized help!
|
||||
└──────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Skill Categories (Visual Map)
|
||||
|
||||
```
|
||||
┌─────────────────────────┐
|
||||
│ 179 AWESOME SKILLS │
|
||||
└────────────┬────────────┘
|
||||
│
|
||||
┌────────────────────────┼────────────────────────┐
|
||||
│ │ │
|
||||
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
|
||||
│ CREATIVE│ │ DEVELOPMENT │ │ SECURITY │
|
||||
│ (10) │ │ (25) │ │ (50) │
|
||||
└────┬────┘ └──────┬──────┘ └──────┬──────┘
|
||||
│ │ │
|
||||
• UI/UX Design • TDD • Ethical Hacking
|
||||
• Canvas Art • Debugging • Metasploit
|
||||
• Themes • React Patterns • Burp Suite
|
||||
• SQLMap
|
||||
│ │ │
|
||||
└────────────────────────┼────────────────────────┘
|
||||
│
|
||||
┌────────────────────────┼────────────────────────┐
|
||||
│ │ │
|
||||
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
|
||||
│ AI │ │ DOCUMENTS │ │ MARKETING │
|
||||
│ (30) │ │ (4) │ │ (23) │
|
||||
└────┬────┘ └──────┬──────┘ └──────┬──────┘
|
||||
│ │ │
|
||||
• RAG Systems • DOCX • SEO
|
||||
• LangGraph • PDF • Copywriting
|
||||
• Prompt Eng. • PPTX • CRO
|
||||
• Voice Agents • XLSX • Paid Ads
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Skill File Anatomy (Visual)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ SKILL.md │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌───────────────────────────────────────────────┐ │
|
||||
│ │ FRONTMATTER (Metadata) │ │
|
||||
│ │ ───────────────────────────────────────────── │ │
|
||||
│ │ --- │ │
|
||||
│ │ name: my-skill │ │
|
||||
│ │ description: "What this skill does" │ │
|
||||
│ │ --- │ │
|
||||
│ └───────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ ┌───────────────────────────────────────────────┐ │
|
||||
│ │ CONTENT (Instructions) │ │
|
||||
│ │ ───────────────────────────────────────────── │ │
|
||||
│ │ │ │
|
||||
│ │ # Skill Title │ │
|
||||
│ │ │ │
|
||||
│ │ ## Overview │ │
|
||||
│ │ What this skill does... │ │
|
||||
│ │ │ │
|
||||
│ │ ## When to Use │ │
|
||||
│ │ - Use when... │ │
|
||||
│ │ │ │
|
||||
│ │ ## Instructions │ │
|
||||
│ │ 1. First step... │ │
|
||||
│ │ 2. Second step... │ │
|
||||
│ │ │ │
|
||||
│ │ ## Examples │ │
|
||||
│ │ ```javascript │ │
|
||||
│ │ // Example code │ │
|
||||
│ │ ``` │ │
|
||||
│ │ │ │
|
||||
│ └───────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Installation (Visual Steps)
|
||||
|
||||
### Step 1: Clone the Repository
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Terminal │
|
||||
├─────────────────────────────────────────┤
|
||||
│ $ git clone https://github.com/ │
|
||||
│ sickn33/antigravity-awesome-skills │
|
||||
│ .agent/skills │
|
||||
│ │
|
||||
│ ✓ Cloning into '.agent/skills'... │
|
||||
│ ✓ Done! │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Step 2: Verify Installation
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ File Explorer │
|
||||
├─────────────────────────────────────────┤
|
||||
│ 📁 .agent/ │
|
||||
│ └── 📁 skills/ │
|
||||
│ ├── 📁 brainstorming/ │
|
||||
│ ├── 📁 stripe-integration/ │
|
||||
│ ├── 📁 react-best-practices/ │
|
||||
│ └── ... (176 more) │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Step 3: Use a Skill
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ AI Assistant Chat │
|
||||
├─────────────────────────────────────────┤
|
||||
│ You: @brainstorming help me design │
|
||||
│ a todo app │
|
||||
│ │
|
||||
│ AI: Great! Let me help you think │
|
||||
│ through this. First, let's │
|
||||
│ understand your requirements... │
|
||||
│ │
|
||||
│ What's the primary use case? │
|
||||
│ a) Personal task management │
|
||||
│ b) Team collaboration │
|
||||
│ c) Project planning │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Example: Using a Skill (Step-by-Step)
|
||||
|
||||
### Scenario: You want to add Stripe payments to your app
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 1: Identify the Need │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ "I need to add payment processing to my app" │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 2: Find the Right Skill │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ Search: "payment" or "stripe" │
|
||||
│ Found: @stripe-integration │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 3: Invoke the Skill │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ You: @stripe-integration help me add subscription billing │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 4: AI Loads Skill Knowledge │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ • Stripe API patterns │
|
||||
│ • Webhook handling │
|
||||
│ • Subscription management │
|
||||
│ • Best practices │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 5: Get Expert Help │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ AI provides: │
|
||||
│ • Code examples │
|
||||
│ • Setup instructions │
|
||||
│ • Security considerations │
|
||||
│ • Testing strategies │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Finding Skills (Visual Guide)
|
||||
|
||||
### Method 1: Browse by Category
|
||||
```
|
||||
README.md → Scroll to "Full Skill Registry" → Find category → Pick skill
|
||||
```
|
||||
|
||||
### Method 2: Search by Keyword
|
||||
```
|
||||
Terminal → ls skills/ | grep "keyword" → See matching skills
|
||||
```
|
||||
|
||||
### Method 3: Use the Index
|
||||
```
|
||||
Open skills_index.json → Search for keyword → Find skill path
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Creating Your First Skill (Visual Workflow)
|
||||
|
||||
```
|
||||
┌──────────────┐
|
||||
│ 1. IDEA │ "I want to share my Docker knowledge"
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 2. CREATE │ mkdir skills/docker-mastery
|
||||
└──────┬───────┘ touch skills/docker-mastery/SKILL.md
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 3. WRITE │ Add frontmatter + content
|
||||
└──────┬───────┘ (Use template from CONTRIBUTING_GUIDE.md)
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 4. TEST │ Copy to .agent/skills/
|
||||
└──────┬───────┘ Try: @docker-mastery
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 5. VALIDATE │ python3 scripts/validate_skills.py
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 6. SUBMIT │ git commit + push + Pull Request
|
||||
└──────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Skill Complexity Levels
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ SKILL COMPLEXITY │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ SIMPLE STANDARD COMPLEX │
|
||||
│ ────── ──────── ─────── │
|
||||
│ │
|
||||
│ • 1 file • 1 file • Multiple │
|
||||
│ • 100-200 words • 300-800 words • 800-2000 │
|
||||
│ • Basic structure • Full structure • Scripts │
|
||||
│ • No extras • Examples • Examples │
|
||||
│ • Best practices • Templates│
|
||||
│ • Docs │
|
||||
│ Example: Example: Example: │
|
||||
│ git-pushing brainstorming loki-mode │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Contribution Impact (Visual)
|
||||
|
||||
```
|
||||
Your Contribution
|
||||
│
|
||||
├─→ Improves Documentation
|
||||
│ │
|
||||
│ └─→ Helps 1000s of developers understand
|
||||
│
|
||||
├─→ Creates New Skill
|
||||
│ │
|
||||
│ └─→ Enables new capabilities for everyone
|
||||
│
|
||||
├─→ Fixes Bug/Typo
|
||||
│ │
|
||||
│ └─→ Prevents confusion for future users
|
||||
│
|
||||
└─→ Adds Example
|
||||
│
|
||||
└─→ Makes learning easier for beginners
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Learning Path (Visual Roadmap)
|
||||
|
||||
```
|
||||
START HERE
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Read │
|
||||
│ GETTING_STARTED │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Try 2-3 Skills │
|
||||
│ in AI Assistant │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Read │
|
||||
│ SKILL_ANATOMY │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Study Existing │
|
||||
│ Skills │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Create Simple │
|
||||
│ Skill │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Read │
|
||||
│ CONTRIBUTING │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Submit PR │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
CONTRIBUTOR! 🎉
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 💡 Quick Tips (Visual Cheatsheet)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ QUICK REFERENCE │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 📥 INSTALL │
|
||||
│ git clone [repo] .agent/skills │
|
||||
│ │
|
||||
│ 🎯 USE │
|
||||
│ @skill-name [your request] │
|
||||
│ │
|
||||
│ 🔍 FIND │
|
||||
│ ls skills/ | grep "keyword" │
|
||||
│ │
|
||||
│ ✅ VALIDATE │
|
||||
│ python3 scripts/validate_skills.py │
|
||||
│ │
|
||||
│ 📝 CREATE │
|
||||
│ 1. mkdir skills/my-skill │
|
||||
│ 2. Create SKILL.md with frontmatter │
|
||||
│ 3. Add content │
|
||||
│ 4. Test & validate │
|
||||
│ 5. Submit PR │
|
||||
│ │
|
||||
│ 🆘 HELP │
|
||||
│ • GETTING_STARTED.md - Basics │
|
||||
│ • CONTRIBUTING_GUIDE.md - How to contribute │
|
||||
│ • SKILL_ANATOMY.md - Deep dive │
|
||||
│ • GitHub Issues - Ask questions │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Success Stories (Visual Timeline)
|
||||
|
||||
```
|
||||
Day 1: Install skills
|
||||
│
|
||||
└─→ "Wow, @brainstorming helped me design my app!"
|
||||
|
||||
Day 3: Use 5 different skills
|
||||
│
|
||||
└─→ "These skills save me so much time!"
|
||||
|
||||
Week 1: Create first skill
|
||||
│
|
||||
└─→ "I shared my expertise as a skill!"
|
||||
|
||||
Week 2: Skill gets merged
|
||||
│
|
||||
└─→ "My skill is helping others! 🎉"
|
||||
|
||||
Month 1: Regular contributor
|
||||
│
|
||||
└─→ "I've contributed 5 skills and improved docs!"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. ✅ **Understand** the visual structure
|
||||
2. ✅ **Install** skills in your AI tool
|
||||
3. ✅ **Try** 2-3 skills from different categories
|
||||
4. ✅ **Read** CONTRIBUTING_GUIDE.md
|
||||
5. ✅ **Create** your first skill
|
||||
6. ✅ **Share** with the community
|
||||
|
||||
---
|
||||
|
||||
**Visual learner?** This guide should help! Still have questions? Check out:
|
||||
- [GETTING_STARTED.md](../GETTING_STARTED.md) - Text-based intro
|
||||
- [SKILL_ANATOMY.md](SKILL_ANATOMY.md) - Detailed breakdown
|
||||
- [CONTRIBUTING_GUIDE.md](../CONTRIBUTING_GUIDE.md) - How to contribute
|
||||
|
||||
**Ready to contribute?** You've got this! 💪
|
||||
This document moved to [`users/visual-guide.md`](users/visual-guide.md).
|
||||
|
||||
@@ -1,215 +1,3 @@
|
||||
# Antigravity Workflows
|
||||
# Workflows
|
||||
|
||||
> Workflow playbooks to orchestrate multiple skills with less friction.
|
||||
|
||||
## What Is a Workflow?
|
||||
|
||||
A workflow is a guided, step-by-step execution path that combines multiple skills for one concrete outcome.
|
||||
|
||||
- **Bundles** tell you which skills are relevant for a role.
|
||||
- **Workflows** tell you how to use those skills in sequence to complete a real objective.
|
||||
|
||||
If bundles are your toolbox, workflows are your execution playbook.
|
||||
|
||||
---
|
||||
|
||||
## How to Use Workflows
|
||||
|
||||
1. Install the repository once (`npx antigravity-awesome-skills`).
|
||||
2. Pick a workflow matching your immediate goal.
|
||||
3. Execute steps in order and invoke the listed skills in each step.
|
||||
4. Keep output artifacts at each step (plan, decisions, tests, validation evidence).
|
||||
|
||||
You can combine workflows with bundles from [BUNDLES.md](BUNDLES.md) when you need broader coverage.
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Ship a SaaS MVP
|
||||
|
||||
Build and ship a minimal but production-minded SaaS product.
|
||||
|
||||
**Related bundles:** `Essentials`, `Full-Stack Developer`, `QA & Testing`, `DevOps & Cloud`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Local repository and runtime configured.
|
||||
- Clear user problem and MVP scope.
|
||||
- Basic deployment target selected.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Plan the scope**
|
||||
- **Goal:** Define MVP boundaries and acceptance criteria.
|
||||
- **Skills:** [`@brainstorming`](../skills/brainstorming/), [`@concise-planning`](../skills/concise-planning/), [`@writing-plans`](../skills/writing-plans/)
|
||||
- **Prompt example:** `Usa @concise-planning per definire milestones e criteri di accettazione del mio MVP SaaS.`
|
||||
|
||||
2. **Build backend and API**
|
||||
- **Goal:** Implement core entities, APIs, and auth baseline.
|
||||
- **Skills:** [`@backend-dev-guidelines`](../skills/backend-dev-guidelines/), [`@api-patterns`](../skills/api-patterns/), [`@database-design`](../skills/database-design/)
|
||||
- **Prompt example:** `Usa @backend-dev-guidelines per creare API e servizi del dominio billing.`
|
||||
|
||||
3. **Build frontend**
|
||||
- **Goal:** Ship core user flow with clear UX states.
|
||||
- **Skills:** [`@frontend-developer`](../skills/frontend-developer/), [`@react-patterns`](../skills/react-patterns/), [`@frontend-design`](../skills/frontend-design/)
|
||||
- **Prompt example:** `Usa @frontend-developer per implementare onboarding, empty state e dashboard iniziale.`
|
||||
|
||||
4. **Test and validate**
|
||||
- **Goal:** Cover critical user journeys before release.
|
||||
- **Skills:** [`@test-driven-development`](../skills/test-driven-development/), [`@browser-automation`](../skills/browser-automation/), `@go-playwright` (optional, Go stack)
|
||||
- **Prompt example:** `Usa @browser-automation per creare test E2E sui flussi signup e checkout.`
|
||||
- **Go note:** Se il progetto QA e tooling sono in Go, preferisci `@go-playwright`.
|
||||
|
||||
5. **Ship safely**
|
||||
- **Goal:** Release with observability and rollback plan.
|
||||
- **Skills:** [`@deployment-procedures`](../skills/deployment-procedures/), [`@observability-engineer`](../skills/observability-engineer/)
|
||||
- **Prompt example:** `Usa @deployment-procedures per una checklist di rilascio con rollback.`
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Security Audit for a Web App
|
||||
|
||||
Run a focused security review from scope definition to remediation validation.
|
||||
|
||||
**Related bundles:** `Security Engineer`, `Security Developer`, `Observability & Monitoring`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Explicit authorization for testing.
|
||||
- In-scope targets documented.
|
||||
- Logging and environment details available.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Define scope and threat model**
|
||||
- **Goal:** Identify assets, trust boundaries, and attack paths.
|
||||
- **Skills:** [`@ethical-hacking-methodology`](../skills/ethical-hacking-methodology/), [`@threat-modeling-expert`](../skills/threat-modeling-expert/), [`@attack-tree-construction`](../skills/attack-tree-construction/)
|
||||
- **Prompt example:** `Usa @threat-modeling-expert per mappare asset critici e trust boundaries della mia web app.`
|
||||
|
||||
2. **Review auth and access control**
|
||||
- **Goal:** Detect account takeover and authorization flaws.
|
||||
- **Skills:** [`@broken-authentication`](../skills/broken-authentication/), [`@auth-implementation-patterns`](../skills/auth-implementation-patterns/), [`@idor-testing`](../skills/idor-testing/)
|
||||
- **Prompt example:** `Usa @idor-testing per verificare accessi non autorizzati su endpoint multitenant.`
|
||||
|
||||
3. **Assess API and input security**
|
||||
- **Goal:** Uncover high-impact API and injection vulnerabilities.
|
||||
- **Skills:** [`@api-security-best-practices`](../skills/api-security-best-practices/), [`@api-fuzzing-bug-bounty`](../skills/api-fuzzing-bug-bounty/), [`@top-web-vulnerabilities`](../skills/top-web-vulnerabilities/)
|
||||
- **Prompt example:** `Usa @api-security-best-practices per audit endpoint auth, billing e admin.`
|
||||
|
||||
4. **Harden and verify**
|
||||
- **Goal:** Convert findings into fixes and verify evidence of mitigation.
|
||||
- **Skills:** [`@security-auditor`](../skills/security-auditor/), [`@sast-configuration`](../skills/sast-configuration/), [`@verification-before-completion`](../skills/verification-before-completion/)
|
||||
- **Prompt example:** `Usa @verification-before-completion per provare che le mitigazioni sono effettive.`
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Build an AI Agent System
|
||||
|
||||
Design and deliver a production-grade agent with measurable reliability.
|
||||
|
||||
**Related bundles:** `Agent Architect`, `LLM Application Developer`, `Data Engineering`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Narrow use case with measurable outcomes.
|
||||
- Access to model provider(s) and observability tooling.
|
||||
- Initial dataset or knowledge corpus.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Define target behavior and KPIs**
|
||||
- **Goal:** Set quality, latency, and failure thresholds.
|
||||
- **Skills:** [`@ai-agents-architect`](../skills/ai-agents-architect/), [`@agent-evaluation`](../skills/agent-evaluation/), [`@product-manager-toolkit`](../skills/product-manager-toolkit/)
|
||||
- **Prompt example:** `Usa @agent-evaluation per definire benchmark e criteri di successo del mio agente.`
|
||||
|
||||
2. **Design retrieval and memory**
|
||||
- **Goal:** Build reliable retrieval and context architecture.
|
||||
- **Skills:** [`@llm-app-patterns`](../skills/llm-app-patterns/), [`@rag-implementation`](../skills/rag-implementation/), [`@vector-database-engineer`](../skills/vector-database-engineer/)
|
||||
- **Prompt example:** `Usa @rag-implementation per progettare pipeline di chunking, embedding e retrieval.`
|
||||
|
||||
3. **Implement orchestration**
|
||||
- **Goal:** Implement deterministic orchestration and tool boundaries.
|
||||
- **Skills:** [`@langgraph`](../skills/langgraph/), [`@mcp-builder`](../skills/mcp-builder/), [`@workflow-automation`](../skills/workflow-automation/)
|
||||
- **Prompt example:** `Usa @langgraph per implementare il grafo agente con fallback e human-in-the-loop.`
|
||||
|
||||
4. **Evaluate and iterate**
|
||||
- **Goal:** Improve weak points with a structured loop.
|
||||
- **Skills:** [`@agent-evaluation`](../skills/agent-evaluation/), [`@langfuse`](../skills/langfuse/), [`@kaizen`](../skills/kaizen/)
|
||||
- **Prompt example:** `Usa @kaizen per prioritizzare le correzioni sulle failure modes rilevate dai test.`
|
||||
|
||||
---
|
||||
|
||||
## Workflow: QA and Browser Automation
|
||||
|
||||
Create resilient browser automation with deterministic execution in CI.
|
||||
|
||||
**Related bundles:** `QA & Testing`, `Full-Stack Developer`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Test environments and stable credentials.
|
||||
- Critical user journeys identified.
|
||||
- CI pipeline available.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Prepare test strategy**
|
||||
- **Goal:** Scope journeys, fixtures, and execution environments.
|
||||
- **Skills:** [`@e2e-testing-patterns`](../skills/e2e-testing-patterns/), [`@test-driven-development`](../skills/test-driven-development/)
|
||||
- **Prompt example:** `Usa @e2e-testing-patterns per definire suite E2E minima ma ad alto impatto.`
|
||||
|
||||
2. **Implement browser tests**
|
||||
- **Goal:** Build robust test coverage with stable selectors.
|
||||
- **Skills:** [`@browser-automation`](../skills/browser-automation/), `@go-playwright` (optional, Go stack)
|
||||
- **Prompt example:** `Usa @go-playwright per implementare browser automation in un progetto Go.`
|
||||
|
||||
3. **Triage and harden**
|
||||
- **Goal:** Remove flaky behavior and enforce repeatability.
|
||||
- **Skills:** [`@systematic-debugging`](../skills/systematic-debugging/), [`@test-fixing`](../skills/test-fixing/), [`@verification-before-completion`](../skills/verification-before-completion/)
|
||||
- **Prompt example:** `Usa @systematic-debugging per classificare e risolvere le flakiness in CI.`
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Design a DDD Core Domain
|
||||
|
||||
Model a complex domain coherently, then implement tactical and evented patterns only where justified.
|
||||
|
||||
**Related bundles:** `Architecture & Design`, `DDD & Evented Architecture`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Access to at least one domain expert or product owner proxy.
|
||||
- Current system context and integration landscape available.
|
||||
- Agreement on business goals and key domain outcomes.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Assess DDD fit and scope**
|
||||
- **Goal:** Decide whether full DDD, partial DDD, or simple modular architecture is appropriate.
|
||||
- **Skills:** [`@domain-driven-design`](../skills/domain-driven-design/), [`@architecture-decision-records`](../skills/architecture-decision-records/)
|
||||
- **Prompt example:** `Use @domain-driven-design to evaluate if full DDD is justified for our billing and fulfillment platform.`
|
||||
|
||||
2. **Create strategic model**
|
||||
- **Goal:** Define subdomains, bounded contexts, and ubiquitous language.
|
||||
- **Skills:** [`@ddd-strategic-design`](../skills/ddd-strategic-design/)
|
||||
- **Prompt example:** `Use @ddd-strategic-design to classify subdomains and propose bounded contexts with ownership.`
|
||||
|
||||
3. **Map context relationships**
|
||||
- **Goal:** Define upstream/downstream contracts and anti-corruption boundaries.
|
||||
- **Skills:** [`@ddd-context-mapping`](../skills/ddd-context-mapping/)
|
||||
- **Prompt example:** `Use @ddd-context-mapping to model Checkout, Billing, and Inventory interactions with clear contract ownership.`
|
||||
|
||||
4. **Implement tactical model**
|
||||
- **Goal:** Encode invariants with aggregates, value objects, and domain events.
|
||||
- **Skills:** [`@ddd-tactical-patterns`](../skills/ddd-tactical-patterns/), [`@test-driven-development`](../skills/test-driven-development/)
|
||||
- **Prompt example:** `Use @ddd-tactical-patterns to design aggregates and invariants for order lifecycle transitions.`
|
||||
|
||||
5. **Adopt evented patterns selectively**
|
||||
- **Goal:** Apply CQRS, event store, projections, and sagas only where complexity and scale require them.
|
||||
- **Skills:** [`@cqrs-implementation`](../skills/cqrs-implementation/), [`@event-store-design`](../skills/event-store-design/), [`@projection-patterns`](../skills/projection-patterns/), [`@saga-orchestration`](../skills/saga-orchestration/)
|
||||
- **Prompt example:** `Use @cqrs-implementation and @projection-patterns to scale read-side reporting without compromising domain invariants.`
|
||||
|
||||
---
|
||||
|
||||
## Machine-Readable Workflows
|
||||
|
||||
For tooling and automation, workflow metadata is available in [data/workflows.json](../data/workflows.json).
|
||||
This document moved to [`users/workflows.md`](users/workflows.md).
|
||||
|
||||
33
docs/contributors/community-guidelines.md
Normal file
33
docs/contributors/community-guidelines.md
Normal file
@@ -0,0 +1,33 @@
|
||||
# Code of Conduct
|
||||
|
||||
## Our Pledge
|
||||
|
||||
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone.
|
||||
|
||||
## Our Standards
|
||||
|
||||
Examples of behavior that contributes to creating a positive environment include:
|
||||
|
||||
- Using welcoming and inclusive language
|
||||
- Being respectful of differing viewpoints and experiences
|
||||
- Gracefully accepting constructive criticism
|
||||
- Focusing on what is best for the community
|
||||
- Showing empathy towards other community members
|
||||
|
||||
Examples of unacceptable behavior by participants include:
|
||||
|
||||
- The use of sexualized language or imagery and unwelcome sexual attention or advances
|
||||
- Trolling, insulting/derogatory comments, and personal or political attacks
|
||||
- Public or private harassment
|
||||
- Publishing others' private information without explicit permission
|
||||
- Other conduct which could reasonably be considered inappropriate in a professional setting
|
||||
|
||||
## Enforcement
|
||||
|
||||
Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
|
||||
|
||||
## Attribution
|
||||
|
||||
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1.
|
||||
|
||||
[homepage]: https://www.contributor-covenant.org
|
||||
760
docs/contributors/examples.md
Normal file
760
docs/contributors/examples.md
Normal file
@@ -0,0 +1,760 @@
|
||||
# 💡 Real-World Examples - See Skills in Action
|
||||
|
||||
**Learn by example!** This guide shows you real conversations using different skills.
|
||||
|
||||
---
|
||||
|
||||
## Example 1: Designing a Feature with @brainstorming
|
||||
|
||||
### The Scenario
|
||||
You want to add a "dark mode" feature to your app, but you're not sure how to approach it.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @brainstorming I want to add dark mode to my React app
|
||||
|
||||
AI: Great! Let me help you think through this. First, let me check your
|
||||
current project structure...
|
||||
|
||||
[AI examines your files]
|
||||
|
||||
I see you're using React with Tailwind CSS. Now, let's understand
|
||||
your requirements:
|
||||
|
||||
What's your primary goal for dark mode?
|
||||
a) User preference (toggle in settings)
|
||||
b) System preference (follow OS setting)
|
||||
c) Both (with manual override)
|
||||
|
||||
You: c) Both
|
||||
|
||||
AI: Perfect! That's the best user experience. Next question:
|
||||
|
||||
Where should the dark mode toggle be located?
|
||||
a) In the main navigation
|
||||
b) In a settings page
|
||||
c) In a dropdown menu
|
||||
d) Multiple locations
|
||||
|
||||
You: a) In the main navigation
|
||||
|
||||
AI: Good choice for accessibility. One more question:
|
||||
|
||||
Should dark mode preference persist across sessions?
|
||||
a) Yes, save to localStorage
|
||||
b) Yes, save to user account (requires backend)
|
||||
c) No, reset each session
|
||||
|
||||
You: a) Yes, save to localStorage
|
||||
|
||||
AI: Excellent! Now I have a clear picture. Let me present the design...
|
||||
|
||||
## Dark Mode Implementation Design
|
||||
|
||||
### Architecture Overview
|
||||
We'll use React Context for state management, Tailwind's dark mode
|
||||
utilities, and localStorage for persistence. The system will:
|
||||
1. Check OS preference on first visit
|
||||
2. Allow manual override via toggle
|
||||
3. Persist preference in localStorage
|
||||
|
||||
Does this approach look good so far?
|
||||
|
||||
You: Yes, continue
|
||||
|
||||
AI: [Continues with detailed design sections...]
|
||||
|
||||
[After design is complete]
|
||||
|
||||
I've saved the design to docs/plans/2026-01-20-dark-mode-design.md
|
||||
|
||||
Ready to set up for implementation?
|
||||
|
||||
You: Yes
|
||||
|
||||
AI: I'll create an isolated workspace using git worktrees and write an
|
||||
implementation plan. One moment...
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ AI asked focused questions one at a time
|
||||
- ✅ Explored your specific context
|
||||
- ✅ Presented design in sections
|
||||
- ✅ Saved documentation
|
||||
- ✅ Prepared for implementation
|
||||
|
||||
---
|
||||
|
||||
## Example 2: Debugging with @systematic-debugging
|
||||
|
||||
### The Scenario
|
||||
Your tests are failing, but you're not sure why.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @systematic-debugging My tests are failing with "Cannot read property
|
||||
'map' of undefined"
|
||||
|
||||
AI: Let me help you debug this systematically. First, I'll gather information:
|
||||
|
||||
1. Running the failing test to see the full error...
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
I see the error occurs in UserList.test.tsx at line 45. Let me examine
|
||||
the test file and the component...
|
||||
|
||||
[AI reads both files]
|
||||
|
||||
## Hypothesis
|
||||
The test is failing because `users` prop is undefined when the component
|
||||
renders. This suggests the mock data isn't being passed correctly.
|
||||
|
||||
## Verification
|
||||
Let me check the test setup...
|
||||
|
||||
[AI examines test]
|
||||
|
||||
Found it! The test is calling:
|
||||
```typescript
|
||||
render(<UserList />)
|
||||
```
|
||||
|
||||
But UserList requires a `users` prop. The component expects:
|
||||
```typescript
|
||||
interface UserListProps {
|
||||
users: User[];
|
||||
}
|
||||
```
|
||||
|
||||
## Solution
|
||||
The test should pass the users prop:
|
||||
```typescript
|
||||
const mockUsers = [
|
||||
{ id: 1, name: 'Alice' },
|
||||
{ id: 2, name: 'Bob' }
|
||||
];
|
||||
|
||||
render(<UserList users={mockUsers} />)
|
||||
```
|
||||
|
||||
Should I apply this fix?
|
||||
|
||||
You: Yes
|
||||
|
||||
AI: [Applies fix and runs tests]
|
||||
|
||||
✅ All tests passing!
|
||||
|
||||
## Root Cause
|
||||
The test was missing required props. This is a common issue when
|
||||
components are refactored to require props that were previously optional.
|
||||
|
||||
## Prevention
|
||||
Consider adding TypeScript strict mode to catch these at compile time:
|
||||
```json
|
||||
"strict": true,
|
||||
"strictNullChecks": true
|
||||
```
|
||||
|
||||
Would you like me to add this to your tsconfig.json?
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ Systematic investigation
|
||||
- ✅ Clear hypothesis
|
||||
- ✅ Verification before fixing
|
||||
- ✅ Root cause analysis
|
||||
- ✅ Prevention suggestions
|
||||
|
||||
---
|
||||
|
||||
## Example 3: Adding Payments with @stripe-integration
|
||||
|
||||
### The Scenario
|
||||
You need to add subscription billing to your SaaS app.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @stripe-integration I need to add monthly subscription billing
|
||||
|
||||
AI: I'll help you implement Stripe subscriptions. Let me understand your
|
||||
requirements:
|
||||
|
||||
Current stack detected:
|
||||
- Next.js 14 (App Router)
|
||||
- TypeScript
|
||||
- Prisma with PostgreSQL
|
||||
|
||||
For subscription billing, we'll need:
|
||||
|
||||
1. **Stripe Setup**
|
||||
- Stripe account and API keys
|
||||
- Webhook endpoint for events
|
||||
- Product and price IDs
|
||||
|
||||
2. **Backend Implementation**
|
||||
- API routes for checkout
|
||||
- Webhook handler
|
||||
- Database schema for subscriptions
|
||||
|
||||
3. **Frontend Implementation**
|
||||
- Pricing page
|
||||
- Checkout flow
|
||||
- Subscription management
|
||||
|
||||
Let's start with the backend. First, install dependencies:
|
||||
|
||||
```bash
|
||||
npm install stripe @stripe/stripe-js
|
||||
```
|
||||
|
||||
Now, let's create the database schema...
|
||||
|
||||
[AI provides Prisma schema]
|
||||
|
||||
```prisma
|
||||
model User {
|
||||
id String @id @default(cuid())
|
||||
email String @unique
|
||||
stripeCustomerId String? @unique
|
||||
subscriptions Subscription[]
|
||||
}
|
||||
|
||||
model Subscription {
|
||||
id String @id @default(cuid())
|
||||
userId String
|
||||
user User @relation(fields: [userId], references: [id])
|
||||
stripeSubscriptionId String @unique
|
||||
status String
|
||||
priceId String
|
||||
currentPeriodEnd DateTime
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
}
|
||||
```
|
||||
|
||||
Next, let's create the checkout API route...
|
||||
|
||||
[AI provides complete implementation with:]
|
||||
- API route for creating checkout sessions
|
||||
- Webhook handler for subscription events
|
||||
- Helper functions for Stripe operations
|
||||
- Error handling and logging
|
||||
- TypeScript types
|
||||
|
||||
Now for the frontend...
|
||||
|
||||
[AI provides:]
|
||||
- Pricing page component
|
||||
- Checkout button component
|
||||
- Subscription status display
|
||||
- Tailwind styling
|
||||
|
||||
Finally, let's set up the webhook:
|
||||
|
||||
1. In Stripe Dashboard, add webhook endpoint:
|
||||
`https://yourdomain.com/api/webhooks/stripe`
|
||||
|
||||
2. Select these events:
|
||||
- customer.subscription.created
|
||||
- customer.subscription.updated
|
||||
- customer.subscription.deleted
|
||||
- invoice.payment_succeeded
|
||||
- invoice.payment_failed
|
||||
|
||||
3. Copy the webhook secret to your .env:
|
||||
```
|
||||
STRIPE_WEBHOOK_SECRET=whsec_...
|
||||
```
|
||||
|
||||
## Testing
|
||||
|
||||
Test locally with Stripe CLI:
|
||||
```bash
|
||||
stripe listen --forward-to localhost:3000/api/webhooks/stripe
|
||||
stripe trigger customer.subscription.created
|
||||
```
|
||||
|
||||
## Security Checklist
|
||||
- ✅ API keys in environment variables
|
||||
- ✅ Webhook signature verification
|
||||
- ✅ Server-side price validation
|
||||
- ✅ Idempotency keys for operations
|
||||
|
||||
Ready to test the implementation?
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ Detected existing stack
|
||||
- ✅ Provided complete implementation
|
||||
- ✅ Included database schema
|
||||
- ✅ Added security best practices
|
||||
- ✅ Included testing instructions
|
||||
|
||||
---
|
||||
|
||||
## Example 4: Writing Copy with @copywriting
|
||||
|
||||
### The Scenario
|
||||
You need compelling copy for your SaaS landing page.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @copywriting Write homepage copy for my project management tool
|
||||
|
||||
AI: I'll help you create compelling homepage copy. First, let me understand
|
||||
your product:
|
||||
|
||||
What makes your project management tool different from competitors
|
||||
like Asana, Trello, or Monday.com?
|
||||
|
||||
You: It's specifically built for remote teams with built-in video standups
|
||||
and async communication features
|
||||
|
||||
AI: Excellent differentiator! Who is your primary target audience?
|
||||
a) Startups and small teams (2-20 people)
|
||||
b) Mid-size companies (20-200 people)
|
||||
c) Enterprise (200+ people)
|
||||
d) Freelancers and agencies
|
||||
|
||||
You: a) Startups and small teams
|
||||
|
||||
AI: Perfect. What's the main pain point you solve?
|
||||
|
||||
You: Remote teams waste time in unnecessary meetings and lose context
|
||||
in async communication
|
||||
|
||||
AI: Great! Now I have what I need. Here's your homepage copy:
|
||||
|
||||
---
|
||||
|
||||
## Hero Section
|
||||
|
||||
**Headline:**
|
||||
Run Your Remote Team Without the Meeting Overload
|
||||
|
||||
**Subheadline:**
|
||||
The project management tool built for distributed teams. Replace
|
||||
status meetings with async video standups and keep everyone in sync
|
||||
without the Zoom fatigue.
|
||||
|
||||
**CTA:**
|
||||
Start Free Trial → (No credit card required)
|
||||
|
||||
---
|
||||
|
||||
## Problem Section
|
||||
|
||||
**Headline:**
|
||||
Remote Work Shouldn't Mean More Meetings
|
||||
|
||||
**Body:**
|
||||
Your team is distributed across time zones. You're spending hours in
|
||||
status meetings just to stay aligned. Async updates get lost in Slack.
|
||||
Context disappears. Productivity suffers.
|
||||
|
||||
Sound familiar?
|
||||
|
||||
---
|
||||
|
||||
## Solution Section
|
||||
|
||||
**Headline:**
|
||||
Stay Aligned Without the Meeting Marathon
|
||||
|
||||
**Features:**
|
||||
|
||||
📹 **Async Video Standups**
|
||||
Record quick video updates on your schedule. Your team watches when
|
||||
it works for them. No more 9am calls for your teammate in Tokyo.
|
||||
|
||||
💬 **Context-Rich Communication**
|
||||
Every task, comment, and decision stays connected. No more hunting
|
||||
through Slack threads or email chains.
|
||||
|
||||
📊 **Visual Progress Tracking**
|
||||
See what's happening at a glance. Kanban boards, timelines, and
|
||||
dashboards that actually make sense.
|
||||
|
||||
🔔 **Smart Notifications**
|
||||
Get notified about what matters. Ignore the rest. Your focus time
|
||||
is sacred.
|
||||
|
||||
---
|
||||
|
||||
## Social Proof Section
|
||||
|
||||
**Headline:**
|
||||
Trusted by Remote Teams Worldwide
|
||||
|
||||
[Testimonial placeholders with structure]
|
||||
|
||||
---
|
||||
|
||||
## CTA Section
|
||||
|
||||
**Headline:**
|
||||
Ready to Reclaim Your Calendar?
|
||||
|
||||
**Body:**
|
||||
Join 500+ remote teams who've cut meeting time by 60% while staying
|
||||
more aligned than ever.
|
||||
|
||||
**CTA:**
|
||||
Start Your Free 14-Day Trial →
|
||||
|
||||
No credit card required. Cancel anytime.
|
||||
|
||||
---
|
||||
|
||||
## Copy Notes
|
||||
|
||||
**Tone:** Professional but conversational
|
||||
**Focus:** Pain point (too many meetings) → Solution (async video)
|
||||
**Differentiation:** Built specifically for remote teams
|
||||
**Social proof:** Quantified benefit (60% fewer meetings)
|
||||
|
||||
Would you like me to:
|
||||
1. Write alternative versions for A/B testing?
|
||||
2. Create copy for specific feature pages?
|
||||
3. Write email sequences for onboarding?
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ Asked clarifying questions
|
||||
- ✅ Identified unique value proposition
|
||||
- ✅ Created benefit-focused copy
|
||||
- ✅ Included clear CTAs
|
||||
- ✅ Provided copy notes for consistency
|
||||
|
||||
---
|
||||
|
||||
## Example 5: Test-Driven Development with @test-driven-development
|
||||
|
||||
### The Scenario
|
||||
You need to implement a new feature: user authentication.
|
||||
|
||||
### The Conversation
|
||||
|
||||
```
|
||||
You: @test-driven-development I need to implement user login functionality
|
||||
|
||||
AI: Perfect! Let's use TDD to build this. Following the Red-Green-Refactor
|
||||
cycle, we'll write tests first, then implement.
|
||||
|
||||
## Step 1: Write the First Test (RED)
|
||||
|
||||
Let's start with the simplest case - successful login:
|
||||
|
||||
```typescript
|
||||
// auth.test.ts
|
||||
import { login } from './auth';
|
||||
|
||||
describe('login', () => {
|
||||
it('should return user data for valid credentials', async () => {
|
||||
const result = await login({
|
||||
email: 'user@example.com',
|
||||
password: 'correct-password'
|
||||
});
|
||||
|
||||
expect(result.success).toBe(true);
|
||||
expect(result.user).toHaveProperty('id');
|
||||
expect(result.user).toHaveProperty('email');
|
||||
expect(result.token).toBeDefined();
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
Let's run this test to see it fail:
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
✅ Test fails as expected (auth.ts doesn't exist yet)
|
||||
|
||||
## Step 2: Write Minimal Implementation (GREEN)
|
||||
|
||||
Now let's write just enough code to make this test pass:
|
||||
|
||||
```typescript
|
||||
// auth.ts
|
||||
interface LoginCredentials {
|
||||
email: string;
|
||||
password: string;
|
||||
}
|
||||
|
||||
interface LoginResult {
|
||||
success: boolean;
|
||||
user?: {
|
||||
id: string;
|
||||
email: string;
|
||||
};
|
||||
token?: string;
|
||||
}
|
||||
|
||||
export async function login(
|
||||
credentials: LoginCredentials
|
||||
): Promise<LoginResult> {
|
||||
// Minimal implementation to pass the test
|
||||
return {
|
||||
success: true,
|
||||
user: {
|
||||
id: '1',
|
||||
email: credentials.email
|
||||
},
|
||||
token: 'fake-token'
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
✅ Test passes!
|
||||
|
||||
## Step 3: Add Next Test (RED)
|
||||
|
||||
Now let's test the failure case:
|
||||
|
||||
```typescript
|
||||
it('should return error for invalid credentials', async () => {
|
||||
const result = await login({
|
||||
email: 'user@example.com',
|
||||
password: 'wrong-password'
|
||||
});
|
||||
|
||||
expect(result.success).toBe(false);
|
||||
expect(result.error).toBe('Invalid credentials');
|
||||
expect(result.user).toBeUndefined();
|
||||
expect(result.token).toBeUndefined();
|
||||
});
|
||||
```
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
❌ Test fails (always returns success)
|
||||
|
||||
## Step 4: Implement Real Logic (GREEN)
|
||||
|
||||
Now let's add actual authentication:
|
||||
|
||||
```typescript
|
||||
import bcrypt from 'bcrypt';
|
||||
import jwt from 'jsonwebtoken';
|
||||
import { db } from './db';
|
||||
|
||||
export async function login(
|
||||
credentials: LoginCredentials
|
||||
): Promise<LoginResult> {
|
||||
// Find user
|
||||
const user = await db.user.findUnique({
|
||||
where: { email: credentials.email }
|
||||
});
|
||||
|
||||
if (!user) {
|
||||
return {
|
||||
success: false,
|
||||
error: 'Invalid credentials'
|
||||
};
|
||||
}
|
||||
|
||||
// Verify password
|
||||
const validPassword = await bcrypt.compare(
|
||||
credentials.password,
|
||||
user.passwordHash
|
||||
);
|
||||
|
||||
if (!validPassword) {
|
||||
return {
|
||||
success: false,
|
||||
error: 'Invalid credentials'
|
||||
};
|
||||
}
|
||||
|
||||
// Generate token
|
||||
const token = jwt.sign(
|
||||
{ userId: user.id },
|
||||
process.env.JWT_SECRET!,
|
||||
{ expiresIn: '7d' }
|
||||
);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
user: {
|
||||
id: user.id,
|
||||
email: user.email
|
||||
},
|
||||
token
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
✅ All tests pass!
|
||||
|
||||
## Step 5: Add Edge Cases
|
||||
|
||||
Let's add more tests for edge cases:
|
||||
|
||||
```typescript
|
||||
it('should handle missing email', async () => {
|
||||
const result = await login({
|
||||
email: '',
|
||||
password: 'password'
|
||||
});
|
||||
|
||||
expect(result.success).toBe(false);
|
||||
expect(result.error).toBe('Email is required');
|
||||
});
|
||||
|
||||
it('should handle missing password', async () => {
|
||||
const result = await login({
|
||||
email: 'user@example.com',
|
||||
password: ''
|
||||
});
|
||||
|
||||
expect(result.success).toBe(false);
|
||||
expect(result.error).toBe('Password is required');
|
||||
});
|
||||
|
||||
it('should handle database errors gracefully', async () => {
|
||||
// Mock database error
|
||||
jest.spyOn(db.user, 'findUnique').mockRejectedValue(
|
||||
new Error('Database connection failed')
|
||||
);
|
||||
|
||||
const result = await login({
|
||||
email: 'user@example.com',
|
||||
password: 'password'
|
||||
});
|
||||
|
||||
expect(result.success).toBe(false);
|
||||
expect(result.error).toBe('An error occurred');
|
||||
});
|
||||
```
|
||||
|
||||
[AI implements validation and error handling]
|
||||
|
||||
## Step 6: Refactor (REFACTOR)
|
||||
|
||||
Now that all tests pass, let's refactor for better code quality:
|
||||
|
||||
```typescript
|
||||
// Extract validation
|
||||
function validateCredentials(credentials: LoginCredentials): string | null {
|
||||
if (!credentials.email) return 'Email is required';
|
||||
if (!credentials.password) return 'Password is required';
|
||||
return null;
|
||||
}
|
||||
|
||||
// Extract user verification
|
||||
async function verifyUser(
|
||||
email: string,
|
||||
password: string
|
||||
): Promise<User | null> {
|
||||
const user = await db.user.findUnique({ where: { email } });
|
||||
if (!user) return null;
|
||||
|
||||
const valid = await bcrypt.compare(password, user.passwordHash);
|
||||
return valid ? user : null;
|
||||
}
|
||||
|
||||
// Main function is now cleaner
|
||||
export async function login(
|
||||
credentials: LoginCredentials
|
||||
): Promise<LoginResult> {
|
||||
try {
|
||||
const validationError = validateCredentials(credentials);
|
||||
if (validationError) {
|
||||
return { success: false, error: validationError };
|
||||
}
|
||||
|
||||
const user = await verifyUser(
|
||||
credentials.email,
|
||||
credentials.password
|
||||
);
|
||||
|
||||
if (!user) {
|
||||
return { success: false, error: 'Invalid credentials' };
|
||||
}
|
||||
|
||||
const token = generateToken(user.id);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
user: { id: user.id, email: user.email },
|
||||
token
|
||||
};
|
||||
} catch (error) {
|
||||
console.error('Login error:', error);
|
||||
return { success: false, error: 'An error occurred' };
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
[AI runs: npm test]
|
||||
|
||||
✅ All tests still pass after refactoring!
|
||||
|
||||
## Summary
|
||||
|
||||
We've implemented login functionality using TDD:
|
||||
- ✅ 5 tests covering happy path, errors, and edge cases
|
||||
- ✅ Clean, testable code
|
||||
- ✅ Proper error handling
|
||||
- ✅ Type safety with TypeScript
|
||||
|
||||
Next steps:
|
||||
1. Add rate limiting tests
|
||||
2. Add session management tests
|
||||
3. Add logout functionality
|
||||
|
||||
Should I continue with these?
|
||||
```
|
||||
|
||||
### What Happened
|
||||
- ✅ Followed Red-Green-Refactor cycle
|
||||
- ✅ Wrote tests before implementation
|
||||
- ✅ Covered edge cases
|
||||
- ✅ Refactored with confidence
|
||||
- ✅ Maintained test coverage
|
||||
|
||||
---
|
||||
|
||||
## Key Takeaways
|
||||
|
||||
### What Makes These Examples Effective?
|
||||
|
||||
1. **Skills ask clarifying questions** before jumping to solutions
|
||||
2. **Skills provide context-aware help** based on your project
|
||||
3. **Skills follow best practices** for their domain
|
||||
4. **Skills include complete examples** not just snippets
|
||||
5. **Skills explain the "why"** not just the "how"
|
||||
|
||||
### How to Get Similar Results
|
||||
|
||||
1. **Be specific** in your requests
|
||||
2. **Provide context** about your project
|
||||
3. **Answer questions** the skill asks
|
||||
4. **Review suggestions** before applying
|
||||
5. **Iterate** based on results
|
||||
|
||||
---
|
||||
|
||||
## Try These Yourself!
|
||||
|
||||
Pick a skill and try it with your own project:
|
||||
|
||||
- **Planning:** `@brainstorming` or `@writing-plans`
|
||||
- **Development:** `@test-driven-development` or `@react-best-practices`
|
||||
- **Debugging:** `@systematic-debugging` or `@test-fixing`
|
||||
- **Integration:** `@stripe-integration` or `@firebase`
|
||||
- **Marketing:** `@copywriting` or `@seo-audit`
|
||||
|
||||
---
|
||||
|
||||
**Want more examples?** Check individual skill folders for additional examples and use cases!
|
||||
73
docs/contributors/quality-bar.md
Normal file
73
docs/contributors/quality-bar.md
Normal file
@@ -0,0 +1,73 @@
|
||||
# 🏆 Quality Bar & Validation Standards
|
||||
|
||||
To transform **Antigravity Awesome Skills** from a collection of scripts into a trusted platform, every skill must meet a specific standard of quality and safety.
|
||||
|
||||
## The "Validated" Badge ✅
|
||||
|
||||
A skill earns the "Validated" badge only if it meets these **5 quality checks**. Some are enforced automatically today, while others still require reviewer judgment:
|
||||
|
||||
### 1. Metadata Integrity
|
||||
|
||||
The `SKILL.md` frontmatter must be valid YAML and contain:
|
||||
|
||||
- `name`: Kebab-case, matches folder name.
|
||||
- `description`: Under 200 chars, clear value prop.
|
||||
- `risk`: One of `[none, safe, critical, offensive, unknown]`. Use `unknown` only for legacy or unclassified skills; prefer a concrete level for new skills.
|
||||
- `source`: URL to original source (or "self" if original).
|
||||
|
||||
### 2. Clear Triggers ("When to use")
|
||||
|
||||
The skill MUST have a section explicitly stating when to trigger it.
|
||||
|
||||
- **Good**: "Use when the user asks to debug a React component."
|
||||
- **Bad**: "This skill helps you with code."
|
||||
Accepted headings: `## When to Use`, `## Use this skill when`, `## When to Use This Skill`.
|
||||
|
||||
### 3. Safety & Risk Classification
|
||||
|
||||
Every skill must declare its risk level:
|
||||
|
||||
- 🟢 **none**: Pure text/reasoning (e.g., Brainstorming).
|
||||
- 🔵 **safe**: Reads files, runs safe commands (e.g., Linter).
|
||||
- 🟠 **critical**: Modifies state, deletes files, pushes to prod (e.g., Git Push).
|
||||
- 🔴 **offensive**: Pentesting/Red Team tools. **MUST** have "Authorized Use Only" warning.
|
||||
|
||||
### 4. Copy-Pasteable Examples
|
||||
|
||||
At least one code block or interaction example that a user (or agent) can immediately use.
|
||||
|
||||
### 5. Explicit Limitations
|
||||
|
||||
A list of known edge cases or things the skill _cannot_ do.
|
||||
|
||||
- _Example_: "Does not work on Windows without WSL."
|
||||
|
||||
---
|
||||
|
||||
## Support Levels
|
||||
|
||||
We also categorize skills by who maintains them:
|
||||
|
||||
| Level | Badge | Meaning |
|
||||
| :------------ | :---- | :-------------------------------------------------- |
|
||||
| **Official** | 🟣 | Maintained by the core team. High reliability. |
|
||||
| **Community** | ⚪ | Contributed by the ecosystem. Best effort support. |
|
||||
| **Verified** | ✨ | Community skill that has passed deep manual review. |
|
||||
|
||||
---
|
||||
|
||||
## How to Validate Your Skill
|
||||
|
||||
The canonical validator is `tools/scripts/validate_skills.py`, but the recommended entrypoint is `npm run validate` before submitting a PR:
|
||||
|
||||
```bash
|
||||
npm run validate
|
||||
npm run validate:references
|
||||
npm test
|
||||
```
|
||||
|
||||
Notes:
|
||||
|
||||
- `npm run validate` is the operational contributor gate.
|
||||
- `npm run validate:strict` is a useful hardening pass, but the repository still contains legacy skills that do not yet satisfy strict validation.
|
||||
- Examples and limitations remain part of the quality bar even when they are not fully auto-enforced by the current validator.
|
||||
51
docs/contributors/security-guardrails.md
Normal file
51
docs/contributors/security-guardrails.md
Normal file
@@ -0,0 +1,51 @@
|
||||
# 🛡️ Security Guardrails & Policy
|
||||
|
||||
Antigravity Awesome Skills is a powerful toolkit. With great power comes great responsibility. This document defines the **Rules of Engagement** for all security and offensive capabilities in this repository.
|
||||
|
||||
## 🔴 Offensive Skills Policy (The "Red Line")
|
||||
|
||||
**What is an Offensive Skill?**
|
||||
Any skill designed to penetrate, exploit, disrupt, or simulate attacks against systems.
|
||||
_Examples: Pentesting, SQL Injection, Phishing Simulation, Red Teaming._
|
||||
|
||||
### 1. The "Authorized Use Only" Disclaimer
|
||||
|
||||
Every offensive skill **MUST** begin with this exact disclaimer in its `SKILL.md`:
|
||||
|
||||
> **⚠️ AUTHORIZED USE ONLY**
|
||||
> This skill is for educational purposes or authorized security assessments only.
|
||||
> You must have explicit, written permission from the system owner before using this tool.
|
||||
> Misuse of this tool is illegal and strictly prohibited.
|
||||
|
||||
### 2. Mandatory User Confirmation
|
||||
|
||||
Offensive skills must **NEVER** run fully autonomously.
|
||||
|
||||
- **Requirement**: The skill description/instructions must explicitly tell the agent to _ask for user confirmation_ before executing any exploit or attack command.
|
||||
- **Agent Instruction**: "Ask the user to verify the target URL/IP before running."
|
||||
|
||||
### 3. Safe by Design
|
||||
|
||||
- **No Weaponized Payloads**: Skills should not include active malware, ransomware, or non-educational exploits.
|
||||
- **Sandbox Recommended**: Instructions should recommend running in a contained environment (Docker/VM).
|
||||
|
||||
---
|
||||
|
||||
## 🔵 Defensive Skills Policy
|
||||
|
||||
**What is a Defensive Skill?**
|
||||
Tools for hardening, auditing, monitoring, or protecting systems.
|
||||
_Examples: Linting, Log Analysis, Configuration Auditing._
|
||||
|
||||
- **Data Privacy**: Defensive skills must not upload data to 3rd party servers without explicit user consent.
|
||||
- **Non-Destructive**: Audits should be read-only by default.
|
||||
|
||||
---
|
||||
|
||||
## ⚖️ Legal Disclaimer
|
||||
|
||||
By using this repository, you agree that:
|
||||
|
||||
1. You are responsible for your own actions.
|
||||
2. The authors and contributors are not liable for any damage caused by these tools.
|
||||
3. You will comply with all local, state, and federal laws regarding cybersecurity.
|
||||
545
docs/contributors/skill-anatomy.md
Normal file
545
docs/contributors/skill-anatomy.md
Normal file
@@ -0,0 +1,545 @@
|
||||
# Anatomy of a Skill - Understanding the Structure
|
||||
|
||||
**Want to understand how skills work under the hood?** This guide breaks down every part of a skill file.
|
||||
|
||||
---
|
||||
|
||||
## 📁 Basic Folder Structure
|
||||
|
||||
```
|
||||
skills/
|
||||
└── my-skill-name/
|
||||
├── SKILL.md ← Required: The main skill definition
|
||||
├── examples/ ← Optional: Example files
|
||||
│ ├── example1.js
|
||||
│ └── example2.py
|
||||
├── scripts/ ← Optional: Helper scripts
|
||||
│ └── helper.sh
|
||||
├── templates/ ← Optional: Code templates
|
||||
│ └── template.tsx
|
||||
├── references/ ← Optional: Reference documentation
|
||||
│ └── api-docs.md
|
||||
└── README.md ← Optional: Additional documentation
|
||||
```
|
||||
|
||||
**Key Rule:** Only `SKILL.md` is required. Everything else is optional!
|
||||
|
||||
---
|
||||
|
||||
## SKILL.md Structure
|
||||
|
||||
Every `SKILL.md` file has two main parts:
|
||||
|
||||
### 1. Frontmatter (Metadata)
|
||||
### 2. Content (Instructions)
|
||||
|
||||
Let's break down each part:
|
||||
|
||||
---
|
||||
|
||||
## Part 1: Frontmatter
|
||||
|
||||
The frontmatter is at the very top, wrapped in `---`:
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: my-skill-name
|
||||
description: "Brief description of what this skill does"
|
||||
---
|
||||
```
|
||||
|
||||
### Required Fields
|
||||
|
||||
#### `name`
|
||||
- **What it is:** The skill's identifier
|
||||
- **Format:** lowercase-with-hyphens
|
||||
- **Must match:** The folder name exactly
|
||||
- **Example:** `stripe-integration`
|
||||
|
||||
#### `description`
|
||||
- **What it is:** One-sentence summary
|
||||
- **Format:** String in quotes
|
||||
- **Length:** Keep it under 150 characters
|
||||
- **Example:** `"Stripe payment integration patterns including checkout, subscriptions, and webhooks"`
|
||||
|
||||
### Optional Fields
|
||||
|
||||
Some skills include additional metadata:
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: my-skill-name
|
||||
description: "Brief description"
|
||||
version: "1.0.0"
|
||||
author: "Your Name"
|
||||
tags: ["react", "typescript", "testing"]
|
||||
---
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Part 2: Content
|
||||
|
||||
After the frontmatter comes the actual skill content. Here's the recommended structure:
|
||||
|
||||
### Recommended Sections
|
||||
|
||||
#### 1. Title (H1)
|
||||
```markdown
|
||||
# Skill Title
|
||||
```
|
||||
- Use a clear, descriptive title
|
||||
- Usually matches or expands on the skill name
|
||||
|
||||
#### 2. Overview
|
||||
```markdown
|
||||
## Overview
|
||||
|
||||
A brief explanation of what this skill does and why it exists.
|
||||
2-4 sentences is perfect.
|
||||
```
|
||||
|
||||
#### 3. When to Use
|
||||
```markdown
|
||||
## When to Use This Skill
|
||||
|
||||
- Use when you need to [scenario 1]
|
||||
- Use when working with [scenario 2]
|
||||
- Use when the user asks about [scenario 3]
|
||||
```
|
||||
|
||||
**Why this matters:** Helps the AI know when to activate this skill
|
||||
|
||||
#### 4. Core Instructions
|
||||
```markdown
|
||||
## How It Works
|
||||
|
||||
### Step 1: [Action]
|
||||
Detailed instructions...
|
||||
|
||||
### Step 2: [Action]
|
||||
More instructions...
|
||||
```
|
||||
|
||||
**This is the heart of your skill** - clear, actionable steps
|
||||
|
||||
#### 5. Examples
|
||||
```markdown
|
||||
## Examples
|
||||
|
||||
### Example 1: [Use Case]
|
||||
\`\`\`javascript
|
||||
// Example code
|
||||
\`\`\`
|
||||
|
||||
### Example 2: [Another Use Case]
|
||||
\`\`\`javascript
|
||||
// More code
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
**Why examples matter:** They show the AI exactly what good output looks like
|
||||
|
||||
#### 6. Best Practices
|
||||
```markdown
|
||||
## Best Practices
|
||||
|
||||
- ✅ Do this
|
||||
- ✅ Also do this
|
||||
- ❌ Don't do this
|
||||
- ❌ Avoid this
|
||||
```
|
||||
|
||||
#### 7. Common Pitfalls
|
||||
```markdown
|
||||
## Common Pitfalls
|
||||
|
||||
- **Problem:** Description
|
||||
**Solution:** How to fix it
|
||||
```
|
||||
|
||||
#### 8. Related Skills
|
||||
```markdown
|
||||
## Related Skills
|
||||
|
||||
- `@other-skill` - When to use this instead
|
||||
- `@complementary-skill` - How this works together
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Writing Effective Instructions
|
||||
|
||||
### Use Clear, Direct Language
|
||||
|
||||
**❌ Bad:**
|
||||
```markdown
|
||||
You might want to consider possibly checking if the user has authentication.
|
||||
```
|
||||
|
||||
**✅ Good:**
|
||||
```markdown
|
||||
Check if the user is authenticated before proceeding.
|
||||
```
|
||||
|
||||
### Use Action Verbs
|
||||
|
||||
**❌ Bad:**
|
||||
```markdown
|
||||
The file should be created...
|
||||
```
|
||||
|
||||
**✅ Good:**
|
||||
```markdown
|
||||
Create the file...
|
||||
```
|
||||
|
||||
### Be Specific
|
||||
|
||||
**❌ Bad:**
|
||||
```markdown
|
||||
Set up the database properly.
|
||||
```
|
||||
|
||||
**✅ Good:**
|
||||
```markdown
|
||||
1. Create a PostgreSQL database
|
||||
2. Run migrations: `npm run migrate`
|
||||
3. Seed initial data: `npm run seed`
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Optional Components
|
||||
|
||||
### Scripts Directory
|
||||
|
||||
If your skill needs helper scripts:
|
||||
|
||||
```
|
||||
scripts/
|
||||
├── setup.sh ← Setup automation
|
||||
├── validate.py ← Validation tools
|
||||
└── generate.js ← Code generators
|
||||
```
|
||||
|
||||
**Reference them in SKILL.md:**
|
||||
```markdown
|
||||
Run the setup script:
|
||||
\`\`\`bash
|
||||
bash scripts/setup.sh
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
### Examples Directory
|
||||
|
||||
Real-world examples that demonstrate the skill:
|
||||
|
||||
```
|
||||
examples/
|
||||
├── basic-usage.js
|
||||
├── advanced-pattern.ts
|
||||
└── full-implementation/
|
||||
├── index.js
|
||||
└── config.json
|
||||
```
|
||||
|
||||
### Templates Directory
|
||||
|
||||
Reusable code templates:
|
||||
|
||||
```
|
||||
templates/
|
||||
├── component.tsx
|
||||
├── test.spec.ts
|
||||
└── config.json
|
||||
```
|
||||
|
||||
**Reference in SKILL.md:**
|
||||
```markdown
|
||||
Use this template as a starting point:
|
||||
\`\`\`typescript
|
||||
{{#include templates/component.tsx}}
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
### References Directory
|
||||
|
||||
External documentation or API references:
|
||||
|
||||
```
|
||||
references/
|
||||
├── api-docs.md
|
||||
├── best-practices.md
|
||||
└── troubleshooting.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Skill Size Guidelines
|
||||
|
||||
### Minimum Viable Skill
|
||||
- **Frontmatter:** name + description
|
||||
- **Content:** 100-200 words
|
||||
- **Sections:** Overview + Instructions
|
||||
|
||||
### Standard Skill
|
||||
- **Frontmatter:** name + description
|
||||
- **Content:** 300-800 words
|
||||
- **Sections:** Overview + When to Use + Instructions + Examples
|
||||
|
||||
### Comprehensive Skill
|
||||
- **Frontmatter:** name + description + optional fields
|
||||
- **Content:** 800-2000 words
|
||||
- **Sections:** All recommended sections
|
||||
- **Extras:** Scripts, examples, templates
|
||||
|
||||
**Rule of thumb:** Start small, expand based on feedback
|
||||
|
||||
---
|
||||
|
||||
## Formatting Best Practices
|
||||
|
||||
### Use Markdown Effectively
|
||||
|
||||
#### Code Blocks
|
||||
Always specify the language:
|
||||
```markdown
|
||||
\`\`\`javascript
|
||||
const example = "code";
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
#### Lists
|
||||
Use consistent formatting:
|
||||
```markdown
|
||||
- Item 1
|
||||
- Item 2
|
||||
- Sub-item 2.1
|
||||
- Sub-item 2.2
|
||||
```
|
||||
|
||||
#### Emphasis
|
||||
- **Bold** for important terms: `**important**`
|
||||
- *Italic* for emphasis: `*emphasis*`
|
||||
- `Code` for commands/code: `` `code` ``
|
||||
|
||||
#### Links
|
||||
```markdown
|
||||
[Link text](https://example.com)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Quality Checklist
|
||||
|
||||
Before finalizing your skill:
|
||||
|
||||
### Content Quality
|
||||
- [ ] Instructions are clear and actionable
|
||||
- [ ] Examples are realistic and helpful
|
||||
- [ ] No typos or grammar errors
|
||||
- [ ] Technical accuracy verified
|
||||
|
||||
### Structure
|
||||
- [ ] Frontmatter is valid YAML
|
||||
- [ ] Name matches folder name
|
||||
- [ ] Sections are logically organized
|
||||
- [ ] Headings follow hierarchy (H1 → H2 → H3)
|
||||
|
||||
### Completeness
|
||||
- [ ] Overview explains the "why"
|
||||
- [ ] Instructions explain the "how"
|
||||
- [ ] Examples show the "what"
|
||||
- [ ] Edge cases are addressed
|
||||
|
||||
### Usability
|
||||
- [ ] A beginner could follow this
|
||||
- [ ] An expert would find it useful
|
||||
- [ ] The AI can parse it correctly
|
||||
- [ ] It solves a real problem
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Real-World Example Analysis
|
||||
|
||||
Let's analyze a real skill: `brainstorming`
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: brainstorming
|
||||
description: "You MUST use this before any creative work..."
|
||||
---
|
||||
```
|
||||
|
||||
**Analysis:**
|
||||
- ✅ Clear name
|
||||
- ✅ Strong description with urgency ("MUST use")
|
||||
- ✅ Explains when to use it
|
||||
|
||||
```markdown
|
||||
# Brainstorming Ideas Into Designs
|
||||
|
||||
## Overview
|
||||
Help turn ideas into fully formed designs...
|
||||
```
|
||||
|
||||
**Analysis:**
|
||||
- ✅ Clear title
|
||||
- ✅ Concise overview
|
||||
- ✅ Explains the value proposition
|
||||
|
||||
```markdown
|
||||
## The Process
|
||||
|
||||
**Understanding the idea:**
|
||||
- Check out the current project state first
|
||||
- Ask questions one at a time
|
||||
```
|
||||
|
||||
**Analysis:**
|
||||
- ✅ Broken into clear phases
|
||||
- ✅ Specific, actionable steps
|
||||
- ✅ Easy to follow
|
||||
|
||||
---
|
||||
|
||||
## Advanced Patterns
|
||||
|
||||
### Conditional Logic
|
||||
|
||||
```markdown
|
||||
## Instructions
|
||||
|
||||
If the user is working with React:
|
||||
- Use functional components
|
||||
- Prefer hooks over class components
|
||||
|
||||
If the user is working with Vue:
|
||||
- Use Composition API
|
||||
- Follow Vue 3 patterns
|
||||
```
|
||||
|
||||
### Progressive Disclosure
|
||||
|
||||
```markdown
|
||||
## Basic Usage
|
||||
[Simple instructions for common cases]
|
||||
|
||||
## Advanced Usage
|
||||
[Complex patterns for power users]
|
||||
```
|
||||
|
||||
### Cross-References
|
||||
|
||||
```markdown
|
||||
## Related Workflows
|
||||
|
||||
1. First, use `@brainstorming` to design
|
||||
2. Then, use `@writing-plans` to plan
|
||||
3. Finally, use `@test-driven-development` to implement
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Skill Effectiveness Metrics
|
||||
|
||||
How to know if your skill is good:
|
||||
|
||||
### Clarity Test
|
||||
- Can someone unfamiliar with the topic follow it?
|
||||
- Are there any ambiguous instructions?
|
||||
|
||||
### Completeness Test
|
||||
- Does it cover the happy path?
|
||||
- Does it handle edge cases?
|
||||
- Are error scenarios addressed?
|
||||
|
||||
### Usefulness Test
|
||||
- Does it solve a real problem?
|
||||
- Would you use this yourself?
|
||||
- Does it save time or improve quality?
|
||||
|
||||
---
|
||||
|
||||
## Learning from Existing Skills
|
||||
|
||||
### Study These Examples
|
||||
|
||||
**For Beginners:**
|
||||
- `skills/brainstorming/SKILL.md` - Clear structure
|
||||
- `skills/git-pushing/SKILL.md` - Simple and focused
|
||||
- `skills/copywriting/SKILL.md` - Good examples
|
||||
|
||||
**For Advanced:**
|
||||
- `skills/systematic-debugging/SKILL.md` - Comprehensive
|
||||
- `skills/react-best-practices/SKILL.md` - Multiple files
|
||||
- `skills/loki-mode/SKILL.md` - Complex workflows
|
||||
|
||||
---
|
||||
|
||||
## 💡 Pro Tips
|
||||
|
||||
1. **Start with the "When to Use" section** - This clarifies the skill's purpose
|
||||
2. **Write examples first** - They help you understand what you're teaching
|
||||
3. **Test with an AI** - See if it actually works before submitting
|
||||
4. **Get feedback** - Ask others to review your skill
|
||||
5. **Iterate** - Skills improve over time based on usage
|
||||
|
||||
---
|
||||
|
||||
## Common Mistakes to Avoid
|
||||
|
||||
### ❌ Mistake 1: Too Vague
|
||||
```markdown
|
||||
## Instructions
|
||||
Make the code better.
|
||||
```
|
||||
|
||||
**✅ Fix:**
|
||||
```markdown
|
||||
## Instructions
|
||||
1. Extract repeated logic into functions
|
||||
2. Add error handling for edge cases
|
||||
3. Write unit tests for core functionality
|
||||
```
|
||||
|
||||
### ❌ Mistake 2: Too Complex
|
||||
```markdown
|
||||
## Instructions
|
||||
[5000 words of dense technical jargon]
|
||||
```
|
||||
|
||||
**✅ Fix:**
|
||||
Break into multiple skills or use progressive disclosure
|
||||
|
||||
### ❌ Mistake 3: No Examples
|
||||
```markdown
|
||||
## Instructions
|
||||
[Instructions without any code examples]
|
||||
```
|
||||
|
||||
**✅ Fix:**
|
||||
Add at least 2-3 realistic examples
|
||||
|
||||
### ❌ Mistake 4: Outdated Information
|
||||
```markdown
|
||||
Use React class components...
|
||||
```
|
||||
|
||||
**✅ Fix:**
|
||||
Keep skills updated with current best practices
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Next Steps
|
||||
|
||||
1. **Read 3-5 existing skills** to see different styles
|
||||
2. **Try the skill template** from [`../../CONTRIBUTING.md`](../../CONTRIBUTING.md)
|
||||
3. **Create a simple skill** for something you know well
|
||||
4. **Test it** with your AI assistant
|
||||
5. **Share it** via Pull Request
|
||||
|
||||
---
|
||||
|
||||
**Remember:** Every expert was once a beginner. Start simple, learn from feedback, and improve over time! 🚀
|
||||
65
docs/contributors/skill-template.md
Normal file
65
docs/contributors/skill-template.md
Normal file
@@ -0,0 +1,65 @@
|
||||
---
|
||||
name: your-skill-name
|
||||
description: "Brief one-sentence description of what this skill does (under 200 characters)"
|
||||
category: your-category
|
||||
risk: safe
|
||||
source: community
|
||||
date_added: "YYYY-MM-DD"
|
||||
author: your-name-or-handle
|
||||
tags: [tag-one, tag-two]
|
||||
tools: [claude, cursor, gemini]
|
||||
---
|
||||
|
||||
# Skill Title
|
||||
|
||||
## Overview
|
||||
|
||||
A brief explanation of what this skill does and why it exists.
|
||||
2-4 sentences is perfect.
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
- Use when you need to [scenario 1]
|
||||
- Use when working with [scenario 2]
|
||||
- Use when the user asks about [scenario 3]
|
||||
|
||||
## How It Works
|
||||
|
||||
### Step 1: [Action]
|
||||
|
||||
Detailed instructions...
|
||||
|
||||
### Step 2: [Action]
|
||||
|
||||
More instructions...
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1: [Use Case]
|
||||
|
||||
\`\`\`javascript
|
||||
// Example code
|
||||
\`\`\`
|
||||
|
||||
### Example 2: [Another Use Case]
|
||||
|
||||
\`\`\`javascript
|
||||
// More code
|
||||
\`\`\`
|
||||
|
||||
## Best Practices
|
||||
|
||||
- ✅ Do this
|
||||
- ✅ Also do this
|
||||
- ❌ Don't do this
|
||||
- ❌ Avoid this
|
||||
|
||||
## Common Pitfalls
|
||||
|
||||
- **Problem:** Description
|
||||
**Solution:** How to fix it
|
||||
|
||||
## Related Skills
|
||||
|
||||
- `@other-skill` - When to use this instead
|
||||
- `@complementary-skill` - How this works together
|
||||
68
docs/maintainers/audit.md
Normal file
68
docs/maintainers/audit.md
Normal file
@@ -0,0 +1,68 @@
|
||||
# Repo coherence and correctness audit
|
||||
|
||||
This document summarizes the repository coherence audit performed after the `apps/` + `tools/` + layered `docs/` refactor.
|
||||
|
||||
## Scope
|
||||
|
||||
- Conteggi e numeri (README, package.json, CATALOG)
|
||||
- Validazione skill (frontmatter, risk, "When to Use", link)
|
||||
- Riferimenti incrociati (workflows.json, bundles.json, `docs/users/bundles.md`)
|
||||
- Documentazione (`docs/contributors/quality-bar.md`, `docs/contributors/skill-anatomy.md`, security/licenses)
|
||||
- Script e build (validate, index, readme, catalog, test)
|
||||
- Note su data/ e test YAML
|
||||
|
||||
## Outcomes
|
||||
|
||||
### 1. Conteggi
|
||||
|
||||
- `README.md`, `package.json`, and generated artifacts are aligned to the current collection size (`1,204+` skills).
|
||||
- `npm run sync:all` and `npm run catalog` are the canonical commands for keeping counts and generated files synchronized.
|
||||
|
||||
### 2. Validazione skill
|
||||
|
||||
- `npm run validate` is the operational contributor gate.
|
||||
- `npm run validate:strict` is currently a diagnostic hardening pass: it still surfaces repository-wide legacy metadata/content gaps across many older skills.
|
||||
- The validator accepts `risk: unknown` for legacy/unclassified skills while still preferring concrete risk values for new skills.
|
||||
|
||||
### 3. Riferimenti incrociati
|
||||
|
||||
- Added `tools/scripts/validate_references.py` (also exposed as `npm run validate:references`), which verifies:
|
||||
- ogni `recommendedSkills` in data/workflows.json esiste in skills/;
|
||||
- ogni `relatedBundles` esiste in data/bundles.json;
|
||||
- ogni slug in data/bundles.json (skills list) esiste in skills/;
|
||||
- every skill link in `docs/users/bundles.md` points to an existing skill.
|
||||
- Execution: `npm run validate:references`. Result: all references valid.
|
||||
|
||||
### 4. Documentazione
|
||||
|
||||
- Canonical contributor docs now live under `docs/contributors/`.
|
||||
- Canonical maintainer docs now live under `docs/maintainers/`.
|
||||
- README, security docs, licenses, and internal markdown links were rechecked after the refactor.
|
||||
|
||||
### 5. Script e build
|
||||
|
||||
- `npm run test` and `npm run app:build` complete successfully on the refactored layout.
|
||||
- `validate_skills_headings.test.js` acts as a lightweight regression/smoke test, not as the source of truth for full metadata compliance.
|
||||
- The maintainer docs now need to stay aligned with the root `package.json` and the refactored `tools/scripts/*` paths.
|
||||
|
||||
### 6. Deliverable
|
||||
|
||||
- Counts aligned to the current generated registry.
|
||||
- Reference validation wired to the refactored paths.
|
||||
- User and maintainer docs checked for path drift after the layout change.
|
||||
- Follow-up still open: repository-wide cleanup required to make `validate:strict` fully green.
|
||||
|
||||
## Comandi utili
|
||||
|
||||
```bash
|
||||
npm run validate # validazione skill (soft)
|
||||
npm run validate:strict # hardening / diagnostic pass
|
||||
npm run validate:references # workflow, bundle, and docs/users/bundles.md references
|
||||
npm run build # chain + catalog
|
||||
npm test # suite test
|
||||
```
|
||||
|
||||
## Issue aperte / follow-up
|
||||
|
||||
- Gradual cleanup of legacy skills so `npm run validate:strict` can become a hard CI gate in the future.
|
||||
- Keep translated docs aligned in a separate pass after the canonical English docs are stable.
|
||||
170
docs/maintainers/categorization-implementation.md
Normal file
170
docs/maintainers/categorization-implementation.md
Normal file
@@ -0,0 +1,170 @@
|
||||
# Smart Categorization Implementation - Complete Summary
|
||||
|
||||
## ✅ What Was Done
|
||||
|
||||
### 1. **Intelligent Auto-Categorization Script**
|
||||
Created [`tools/scripts/auto_categorize_skills.py`](../../tools/scripts/auto_categorize_skills.py) that:
|
||||
- Analyzes skill names and descriptions
|
||||
- Matches against keyword libraries for 13 categories
|
||||
- Automatically assigns meaningful categories
|
||||
- Removes "uncategorized" bulk assignment
|
||||
|
||||
**Results:**
|
||||
- ✅ 776 skills auto-categorized
|
||||
- ✅ 46 already had categories preserved
|
||||
- ✅ 124 remaining uncategorized (edge cases)
|
||||
|
||||
### 2. **Category Distribution**
|
||||
|
||||
**Before:**
|
||||
```
|
||||
uncategorized: 926 (98%)
|
||||
game-development: 10
|
||||
libreoffice: 5
|
||||
security: 4
|
||||
```
|
||||
|
||||
**After:**
|
||||
```
|
||||
Backend: 164 ████████████████
|
||||
Web Dev: 107 ███████████
|
||||
Automation: 103 ███████████
|
||||
DevOps: 83 ████████
|
||||
AI/ML: 79 ████████
|
||||
Content: 47 █████
|
||||
Database: 44 █████
|
||||
Testing: 38 ████
|
||||
Security: 36 ████
|
||||
Cloud: 33 ███
|
||||
Mobile: 21 ██
|
||||
Game Dev: 15 ██
|
||||
Data Science: 14 ██
|
||||
Uncategorized: 126 █
|
||||
```
|
||||
|
||||
### 3. **Updated Index Generation**
|
||||
Modified [`tools/scripts/generate_index.py`](../../tools/scripts/generate_index.py):
|
||||
- **Frontmatter categories now take priority**
|
||||
- Falls back to folder structure if needed
|
||||
- Generates clean, organized skills_index.json
|
||||
- Exported to apps/web-app/public/skills.json
|
||||
|
||||
### 4. **Improved Web App Filter**
|
||||
|
||||
**Home Page Changes:**
|
||||
- ✅ Categories sorted by skill count (most first)
|
||||
- ✅ "Uncategorized" moved to bottom
|
||||
- ✅ Each shows count: "Backend (164)", "Web Dev (107)"
|
||||
- ✅ Much easier to navigate
|
||||
|
||||
**Updated Code:**
|
||||
- [`apps/web-app/src/pages/Home.tsx`](../../apps/web-app/src/pages/Home.tsx) - Smart category sorting
|
||||
- Sorts categories by count using categoryStats
|
||||
- Uncategorized always last
|
||||
- Displays count in dropdown
|
||||
|
||||
### 5. **Categorization Keywords** (13 Categories)
|
||||
|
||||
| Category | Key Keywords |
|
||||
|----------|--------------|
|
||||
| **Backend** | nodejs, express, fastapi, django, server, api, database |
|
||||
| **Web Dev** | react, vue, angular, frontend, css, html, tailwind |
|
||||
| **Automation** | workflow, scripting, automation, robot, trigger |
|
||||
| **DevOps** | docker, kubernetes, ci/cd, deploy, container |
|
||||
| **AI/ML** | ai, machine learning, tensorflow, nlp, gpt, llm |
|
||||
| **Content** | markdown, documentation, content, writing |
|
||||
| **Database** | sql, postgres, mongodb, redis, orm |
|
||||
| **Testing** | test, jest, pytest, cypress, unit test |
|
||||
| **Security** | encryption, auth, oauth, jwt, vulnerability |
|
||||
| **Cloud** | aws, azure, gcp, serverless, lambda |
|
||||
| **Mobile** | react native, flutter, ios, android, swift |
|
||||
| **Game Dev** | game, unity, webgl, threejs, 3d, physics |
|
||||
| **Data Science** | pandas, numpy, analytics, statistics |
|
||||
|
||||
### 6. **Documentation**
|
||||
Created [`smart-auto-categorization.md`](smart-auto-categorization.md) with:
|
||||
- How the system works
|
||||
- Using the script (`--dry-run` and apply modes)
|
||||
- Category reference
|
||||
- Customization guide
|
||||
- Troubleshooting
|
||||
|
||||
## 🎯 The Result
|
||||
|
||||
### No More Uncategorized Chaos
|
||||
- **Before**: the vast majority of skills were lumped into "uncategorized"
|
||||
- **After**: most skills are organized into meaningful buckets, with a much smaller review queue remaining
|
||||
|
||||
### Better UX
|
||||
1. **Smarter Filtering**: Categories sorted by relevance
|
||||
2. **Visual Cues**: Shows count "(164 skills)""
|
||||
3. **Uncategorized Last**: Put bad options out of sight
|
||||
4. **Meaningful Groups**: Find skills by actual function
|
||||
|
||||
### Example Workflow
|
||||
User wants to find database skills:
|
||||
1. Opens web app
|
||||
2. Sees filter dropdown: "Backend (164) | Database (44) | Web Dev (107)..."
|
||||
3. Clicks "Database (44)"
|
||||
4. Gets 44 relevant SQL/MongoDB/Postgres skills
|
||||
5. Done! 🎉
|
||||
|
||||
## 🚀 Usage
|
||||
|
||||
### Run Auto-Categorization
|
||||
```bash
|
||||
# Test first
|
||||
python tools/scripts/auto_categorize_skills.py --dry-run
|
||||
|
||||
# Apply changes
|
||||
python tools/scripts/auto_categorize_skills.py
|
||||
|
||||
# Regenerate index
|
||||
python tools/scripts/generate_index.py
|
||||
|
||||
# Deploy to web app
|
||||
cp skills_index.json apps/web-app/public/skills.json
|
||||
```
|
||||
|
||||
### For New Skills
|
||||
Add to frontmatter:
|
||||
```yaml
|
||||
---
|
||||
name: my-skill
|
||||
description: "..."
|
||||
category: backend
|
||||
date_added: "2026-03-06"
|
||||
---
|
||||
```
|
||||
|
||||
## 📁 Files Changed
|
||||
|
||||
### New Files
|
||||
- `tools/scripts/auto_categorize_skills.py` - Auto-categorization engine
|
||||
- `docs/maintainers/smart-auto-categorization.md` - Full documentation
|
||||
|
||||
### Modified Files
|
||||
- `tools/scripts/generate_index.py` - Category priority logic
|
||||
- `apps/web-app/src/pages/Home.tsx` - Smart category sorting
|
||||
- `apps/web-app/public/skills.json` - Regenerated with categories
|
||||
|
||||
## 📊 Quality Metrics
|
||||
|
||||
- **Coverage**: 87% of skills in meaningful categories
|
||||
- **Accuracy**: Keyword-based matching with word boundaries
|
||||
- **Performance**: fast enough to categorize the full repository in a single local pass
|
||||
- **Maintainability**: Easily add keywords/categories for future growth
|
||||
|
||||
## 🎁 Bonus Features
|
||||
|
||||
1. **Dry-run mode**: See changes before applying
|
||||
2. **Weighted scoring**: Exact matches score 2x partial matches
|
||||
3. **Customizable keywords**: Easy to add more categories
|
||||
4. **Fallback logic**: folder → frontmatter → uncategorized
|
||||
5. **UTF-8 support**: Works on Windows/Mac/Linux
|
||||
|
||||
---
|
||||
|
||||
**Status**: ✅ Complete and deployed to web app!
|
||||
|
||||
The web app now has a clean, intelligent category filter instead of "uncategorized" chaos. 🚀
|
||||
38
docs/maintainers/ci-drift-fix.md
Normal file
38
docs/maintainers/ci-drift-fix.md
Normal file
@@ -0,0 +1,38 @@
|
||||
# CI Drift Fix Guide
|
||||
|
||||
**Problem**: The failing job is caused by uncommitted changes detected in `README.md`, `skills_index.json`, or catalog files after the update scripts run.
|
||||
|
||||
**Error**:
|
||||
|
||||
```
|
||||
❌ Detected uncommitted changes produced by registry/readme/catalog scripts.
|
||||
```
|
||||
|
||||
**Cause**:
|
||||
Scripts like `tools/scripts/generate_index.py`, `tools/scripts/update_readme.py`, and `tools/scripts/build-catalog.js` modify `README.md`, `skills_index.json`, `data/catalog.json`, `data/bundles.json`, `data/aliases.json`, and `CATALOG.md`. The workflow expects these files to have no changes after the scripts run. Any differences mean the committed repo is out-of-sync with what the generation scripts produce.
|
||||
|
||||
**How to Fix (DO THIS EVERY TIME):**
|
||||
|
||||
1. Run the **FULL Validation Chain** locally:
|
||||
|
||||
```bash
|
||||
npm run chain
|
||||
npm run catalog
|
||||
```
|
||||
|
||||
2. Check for changes:
|
||||
|
||||
```bash
|
||||
git status
|
||||
git diff
|
||||
```
|
||||
|
||||
3. Commit and push any updates:
|
||||
```bash
|
||||
git add README.md skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md
|
||||
git commit -m "chore: sync generated registry files"
|
||||
git push
|
||||
```
|
||||
|
||||
**Summary**:
|
||||
Always commit and push all changes produced by the registry, README sync, and catalog scripts. This keeps CI passing by ensuring the repository and generated artifacts stay in sync with the canonical `tools/scripts/*` pipeline.
|
||||
66
docs/maintainers/date-tracking-implementation.md
Normal file
66
docs/maintainers/date-tracking-implementation.md
Normal file
@@ -0,0 +1,66 @@
|
||||
# Date Tracking Implementation Summary
|
||||
|
||||
This note explains how `date_added` support fits into the current repository structure after the `apps/` and `tools/` refactor.
|
||||
|
||||
## What Exists Today
|
||||
|
||||
### Frontmatter support
|
||||
|
||||
New skills can include a `date_added` field in `SKILL.md` frontmatter:
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: skill-name
|
||||
description: "Description"
|
||||
date_added: "2026-03-06"
|
||||
---
|
||||
```
|
||||
|
||||
### Validator support
|
||||
|
||||
The active validators understand `date_added`:
|
||||
|
||||
- `tools/scripts/validate_skills.py` checks the `YYYY-MM-DD` format.
|
||||
- Supporting JS validation/test helpers are aware of the field where relevant.
|
||||
|
||||
### Index and web app support
|
||||
|
||||
- `tools/scripts/generate_index.py` exports `date_added` into `skills_index.json`.
|
||||
- `npm run app:setup` copies the generated index to `apps/web-app/public/skills.json`.
|
||||
- The web app can render the field anywhere the UI surfaces it.
|
||||
|
||||
### Maintenance scripts
|
||||
|
||||
- `tools/scripts/manage_skill_dates.py` manages skill dates.
|
||||
- `tools/scripts/generate_skills_report.py` produces JSON reports from current skill metadata.
|
||||
|
||||
## Canonical Documentation
|
||||
|
||||
The canonical docs for date tracking now live here:
|
||||
|
||||
- [`skills-date-tracking.md`](skills-date-tracking.md)
|
||||
- [`../contributors/skill-template.md`](../contributors/skill-template.md)
|
||||
- [`../contributors/skill-anatomy.md`](../contributors/skill-anatomy.md)
|
||||
|
||||
Use those files as the source of truth instead of older root-level doc names.
|
||||
|
||||
## Common Commands
|
||||
|
||||
```bash
|
||||
# View current date coverage
|
||||
python tools/scripts/manage_skill_dates.py list
|
||||
|
||||
# Add missing dates
|
||||
python tools/scripts/manage_skill_dates.py add-missing
|
||||
|
||||
# Update one skill
|
||||
python tools/scripts/manage_skill_dates.py update skill-name 2026-03-06
|
||||
|
||||
# Generate a report
|
||||
python tools/scripts/generate_skills_report.py --output reports/skills_report.json
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- Repository-wide coverage can change over time as new community skills are added, so this document avoids hardcoding counts.
|
||||
- `date_added` is useful metadata, but the operational contributor gate remains `npm run validate`; strict validation is a separate hardening target for legacy cleanup.
|
||||
62
docs/maintainers/release-process.md
Normal file
62
docs/maintainers/release-process.md
Normal file
@@ -0,0 +1,62 @@
|
||||
# Release Process
|
||||
|
||||
This is the maintainer playbook for cutting a repository release. Historical release notes belong in [`CHANGELOG.md`](../../CHANGELOG.md); this file documents the repeatable process.
|
||||
|
||||
## Preconditions
|
||||
|
||||
- The working tree is clean, or you have explicitly isolated the release changes.
|
||||
- `package.json` contains the version you intend to publish.
|
||||
- Generated registry files are synchronized.
|
||||
- README counts, badges, and acknowledgements are up to date.
|
||||
|
||||
## Release Checklist
|
||||
|
||||
1. Run the operational verification suite:
|
||||
|
||||
```bash
|
||||
npm run validate
|
||||
npm run validate:references
|
||||
npm run sync:all
|
||||
npm run test
|
||||
npm run app:build
|
||||
```
|
||||
|
||||
2. Optional hardening pass:
|
||||
|
||||
```bash
|
||||
npm run validate:strict
|
||||
```
|
||||
|
||||
Use this as a diagnostic signal. It is useful for spotting legacy quality debt, but it is not yet the release blocker for the whole repository.
|
||||
|
||||
3. Update release-facing docs:
|
||||
|
||||
- Add the release entry to [`CHANGELOG.md`](../../CHANGELOG.md).
|
||||
- Confirm `README.md` reflects the current version and generated counts.
|
||||
- Confirm Credits & Sources, contributors, and support links are still correct.
|
||||
|
||||
4. Create the release commit and tag:
|
||||
|
||||
```bash
|
||||
git add README.md CHANGELOG.md CATALOG.md data/ skills_index.json package.json package-lock.json
|
||||
git commit -m "chore: release vX.Y.Z"
|
||||
git tag vX.Y.Z
|
||||
```
|
||||
|
||||
5. Publish the GitHub release:
|
||||
|
||||
```bash
|
||||
gh release create vX.Y.Z --title "vX.Y.Z" --notes-file CHANGELOG.md
|
||||
```
|
||||
|
||||
6. Publish to npm if needed:
|
||||
|
||||
```bash
|
||||
npm publish
|
||||
```
|
||||
|
||||
## Rollback Notes
|
||||
|
||||
- If the release tag is wrong, delete the tag locally and remotely before republishing.
|
||||
- If generated files drift after tagging, cut a follow-up patch release instead of mutating a published tag.
|
||||
- If npm publish fails after tagging, fix the issue, bump the version, and publish a new release instead of reusing the same version.
|
||||
43
docs/maintainers/rollback-procedure.md
Normal file
43
docs/maintainers/rollback-procedure.md
Normal file
@@ -0,0 +1,43 @@
|
||||
# Rollback Procedure
|
||||
|
||||
Use this when a structural refactor, generated artifact refresh, or release prep needs to be backed out safely.
|
||||
|
||||
## Before Rolling Back
|
||||
|
||||
- Capture the current branch name with `git branch --show-current`.
|
||||
- Review changed files with `git status --short`.
|
||||
- Decide whether you need to keep any generated files before reverting.
|
||||
|
||||
## Safe Rollback Flow
|
||||
|
||||
1. Create a temporary safety branch:
|
||||
|
||||
```bash
|
||||
git switch -c rollback-safety-check
|
||||
```
|
||||
|
||||
2. Verify the repository still reports the expected changed files:
|
||||
|
||||
```bash
|
||||
git status --short
|
||||
```
|
||||
|
||||
3. Switch back to the original branch:
|
||||
|
||||
```bash
|
||||
git switch -
|
||||
```
|
||||
|
||||
4. If you need to discard only this refactor later, revert the relevant commit(s) or restore specific files explicitly:
|
||||
|
||||
```bash
|
||||
git restore README.md CONTRIBUTING.md package.json package-lock.json
|
||||
git restore --staged README.md CONTRIBUTING.md package.json package-lock.json
|
||||
```
|
||||
|
||||
5. If the refactor has already been committed, prefer `git revert <commit>` over history-rewriting commands.
|
||||
|
||||
## Notes
|
||||
|
||||
- Avoid `git reset --hard` unless you have explicit approval and understand the impact on unrelated work.
|
||||
- For generated artifacts, regenerate after rollback with the standard scripts instead of manually editing them.
|
||||
228
docs/maintainers/skills-date-tracking.md
Normal file
228
docs/maintainers/skills-date-tracking.md
Normal file
@@ -0,0 +1,228 @@
|
||||
# Skills Date Tracking Guide
|
||||
|
||||
This guide explains how to use the new `date_added` feature for tracking when skills were created or added to the collection.
|
||||
|
||||
## Overview
|
||||
|
||||
The `date_added` field in skill frontmatter allows you to track when each skill was created. This is useful for:
|
||||
|
||||
- **Versioning**: Understanding skill age and maturity
|
||||
- **Changelog generation**: Tracking new skills over time
|
||||
- **Reporting**: Analyzing skill collection growth
|
||||
- **Organization**: Grouping skills by creation date
|
||||
|
||||
## Format
|
||||
|
||||
The `date_added` field uses ISO 8601 date format: **YYYY-MM-DD**
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: my-skill-name
|
||||
description: "Brief description"
|
||||
date_added: "2024-01-15"
|
||||
---
|
||||
```
|
||||
|
||||
## Quick Start
|
||||
|
||||
### 1. View All Skills with Their Dates
|
||||
|
||||
```bash
|
||||
python tools/scripts/manage_skill_dates.py list
|
||||
```
|
||||
|
||||
Output example:
|
||||
```
|
||||
📅 Skills with Date Added (example):
|
||||
============================================================
|
||||
2025-02-26 │ recent-skill
|
||||
2025-02-20 │ another-new-skill
|
||||
2024-12-15 │ older-skill
|
||||
...
|
||||
|
||||
⏳ Skills without Date Added (example):
|
||||
============================================================
|
||||
some-legacy-skill
|
||||
undated-skill
|
||||
...
|
||||
|
||||
📊 Coverage: example output only
|
||||
```
|
||||
|
||||
### 2. Add Missing Dates
|
||||
|
||||
Add today's date to all skills that don't have a `date_added` field:
|
||||
|
||||
```bash
|
||||
python tools/scripts/manage_skill_dates.py add-missing
|
||||
```
|
||||
|
||||
Or specify a custom date:
|
||||
|
||||
```bash
|
||||
python tools/scripts/manage_skill_dates.py add-missing --date 2026-03-06
|
||||
```
|
||||
|
||||
### 3. Add/Update All Skills
|
||||
|
||||
Set a date for all skills at once:
|
||||
|
||||
```bash
|
||||
python tools/scripts/manage_skill_dates.py add-all --date 2026-03-06
|
||||
```
|
||||
|
||||
### 4. Update a Single Skill
|
||||
|
||||
Update a specific skill's date:
|
||||
|
||||
```bash
|
||||
python tools/scripts/manage_skill_dates.py update my-skill-name 2026-03-06
|
||||
```
|
||||
|
||||
### 5. Generate a Report
|
||||
|
||||
Generate a JSON report of all skills with their metadata:
|
||||
|
||||
```bash
|
||||
python tools/scripts/generate_skills_report.py
|
||||
```
|
||||
|
||||
Save to file:
|
||||
|
||||
```bash
|
||||
python tools/scripts/generate_skills_report.py --output skills_report.json
|
||||
```
|
||||
|
||||
Sort by name:
|
||||
|
||||
```bash
|
||||
python tools/scripts/generate_skills_report.py --sort name --output sorted_skills.json
|
||||
```
|
||||
|
||||
## Usage in Your Workflow
|
||||
|
||||
### When Creating a New Skill
|
||||
|
||||
Add the `date_added` field to your SKILL.md frontmatter:
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: new-awesome-skill
|
||||
description: "Does something awesome"
|
||||
date_added: "2026-03-06"
|
||||
---
|
||||
```
|
||||
|
||||
### Automated Addition
|
||||
|
||||
When onboarding many skills, use:
|
||||
|
||||
```bash
|
||||
python tools/scripts/manage_skill_dates.py add-missing --date 2026-03-06
|
||||
```
|
||||
|
||||
This adds today's date to all skills that are missing the field.
|
||||
|
||||
### Validation
|
||||
|
||||
The validators now check `date_added` format:
|
||||
|
||||
```bash
|
||||
# Run the operational validator
|
||||
npm run validate
|
||||
|
||||
# Optional hardening pass
|
||||
npm run validate:strict
|
||||
|
||||
# Reference validation
|
||||
npm run validate:references
|
||||
|
||||
# Run smoke tests
|
||||
npm test
|
||||
```
|
||||
|
||||
These checks catch invalid dates, broken references, and related regressions.
|
||||
|
||||
## Generated Reports
|
||||
|
||||
The `generate_skills_report.py` script produces a JSON report with statistics:
|
||||
|
||||
```json
|
||||
{
|
||||
"generated_at": "2026-03-06T10:30:00.123456",
|
||||
"total_skills": 1234,
|
||||
"skills_with_dates": 1200,
|
||||
"skills_without_dates": 34,
|
||||
"coverage_percentage": 97.2,
|
||||
"sorted_by": "date",
|
||||
"skills": [
|
||||
{
|
||||
"id": "recent-skill",
|
||||
"name": "recent-skill",
|
||||
"description": "A newly added skill",
|
||||
"date_added": "2026-03-06",
|
||||
"source": "community",
|
||||
"risk": "safe",
|
||||
"category": "recent"
|
||||
},
|
||||
...
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Use this for:
|
||||
- Dashboard displays
|
||||
- Growth metrics
|
||||
- Automated reports
|
||||
- Analytics
|
||||
|
||||
## Integration with CI/CD
|
||||
|
||||
Add to your pipeline:
|
||||
|
||||
```bash
|
||||
# In pre-commit or CI pipeline
|
||||
npm run validate
|
||||
npm run validate:references
|
||||
|
||||
# Generate stats report
|
||||
python tools/scripts/generate_skills_report.py --output reports/skills_report.json
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Use consistent format**: Always use `YYYY-MM-DD`
|
||||
2. **Use real dates**: Reflect actual skill creation dates when possible
|
||||
3. **Update on creation**: Add the date when creating new skills
|
||||
4. **Validate regularly**: Run validators to catch format errors
|
||||
5. **Review reports**: Use generated reports to understand collection trends
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Invalid date_added format"
|
||||
|
||||
Make sure the date is in `YYYY-MM-DD` format:
|
||||
- ✅ Correct: `2024-01-15`
|
||||
- ❌ Wrong: `01/15/2024` or `2024-1-15`
|
||||
|
||||
### Script not found
|
||||
|
||||
Make sure you're running from the project root:
|
||||
```bash
|
||||
cd path/to/antigravity-awesome-skills
|
||||
python tools/scripts/manage_skill_dates.py list
|
||||
```
|
||||
|
||||
### Python not found
|
||||
|
||||
Install Python 3.x from [python.org](https://python.org/)
|
||||
|
||||
## Related Documentation
|
||||
|
||||
- [`../contributors/skill-anatomy.md`](../contributors/skill-anatomy.md) - Complete skill structure guide
|
||||
- [`skills-update-guide.md`](skills-update-guide.md) - How to update the skill collection
|
||||
- [`../contributors/examples.md`](../contributors/examples.md) - Example skills
|
||||
|
||||
## Questions or Issues?
|
||||
|
||||
See [CONTRIBUTING.md](../../CONTRIBUTING.md) for contribution guidelines.
|
||||
89
docs/maintainers/skills-update-guide.md
Normal file
89
docs/maintainers/skills-update-guide.md
Normal file
@@ -0,0 +1,89 @@
|
||||
# Skills Update Guide
|
||||
|
||||
This guide explains how to update the skills in the Antigravity Awesome Skills web application.
|
||||
|
||||
## Automatic Updates (Recommended)
|
||||
|
||||
The `START_APP.bat` file automatically checks for and updates skills when you run it. It uses multiple methods:
|
||||
|
||||
1. **Git method** (if Git is installed): Fast and efficient
|
||||
2. **PowerShell download** (fallback): Works without Git
|
||||
|
||||
## Manual Update Options
|
||||
|
||||
### Option 1: Using npm script (Recommended for manual updates)
|
||||
```bash
|
||||
npm run update:skills
|
||||
```
|
||||
|
||||
This command:
|
||||
- Generates the latest skills index from the skills directory
|
||||
- Copies it to the web app's public directory
|
||||
- Requires Python and PyYAML to be installed
|
||||
|
||||
### Option 2: Using START_APP.bat (Integrated solution)
|
||||
```bash
|
||||
START_APP.bat
|
||||
```
|
||||
|
||||
The START_APP.bat file includes integrated update functionality that:
|
||||
- Automatically checks for updates on startup
|
||||
- Uses Git if available (fast method)
|
||||
- Falls back to HTTPS download if Git is not installed
|
||||
- Handles all dependencies automatically
|
||||
- Provides clear status messages
|
||||
- Works without any additional setup
|
||||
|
||||
### Option 3: Manual steps
|
||||
```bash
|
||||
# 1. Generate skills index
|
||||
python tools/scripts/generate_index.py
|
||||
|
||||
# 2. Copy to web app
|
||||
copy skills_index.json apps\web-app\public\skills.json
|
||||
```
|
||||
|
||||
## Prerequisites
|
||||
|
||||
For manual updates, you need:
|
||||
|
||||
- **Python 3.x**: Download from [python.org](https://python.org/)
|
||||
- **PyYAML**: Install with `pip install PyYAML`
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Python is not recognized"
|
||||
- Install Python from [python.org](https://python.org/)
|
||||
- Make sure to check "Add Python to PATH" during installation
|
||||
|
||||
### "PyYAML not found"
|
||||
- Install with: `pip install PyYAML`
|
||||
- Or run the update script which will install it automatically
|
||||
|
||||
### "Failed to copy skills"
|
||||
- Make sure the `apps\web-app\public\` directory exists
|
||||
- Check file permissions
|
||||
|
||||
## What Gets Updated
|
||||
|
||||
The update process refreshes:
|
||||
- Skills index (`skills_index.json`)
|
||||
- Web app skills data (`apps\web-app\public\skills.json`)
|
||||
- All 1,204+ skills from the skills directory
|
||||
|
||||
## When to Update
|
||||
|
||||
Update skills when:
|
||||
- New skills are added to the repository
|
||||
- You want the latest skill descriptions
|
||||
- Skills appear missing or outdated in the web app
|
||||
|
||||
## Git Users
|
||||
|
||||
If you have Git installed and want to update the entire repository:
|
||||
```bash
|
||||
git pull origin main
|
||||
npm run update:skills
|
||||
```
|
||||
|
||||
This pulls the latest code and updates the skills data.
|
||||
219
docs/maintainers/smart-auto-categorization.md
Normal file
219
docs/maintainers/smart-auto-categorization.md
Normal file
@@ -0,0 +1,219 @@
|
||||
# Smart Auto-Categorization Guide
|
||||
|
||||
## Overview
|
||||
|
||||
The skill collection now uses intelligent auto-categorization to eliminate "uncategorized" and organize skills into meaningful categories based on their content.
|
||||
|
||||
## Current Status
|
||||
|
||||
✅ Current repository indexed through the generated catalog
|
||||
- Most skills are in meaningful categories
|
||||
- A smaller tail still needs manual review or better keyword coverage
|
||||
- 11 primary categories
|
||||
- Categories sorted by skill count (most first)
|
||||
|
||||
## Category Distribution
|
||||
|
||||
| Category | Count | Examples |
|
||||
|----------|-------|----------|
|
||||
| Backend | 164 | Node.js, Django, Express, FastAPI |
|
||||
| Web Development | 107 | React, Vue, Tailwind, CSS |
|
||||
| Automation | 103 | Workflow, Scripting, RPA |
|
||||
| DevOps | 83 | Docker, Kubernetes, CI/CD, Git |
|
||||
| AI/ML | 79 | TensorFlow, PyTorch, NLP, LLM |
|
||||
| Content | 47 | Documentation, SEO, Writing |
|
||||
| Database | 44 | SQL, MongoDB, PostgreSQL |
|
||||
| Testing | 38 | Jest, Cypress, Unit Testing |
|
||||
| Security | 36 | Encryption, Authentication |
|
||||
| Cloud | 33 | AWS, Azure, GCP |
|
||||
| Mobile | 21 | React Native, Flutter, iOS |
|
||||
| Game Dev | 15 | Unity, WebGL, 3D |
|
||||
| Data Science | 14 | Pandas, NumPy, Analytics |
|
||||
|
||||
## How It Works
|
||||
|
||||
### 1. **Keyword-Based Analysis**
|
||||
The system analyzes skill names and descriptions for keywords:
|
||||
- **Backend**: nodejs, express, fastapi, django, server, api, database
|
||||
- **Web Dev**: react, vue, angular, frontend, css, html, tailwind
|
||||
- **AI/ML**: ai, machine learning, tensorflow, nlp, gpt
|
||||
- **DevOps**: docker, kubernetes, ci/cd, deploy
|
||||
- And more...
|
||||
|
||||
### 2. **Priority System**
|
||||
Frontmatter category > Detected Keywords > Fallback (uncategorized)
|
||||
|
||||
If a skill already has a category in frontmatter, that's preserved.
|
||||
|
||||
### 3. **Scope-Based Matching**
|
||||
- Exact phrase matches weighted 2x higher than partial matches
|
||||
- Uses word boundaries to avoid false positives
|
||||
|
||||
## Using the Auto-Categorization
|
||||
|
||||
### Run on Uncategorized Skills
|
||||
```bash
|
||||
python tools/scripts/auto_categorize_skills.py
|
||||
```
|
||||
|
||||
### Preview Changes First (Dry Run)
|
||||
```bash
|
||||
python tools/scripts/auto_categorize_skills.py --dry-run
|
||||
```
|
||||
|
||||
### Output
|
||||
```
|
||||
======================================================================
|
||||
AUTO-CATEGORIZATION REPORT
|
||||
======================================================================
|
||||
|
||||
Summary:
|
||||
✅ Categorized: 776
|
||||
⏭️ Already categorized: 46
|
||||
❌ Failed to categorize: 124
|
||||
📈 Total processed: full repository
|
||||
|
||||
Sample changes:
|
||||
• 3d-web-experience
|
||||
uncategorized → web-development
|
||||
• ab-test-setup
|
||||
uncategorized → testing
|
||||
• agent-framework-azure-ai-py
|
||||
uncategorized → backend
|
||||
```
|
||||
|
||||
## Web App Improvements
|
||||
|
||||
### Category Filter
|
||||
**Before:**
|
||||
- Unordered list including "uncategorized"
|
||||
- No indication of category size
|
||||
|
||||
**After:**
|
||||
- Categories sorted by skill count (most first, "uncategorized" last)
|
||||
- Shows count: "Backend (164)" "Web Development (107)"
|
||||
- Much easier to browse
|
||||
|
||||
### Example Dropdowns
|
||||
|
||||
**Sorted Order:**
|
||||
1. All Categories
|
||||
2. Backend (164)
|
||||
3. Web Development (107)
|
||||
4. Automation (103)
|
||||
5. DevOps (83)
|
||||
6. AI/ML (79)
|
||||
7. ... more categories ...
|
||||
8. Uncategorized (126) ← at the end
|
||||
|
||||
## For Skill Creators
|
||||
|
||||
### When Adding a New Skill
|
||||
|
||||
Include category in frontmatter:
|
||||
```yaml
|
||||
---
|
||||
name: my-skill
|
||||
description: "..."
|
||||
category: web-development
|
||||
date_added: "2026-03-06"
|
||||
---
|
||||
```
|
||||
|
||||
### If You're Not Sure
|
||||
|
||||
The system will automatically categorize on next index regeneration:
|
||||
```bash
|
||||
python tools/scripts/generate_index.py
|
||||
```
|
||||
|
||||
## Keyword Reference
|
||||
|
||||
Available auto-categorization keywords by category:
|
||||
|
||||
**Backend**: nodejs, node.js, express, fastapi, django, flask, spring, java, python, golang, rust, server, api, rest, graphql, database, sql, mongodb
|
||||
|
||||
**Web Development**: react, vue, angular, html, css, javascript, typescript, frontend, tailwind, bootstrap, webpack, vite, pwa, responsive, seo
|
||||
|
||||
**Database**: database, sql, postgres, mysql, mongodb, firestore, redis, orm, schema
|
||||
|
||||
**AI/ML**: ai, machine learning, ml, tensorflow, pytorch, nlp, llm, gpt, transformer, embedding, training
|
||||
|
||||
**DevOps**: docker, kubernetes, ci/cd, git, jenkins, terraform, ansible, deploy, container, monitoring
|
||||
|
||||
**Cloud**: aws, azure, gcp, serverless, lambda, storage, cdn
|
||||
|
||||
**Security**: encryption, cryptography, jwt, oauth, authentication, authorization, vulnerability
|
||||
|
||||
**Testing**: test, jest, mocha, pytest, cypress, selenium, unit test, e2e
|
||||
|
||||
**Mobile**: mobile, react native, flutter, ios, android, swift, kotlin
|
||||
|
||||
**Automation**: automation, workflow, scripting, robot, trigger, integration
|
||||
|
||||
**Game Development**: game, unity, unreal, godot, threejs, 2d, 3d, physics
|
||||
|
||||
**Data Science**: data, analytics, pandas, numpy, statistics, visualization
|
||||
|
||||
## Customization
|
||||
|
||||
### Add Custom Keywords
|
||||
|
||||
Edit [`tools/scripts/auto_categorize_skills.py`](../../tools/scripts/auto_categorize_skills.py):
|
||||
|
||||
```python
|
||||
CATEGORY_KEYWORDS = {
|
||||
'your-category': [
|
||||
'keyword1', 'keyword2', 'exact phrase', 'another-keyword'
|
||||
],
|
||||
# ... other categories
|
||||
}
|
||||
```
|
||||
|
||||
Then re-run:
|
||||
```bash
|
||||
python tools/scripts/auto_categorize_skills.py
|
||||
python tools/scripts/generate_index.py
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Failed to categorize" Skills
|
||||
|
||||
Some skills may be too generic or unique. You can:
|
||||
|
||||
1. **Manually set category** in the skill's frontmatter:
|
||||
```yaml
|
||||
category: your-chosen-category
|
||||
```
|
||||
|
||||
2. **Add keywords** to CATEGORY_KEYWORDS config
|
||||
|
||||
3. **Move to folder** if it fits a broader category:
|
||||
```
|
||||
skills/backend/my-new-skill/SKILL.md
|
||||
```
|
||||
|
||||
### Regenerating Index
|
||||
|
||||
After making changes to SKILL.md files:
|
||||
```bash
|
||||
python tools/scripts/generate_index.py
|
||||
```
|
||||
|
||||
This will:
|
||||
- Parse frontmatter categories
|
||||
- Fallback to folder structure
|
||||
- Generate new skills_index.json
|
||||
- Copy to apps/web-app/public/skills.json
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Test in web app**: Try the improved category filter
|
||||
2. **Add missing keywords**: If certain skills are still uncategorized
|
||||
3. **Organize remaining uncategorized skills**: Either auto-assign or manually review
|
||||
4. **Monitor growth**: Use reports to track new vs categorized skills
|
||||
|
||||
---
|
||||
|
||||
**Result**: Much cleaner category filter with smart, meaningful organization! 🎉
|
||||
145
docs/sources/sources.md
Normal file
145
docs/sources/sources.md
Normal file
@@ -0,0 +1,145 @@
|
||||
# 📜 Sources & Attributions
|
||||
|
||||
We believe in giving credit where credit is due.
|
||||
If you recognize your work here and it is not properly attributed, please open an Issue.
|
||||
|
||||
| Skill / Category | Original Source | License | Notes |
|
||||
| :-------------------------- | :------------------------------------------------------------------------- | :------------- | :---------------------------- |
|
||||
| `cloud-penetration-testing` | [HackTricks](https://book.hacktricks.xyz/) | MIT / CC-BY-SA | Adapted for agentic use. |
|
||||
| `active-directory-attacks` | [HackTricks](https://book.hacktricks.xyz/) | MIT / CC-BY-SA | Adapted for agentic use. |
|
||||
| `owasp-top-10` | [OWASP](https://owasp.org/) | CC-BY-SA | Methodology adapted. |
|
||||
| `burp-suite-testing` | [PortSwigger](https://portswigger.net/burp) | N/A | Usage guide only (no binary). |
|
||||
| `crewai` | [CrewAI](https://github.com/joaomdmoura/crewAI) | MIT | Framework guides. |
|
||||
| `langgraph` | [LangGraph](https://github.com/langchain-ai/langgraph) | MIT | Framework guides. |
|
||||
| `react-patterns` | [React Docs](https://react.dev/) | CC-BY | Official patterns. |
|
||||
| **All Official Skills** | [Anthropic / Google / OpenAI / Microsoft / Supabase / Apify / Vercel Labs] | Proprietary | Usage encouraged by vendors. |
|
||||
|
||||
## Skills from VoltAgent/awesome-agent-skills
|
||||
|
||||
The following skills were added from the curated collection at [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills):
|
||||
|
||||
### Official Team Skills
|
||||
|
||||
| Skill | Original Source | License | Notes |
|
||||
| :------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------ | :--------- | :--------------------------------- |
|
||||
| `vercel-deploy-claimable` | [Vercel Labs](https://github.com/vercel-labs/agent-skills) | MIT | Official Vercel skill |
|
||||
| `design-md` | [Google Labs (Stitch)](https://github.com/google-labs-code/stitch-skills) | Compatible | Google Labs Stitch skills |
|
||||
| `hugging-face-cli`, `hugging-face-jobs` | [Hugging Face](https://github.com/huggingface/skills) | Compatible | Official Hugging Face skills |
|
||||
| `culture-index`, `fix-review`, `sharp-edges` | [Trail of Bits](https://github.com/trailofbits/skills) | Compatible | Security skills from Trail of Bits |
|
||||
| `expo-deployment`, `upgrading-expo` | [Expo](https://github.com/expo/skills) | Compatible | Official Expo skills |
|
||||
| `commit`, `create-pr`, `find-bugs`, `iterate-pr` | [Sentry](https://github.com/getsentry/skills) | Compatible | Sentry dev team skills |
|
||||
| `using-neon` | [Neon](https://github.com/neondatabase/agent-skills) | Compatible | Neon Postgres best practices |
|
||||
| `fal-audio`, `fal-generate`, `fal-image-edit`, `fal-platform`, `fal-upscale`, `fal-workflow` | [fal.ai Community](https://github.com/fal-ai-community/skills) | Compatible | fal.ai AI model skills |
|
||||
|
||||
### Community Skills
|
||||
|
||||
| Skill | Original Source | License | Notes |
|
||||
| :------------------------------------------------------------------ | :-------------------------------------------------------------------------- | :--------- | :----------------------------- |
|
||||
| `automate-whatsapp`, `observe-whatsapp` | [gokapso](https://github.com/gokapso/agent-skills) | Compatible | WhatsApp automation skills |
|
||||
| `readme` | [Shpigford](https://github.com/Shpigford/skills) | Compatible | README generation |
|
||||
| `screenshots` | [Shpigford](https://github.com/Shpigford/skills) | Compatible | Marketing screenshots |
|
||||
| `aws-skills` | [zxkane](https://github.com/zxkane/aws-skills) | Compatible | AWS development patterns |
|
||||
| `deep-research` | [sanjay3290](https://github.com/sanjay3290/ai-skills) | Compatible | Gemini Deep Research Agent |
|
||||
| `ffuf-claude-skill` | [jthack](https://github.com/jthack/ffuf_claude_skill) | Compatible | Web fuzzing with ffuf |
|
||||
| `ui-skills` | [ibelick](https://github.com/ibelick/ui-skills) | Compatible | UI development constraints |
|
||||
| `vexor` | [scarletkc](https://github.com/scarletkc/vexor) | Compatible | Vector-powered CLI |
|
||||
| `pypict-skill` | [omkamal](https://github.com/omkamal/pypict-claude-skill) | Compatible | Pairwise test generation |
|
||||
| `makepad-skills` | [ZhangHanDong](https://github.com/ZhangHanDong/makepad-skills) | Compatible | Makepad UI development |
|
||||
| `swiftui-expert-skill` | [AvdLee](https://github.com/AvdLee/SwiftUI-Agent-Skill) | Compatible | SwiftUI best practices |
|
||||
| `threejs-skills` | [CloudAI-X](https://github.com/CloudAI-X/threejs-skills) | Compatible | Three.js 3D experiences |
|
||||
| `claude-scientific-skills` | [K-Dense-AI](https://github.com/K-Dense-AI/claude-scientific-skills) | Compatible | Scientific research skills |
|
||||
| `claude-win11-speckit-update-skill` | [NotMyself](https://github.com/NotMyself/claude-win11-speckit-update-skill) | Compatible | Windows 11 management |
|
||||
| `imagen` | [sanjay3290](https://github.com/sanjay3290/ai-skills) | Compatible | Google Gemini image generation |
|
||||
| `security-bluebook-builder` | [SHADOWPR0](https://github.com/SHADOWPR0/security-bluebook-builder) | Compatible | Security documentation |
|
||||
| `claude-ally-health` | [huifer](https://github.com/huifer/Claude-Ally-Health) | Compatible | Health assistant |
|
||||
| `clarity-gate` | [frmoretto](https://github.com/frmoretto/clarity-gate) | Compatible | RAG quality verification |
|
||||
| `n8n-code-python`, `n8n-mcp-tools-expert`, `n8n-node-configuration` | [czlonkowski](https://github.com/czlonkowski/n8n-skills) | Compatible | n8n automation skills |
|
||||
| `varlock-claude-skill` | [wrsmith108](https://github.com/wrsmith108/varlock-claude-skill) | Compatible | Secure environment variables |
|
||||
| `beautiful-prose` | [SHADOWPR0](https://github.com/SHADOWPR0/beautiful_prose) | Compatible | Writing style guide |
|
||||
| `claude-speed-reader` | [SeanZoR](https://github.com/SeanZoR/claude-speed-reader) | Compatible | Speed reading tool |
|
||||
| `skill-seekers` | [yusufkaraaslan](https://github.com/yusufkaraaslan/Skill_Seekers) | Compatible | Skill conversion tool |
|
||||
|
||||
- **frontend-slides** - [zarazhangrui](https://github.com/zarazhangrui/frontend-slides)
|
||||
- **linear-claude-skill** - [wrsmith108](https://github.com/wrsmith108/linear-claude-skill)
|
||||
- **skill-rails-upgrade** - [robzolkos](https://github.com/robzolkos/skill-rails-upgrade)
|
||||
- **context-fundamentals** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **context-degradation** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **context-compression** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **context-optimization** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **multi-agent-patterns** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **tool-design** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **evaluation** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **memory-systems** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
|
||||
- **terraform-skill** - [antonbabenko](https://github.com/antonbabenko/terraform-skill)
|
||||
|
||||
## Skills from whatiskadudoing/fp-ts-skills (v4.4.0)
|
||||
|
||||
| Skill | Original Source | License | Notes |
|
||||
| :---------------- | :------------------------------------------------------------------------------ | :--------- | :------------------------------------------------------- |
|
||||
| `fp-ts-pragmatic` | [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Compatible | Pragmatic fp-ts guide – pipe, Option, Either, TaskEither |
|
||||
| `fp-ts-react` | [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Compatible | fp-ts with React 18/19 and Next.js |
|
||||
| `fp-ts-errors` | [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Compatible | Type-safe error handling with Either and TaskEither |
|
||||
|
||||
---
|
||||
|
||||
## Recently Added Skills (March 2026)
|
||||
|
||||
The following skills were added during the March 2026 skills update:
|
||||
|
||||
### UI/UX & Frontend
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `baseline-ui`, `fixing-accessibility`, `fixing-metadata`, `fixing-motion-performance` | [ibelick/ui-skills](https://github.com/ibelick/ui-skills) | Compatible | UI polish and validation |
|
||||
| `expo-ui-swift-ui`, `expo-ui-jetpack-compose`, `expo-tailwind-setup`, `building-native-ui`, `expo-api-routes`, `expo-dev-client`, `expo-cicd-workflows`, `native-data-fetching` | [expo/skills](https://github.com/expo/skills) | MIT | Expo/React Native skills |
|
||||
| `swiftui-expert-skill` | [AvdLee/SwiftUI-Agent-Skill](https://github.com/AvdLee/SwiftUI-Agent-Skill) | Compatible | SwiftUI development |
|
||||
| `threejs-fundamentals`, `threejs-geometry`, `threejs-materials`, `threejs-lighting`, `threejs-textures`, `threejs-animation`, `threejs-loaders`, `threejs-shaders`, `threejs-postprocessing`, `threejs-interaction` | [CloudAI-X/threejs-skills](https://github.com/CloudAI-X/threejs-skills) | Compatible | Three.js 3D graphics |
|
||||
| `frontend-slides` | [zarazhangrui](https://github.com/zarazhangrui/frontend-slides) | Compatible | HTML presentations |
|
||||
|
||||
### Automation & Integration
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `gmail-automation`, `google-calendar-automation`, `google-docs-automation`, `google-sheets-automation`, `google-drive-automation`, `google-slides-automation` | [sanjay3290/ai-skills](https://github.com/sanjay3290/ai-skills) | Compatible | Google Workspace integration |
|
||||
| `n8n-expression-syntax`, `n8n-mcp-tools-expert`, `n8n-workflow-patterns`, `n8n-validation-expert`, `n8n-node-configuration`, `n8n-code-javascript`, `n8n-code-python` | [czlonkowski/n8n-skills](https://github.com/czlonkowski/n8n-skills) | Compatible | n8n workflow automation |
|
||||
| `automate-whatsapp` | [gokapso/agent-skills](https://github.com/gokapso/agent-skills) | Compatible | WhatsApp automation |
|
||||
| `linear` | [wrsmith108/linear-claude-skill](https://github.com/wrsmith108/linear-claude-skill) | Compatible | Linear project management |
|
||||
| `rails-upgrade` | [robzolkos](https://github.com/robzolkos/skill-rails-upgrade) | Compatible | Rails upgrade assistant |
|
||||
| `vexor-cli` | [scarletkc/vexor](https://github.com/scarletkc/vexor) | Compatible | Semantic file discovery |
|
||||
|
||||
### Machine Learning & Data
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `hugging-face-dataset-viewer`, `hugging-face-datasets`, `hugging-face-evaluation`, `hugging-face-model-trainer`, `hugging-face-paper-publisher`, `hugging-face-tool-builder` | [huggingface/skills](https://github.com/huggingface/skills) | Compatible | HuggingFace ML tools |
|
||||
| `numpy`, `pandas`, `scipy`, `matplotlib`, `scikit-learn`, `jupyter-workflow` | [K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) | Compatible | Data science essentials |
|
||||
| `biopython`, `scanpy`, `uniprot-database`, `pubmed-database` | [K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) | Compatible | Bioinformatics tools |
|
||||
|
||||
### Security & Auditing
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `semgrep-rule-creator`, `semgrep-rule-variant-creator`, `static-analysis`, `variant-analysis` | [trailofbits/skills](https://github.com/trailofbits/skills) | Compatible | Code security analysis |
|
||||
| `golang-security-auditor`, `python-security-auditor`, `rust-security-auditor` | [trailofbits/skills](https://github.com/trailofbits/skills) | Compatible | Language-specific security |
|
||||
| `burpsuite-project-parser`, `agentic-actions-auditor`, `audit-context-building`, `proof-of-vulnerability`, `yara-authoring` | [trailofbits/skills](https://github.com/trailofbits/skills) | Compatible | Security testing tools |
|
||||
|
||||
### Context Engineering & AI
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `context-fundamentals`, `context-degradation`, `context-compression`, `context-optimization`, `multi-agent-patterns`, `filesystem-context` | [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) | Compatible | Context engineering patterns |
|
||||
|
||||
### Health & Wellness
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `sleep-analyzer`, `nutrition-analyzer`, `fitness-analyzer` | [huifer/Claude-Ally-Health](https://github.com/huifer/Claude-Ally-Health) | Compatible | Health tracking |
|
||||
|
||||
### Quality & Verification
|
||||
| Skill | Source | License | Notes |
|
||||
|-------|--------|---------|-------|
|
||||
| `clarity-gate` | [frmoretto/clarity-gate](https://github.com/frmoretto/clarity-gate) | Compatible | RAG quality verification |
|
||||
|
||||
**Total: 80+ new skills added**
|
||||
|
||||
---
|
||||
|
||||
## License Policy
|
||||
|
||||
- **Code**: All original code in this repository is **MIT**.
|
||||
- **Content**: Documentation is **CC-BY-4.0**.
|
||||
- **Third Party**: We respect the upstream licenses. If an imported skill is GPL, it will be marked clearly or excluded (we aim for MIT/Apache compatibility).
|
||||
464
docs/users/bundles.md
Normal file
464
docs/users/bundles.md
Normal file
@@ -0,0 +1,464 @@
|
||||
# 📦 Antigravity Skill Bundles
|
||||
|
||||
> **Curated collections of skills organized by role and expertise level.** Don't know where to start? Pick a bundle below to get a curated set of skills for your role.
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
1. **Install the repository:**
|
||||
|
||||
```bash
|
||||
npx antigravity-awesome-skills
|
||||
# or clone manually
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
2. **Choose your bundle** from the list below based on your role or interests.
|
||||
|
||||
3. **Use skills** by referencing them in your AI assistant:
|
||||
- Claude Code: `>> /skill-name help me...`
|
||||
- Cursor: `@skill-name in chat`
|
||||
- Gemini CLI: `Use skill-name...`
|
||||
- Codex CLI: `Use skill-name...`
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Essentials & Core
|
||||
|
||||
### 🚀 The "Essentials" Starter Pack
|
||||
|
||||
_For everyone. Install these first._
|
||||
|
||||
- [`concise-planning`](../../skills/concise-planning/): Always start with a plan.
|
||||
- [`lint-and-validate`](../../skills/lint-and-validate/): Keep your code clean automatically.
|
||||
- [`git-pushing`](../../skills/git-pushing/): Save your work safely.
|
||||
- [`kaizen`](../../skills/kaizen/): Continuous improvement mindset.
|
||||
- [`systematic-debugging`](../../skills/systematic-debugging/): Debug like a pro.
|
||||
|
||||
---
|
||||
|
||||
## 🛡️ Security & Compliance
|
||||
|
||||
### 🛡️ The "Security Engineer" Pack
|
||||
|
||||
_For pentesting, auditing, and hardening._
|
||||
|
||||
- [`ethical-hacking-methodology`](../../skills/ethical-hacking-methodology/): The Bible of ethical hacking.
|
||||
- [`burp-suite-testing`](../../skills/burp-suite-testing/): Web vulnerability scanning.
|
||||
- [`top-web-vulnerabilities`](../../skills/top-web-vulnerabilities/): OWASP-aligned vulnerability taxonomy.
|
||||
- [`linux-privilege-escalation`](../../skills/linux-privilege-escalation/): Advanced Linux security assessment.
|
||||
- [`cloud-penetration-testing`](../../skills/cloud-penetration-testing/): AWS/Azure/GCP security.
|
||||
- [`security-auditor`](../../skills/security-auditor/): Comprehensive security audits.
|
||||
- [`vulnerability-scanner`](../../skills/vulnerability-scanner/): Advanced vulnerability analysis.
|
||||
|
||||
### 🔐 The "Security Developer" Pack
|
||||
|
||||
_For building secure applications._
|
||||
|
||||
- [`api-security-best-practices`](../../skills/api-security-best-practices/): Secure API design patterns.
|
||||
- [`auth-implementation-patterns`](../../skills/auth-implementation-patterns/): JWT, OAuth2, session management.
|
||||
- [`backend-security-coder`](../../skills/backend-security-coder/): Secure backend coding practices.
|
||||
- [`frontend-security-coder`](../../skills/frontend-security-coder/): XSS prevention and client-side security.
|
||||
- [`cc-skill-security-review`](../../skills/cc-skill-security-review/): Security checklist for features.
|
||||
- [`pci-compliance`](../../skills/pci-compliance/): Payment card security standards.
|
||||
|
||||
---
|
||||
|
||||
## 🌐 Web Development
|
||||
|
||||
### 🌐 The "Web Wizard" Pack
|
||||
|
||||
_For building modern, high-performance web apps._
|
||||
|
||||
- [`frontend-design`](../../skills/frontend-design/): UI guidelines and aesthetics.
|
||||
- [`react-best-practices`](../../skills/react-best-practices/): React & Next.js performance optimization.
|
||||
- [`react-patterns`](../../skills/react-patterns/): Modern React patterns and principles.
|
||||
- [`nextjs-best-practices`](../../skills/nextjs-best-practices/): Next.js App Router patterns.
|
||||
- [`tailwind-patterns`](../../skills/tailwind-patterns/): Tailwind CSS v4 styling superpowers.
|
||||
- [`form-cro`](../../skills/form-cro/): Optimize your forms for conversion.
|
||||
- [`seo-audit`](../../skills/seo-audit/): Get found on Google.
|
||||
|
||||
### 🖌️ The "Web Designer" Pack
|
||||
|
||||
_For pixel-perfect experiences._
|
||||
|
||||
- [`ui-ux-pro-max`](../../skills/ui-ux-pro-max/): Premium design systems and tokens.
|
||||
- [`frontend-design`](../../skills/frontend-design/): The base layer of aesthetics.
|
||||
- [`3d-web-experience`](../../skills/3d-web-experience/): Three.js & React Three Fiber magic.
|
||||
- [`canvas-design`](../../skills/canvas-design/): Static visuals and posters.
|
||||
- [`mobile-design`](../../skills/mobile-design/): Mobile-first design principles.
|
||||
- [`scroll-experience`](../../skills/scroll-experience/): Immersive scroll-driven experiences.
|
||||
|
||||
### ⚡ The "Full-Stack Developer" Pack
|
||||
|
||||
_For end-to-end web application development._
|
||||
|
||||
- [`senior-fullstack`](../../skills/senior-fullstack/): Complete fullstack development guide.
|
||||
- [`frontend-developer`](../../skills/frontend-developer/): React 19+ and Next.js 15+ expertise.
|
||||
- [`backend-dev-guidelines`](../../skills/backend-dev-guidelines/): Node.js/Express/TypeScript patterns.
|
||||
- [`api-patterns`](../../skills/api-patterns/): REST vs GraphQL vs tRPC selection.
|
||||
- [`database-design`](../../skills/database-design/): Schema design and ORM selection.
|
||||
- [`stripe-integration`](../../skills/stripe-integration/): Payments and subscriptions.
|
||||
|
||||
---
|
||||
|
||||
## 🤖 AI & Agents
|
||||
|
||||
### 🤖 The "Agent Architect" Pack
|
||||
|
||||
_For building AI systems and autonomous agents._
|
||||
|
||||
- [`agent-evaluation`](../../skills/agent-evaluation/): Test and benchmark your agents.
|
||||
- [`langgraph`](../../skills/langgraph/): Build stateful agent workflows.
|
||||
- [`mcp-builder`](../../skills/mcp-builder/): Create your own MCP tools.
|
||||
- [`prompt-engineering`](../../skills/prompt-engineering/): Master the art of talking to LLMs.
|
||||
- [`ai-agents-architect`](../../skills/ai-agents-architect/): Design autonomous AI agents.
|
||||
- [`rag-engineer`](../../skills/rag-engineer/): Build RAG systems with vector search.
|
||||
|
||||
### 🧠 The "LLM Application Developer" Pack
|
||||
|
||||
_For building production LLM applications._
|
||||
|
||||
- [`llm-app-patterns`](../../skills/llm-app-patterns/): Production-ready LLM patterns.
|
||||
- [`rag-implementation`](../../skills/rag-implementation/): Retrieval-Augmented Generation.
|
||||
- [`prompt-caching`](../../skills/prompt-caching/): Cache strategies for LLM prompts.
|
||||
- [`context-window-management`](../../skills/context-window-management/): Manage LLM context efficiently.
|
||||
- [`langfuse`](../../skills/langfuse/): LLM observability and tracing.
|
||||
|
||||
---
|
||||
|
||||
## 🎮 Game Development
|
||||
|
||||
### 🎮 The "Indie Game Dev" Pack
|
||||
|
||||
_For building games with AI assistants._
|
||||
|
||||
- [`game-development/game-design`](../../skills/game-development/game-design/): Mechanics and loops.
|
||||
- [`game-development/2d-games`](../../skills/game-development/2d-games/): Sprites and physics.
|
||||
- [`game-development/3d-games`](../../skills/game-development/3d-games/): Models and shaders.
|
||||
- [`unity-developer`](../../skills/unity-developer/): Unity 6 LTS development.
|
||||
- [`godot-gdscript-patterns`](../../skills/godot-gdscript-patterns/): Godot 4 GDScript patterns.
|
||||
- [`algorithmic-art`](../../skills/algorithmic-art/): Generate assets with code.
|
||||
|
||||
---
|
||||
|
||||
## 🐍 Backend & Languages
|
||||
|
||||
### 🐍 The "Python Pro" Pack
|
||||
|
||||
_For backend heavyweights and data scientists._
|
||||
|
||||
- [`python-pro`](../../skills/python-pro/): Master Python 3.12+ with modern features.
|
||||
- [`python-patterns`](../../skills/python-patterns/): Idiomatic Python code.
|
||||
- [`fastapi-pro`](../../skills/fastapi-pro/): High-performance async APIs.
|
||||
- [`fastapi-templates`](../../skills/fastapi-templates/): Production-ready FastAPI projects.
|
||||
- [`django-pro`](../../skills/django-pro/): The battery-included framework.
|
||||
- [`python-testing-patterns`](../../skills/python-testing-patterns/): Comprehensive testing with pytest.
|
||||
- [`async-python-patterns`](../../skills/async-python-patterns/): Python asyncio mastery.
|
||||
|
||||
### 🟦 The "TypeScript & JavaScript" Pack
|
||||
|
||||
_For modern web development._
|
||||
|
||||
- [`typescript-expert`](../../skills/typescript-expert/): TypeScript mastery and advanced types.
|
||||
- [`javascript-pro`](../../skills/javascript-pro/): Modern JavaScript with ES6+.
|
||||
- [`react-best-practices`](../../skills/react-best-practices/): React performance optimization.
|
||||
- [`nodejs-best-practices`](../../skills/nodejs-best-practices/): Node.js development principles.
|
||||
- [`nextjs-app-router-patterns`](../../skills/nextjs-app-router-patterns/): Next.js 14+ App Router.
|
||||
|
||||
### 🦀 The "Systems Programming" Pack
|
||||
|
||||
_For low-level and performance-critical code._
|
||||
|
||||
- [`rust-pro`](../../skills/rust-pro/): Rust 1.75+ with async patterns.
|
||||
- [`go-concurrency-patterns`](../../skills/go-concurrency-patterns/): Go concurrency mastery.
|
||||
- [`golang-pro`](../../skills/golang-pro/): Go development expertise.
|
||||
- [`memory-safety-patterns`](../../skills/memory-safety-patterns/): Memory-safe programming.
|
||||
- [`cpp-pro`](../../skills/cpp-pro/): Modern C++ development.
|
||||
|
||||
---
|
||||
|
||||
## 🦄 Product & Business
|
||||
|
||||
### 🦄 The "Startup Founder" Pack
|
||||
|
||||
_For building products, not just code._
|
||||
|
||||
- [`product-manager-toolkit`](../../skills/product-manager-toolkit/): RICE prioritization, PRD templates.
|
||||
- [`competitive-landscape`](../../skills/competitive-landscape/): Competitor analysis.
|
||||
- [`competitor-alternatives`](../../skills/competitor-alternatives/): Create comparison pages.
|
||||
- [`launch-strategy`](../../skills/launch-strategy/): Product launch planning.
|
||||
- [`copywriting`](../../skills/copywriting/): Marketing copy that converts.
|
||||
- [`stripe-integration`](../../skills/stripe-integration/): Get paid from day one.
|
||||
|
||||
### 📊 The "Business Analyst" Pack
|
||||
|
||||
_For data-driven decision making._
|
||||
|
||||
- [`business-analyst`](../../skills/business-analyst/): AI-powered analytics and KPIs.
|
||||
- [`startup-metrics-framework`](../../skills/startup-metrics-framework/): SaaS metrics and unit economics.
|
||||
- [`startup-financial-modeling`](../../skills/startup-financial-modeling/): 3-5 year financial projections.
|
||||
- [`market-sizing-analysis`](../../skills/market-sizing-analysis/): TAM/SAM/SOM calculations.
|
||||
- [`kpi-dashboard-design`](../../skills/kpi-dashboard-design/): Effective KPI dashboards.
|
||||
|
||||
### 📈 The "Marketing & Growth" Pack
|
||||
|
||||
_For driving user acquisition and retention._
|
||||
|
||||
- [`content-creator`](../../skills/content-creator/): SEO-optimized marketing content.
|
||||
- [`seo-audit`](../../skills/seo-audit/): Technical SEO health checks.
|
||||
- [`programmatic-seo`](../../skills/programmatic-seo/): Create pages at scale.
|
||||
- [`analytics-tracking`](../../skills/analytics-tracking/): Set up GA4/PostHog correctly.
|
||||
- [`ab-test-setup`](../../skills/ab-test-setup/): Validated learning experiments.
|
||||
- [`email-sequence`](../../skills/email-sequence/): Automated email campaigns.
|
||||
|
||||
---
|
||||
|
||||
## 🌧️ DevOps & Infrastructure
|
||||
|
||||
### 🌧️ The "DevOps & Cloud" Pack
|
||||
|
||||
_For infrastructure and scaling._
|
||||
|
||||
- [`docker-expert`](../../skills/docker-expert/): Master containers and multi-stage builds.
|
||||
- [`aws-serverless`](../../skills/aws-serverless/): Serverless on AWS (Lambda, DynamoDB).
|
||||
- [`kubernetes-architect`](../../skills/kubernetes-architect/): K8s architecture and GitOps.
|
||||
- [`terraform-specialist`](../../skills/terraform-specialist/): Infrastructure as Code mastery.
|
||||
- [`environment-setup-guide`](../../skills/environment-setup-guide/): Standardization for teams.
|
||||
- [`deployment-procedures`](../../skills/deployment-procedures/): Safe rollout strategies.
|
||||
- [`bash-linux`](../../skills/bash-linux/): Terminal wizardry.
|
||||
|
||||
### 📊 The "Observability & Monitoring" Pack
|
||||
|
||||
_For production reliability._
|
||||
|
||||
- [`observability-engineer`](../../skills/observability-engineer/): Comprehensive monitoring systems.
|
||||
- [`distributed-tracing`](../../skills/distributed-tracing/): Track requests across microservices.
|
||||
- [`slo-implementation`](../../skills/slo-implementation/): Service Level Objectives.
|
||||
- [`incident-responder`](../../skills/incident-responder/): Rapid incident response.
|
||||
- [`postmortem-writing`](../../skills/postmortem-writing/): Blameless postmortems.
|
||||
- [`performance-engineer`](../../skills/performance-engineer/): Application performance optimization.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Data & Analytics
|
||||
|
||||
### 📊 The "Data & Analytics" Pack
|
||||
|
||||
_For making sense of the numbers._
|
||||
|
||||
- [`analytics-tracking`](../../skills/analytics-tracking/): Set up GA4/PostHog correctly.
|
||||
- [`claude-d3js-skill`](../../skills/claude-d3js-skill/): Beautiful custom visualizations with D3.js.
|
||||
- [`sql-pro`](../../skills/sql-pro/): Modern SQL with cloud-native databases.
|
||||
- [`postgres-best-practices`](../../skills/postgres-best-practices/): Postgres optimization.
|
||||
- [`ab-test-setup`](../../skills/ab-test-setup/): Validated learning.
|
||||
- [`database-architect`](../../skills/database-architect/): Database design from scratch.
|
||||
|
||||
### 🔄 The "Data Engineering" Pack
|
||||
|
||||
_For building data pipelines._
|
||||
|
||||
- [`data-engineer`](../../skills/data-engineer/): Data pipeline architecture.
|
||||
- [`airflow-dag-patterns`](../../skills/airflow-dag-patterns/): Apache Airflow DAGs.
|
||||
- [`dbt-transformation-patterns`](../../skills/dbt-transformation-patterns/): Analytics engineering.
|
||||
- [`vector-database-engineer`](../../skills/vector-database-engineer/): Vector databases for RAG.
|
||||
- [`embedding-strategies`](../../skills/embedding-strategies/): Embedding model selection.
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Creative & Content
|
||||
|
||||
### 🎨 The "Creative Director" Pack
|
||||
|
||||
_For visuals, content, and branding._
|
||||
|
||||
- [`canvas-design`](../../skills/canvas-design/): Generate posters and diagrams.
|
||||
- [`frontend-design`](../../skills/frontend-design/): UI aesthetics.
|
||||
- [`content-creator`](../../skills/content-creator/): SEO-optimized blog posts.
|
||||
- [`copy-editing`](../../skills/copy-editing/): Polish your prose.
|
||||
- [`algorithmic-art`](../../skills/algorithmic-art/): Code-generated masterpieces.
|
||||
- [`interactive-portfolio`](../../skills/interactive-portfolio/): Portfolios that land jobs.
|
||||
|
||||
---
|
||||
|
||||
## 🐞 Quality Assurance
|
||||
|
||||
### 🐞 The "QA & Testing" Pack
|
||||
|
||||
_For breaking things before users do._
|
||||
|
||||
- [`test-driven-development`](../../skills/test-driven-development/): Red, Green, Refactor.
|
||||
- [`systematic-debugging`](../../skills/systematic-debugging/): Debug like Sherlock Holmes.
|
||||
- [`browser-automation`](../../skills/browser-automation/): End-to-end testing with Playwright.
|
||||
- [`e2e-testing-patterns`](../../skills/e2e-testing-patterns/): Reliable E2E test suites.
|
||||
- [`ab-test-setup`](../../skills/ab-test-setup/): Validated experiments.
|
||||
- [`code-review-checklist`](../../skills/code-review-checklist/): Catch bugs in PRs.
|
||||
- [`test-fixing`](../../skills/test-fixing/): Fix failing tests systematically.
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Specialized Packs
|
||||
|
||||
### 📱 The "Mobile Developer" Pack
|
||||
|
||||
_For iOS, Android, and cross-platform apps._
|
||||
|
||||
- [`mobile-developer`](../../skills/mobile-developer/): Cross-platform mobile development.
|
||||
- [`react-native-architecture`](../../skills/react-native-architecture/): React Native with Expo.
|
||||
- [`flutter-expert`](../../skills/flutter-expert/): Flutter multi-platform apps.
|
||||
- [`ios-developer`](../../skills/ios-developer/): iOS development with Swift.
|
||||
- [`app-store-optimization`](../../skills/app-store-optimization/): ASO for App Store and Play Store.
|
||||
|
||||
### 🔗 The "Integration & APIs" Pack
|
||||
|
||||
_For connecting services and building integrations._
|
||||
|
||||
- [`stripe-integration`](../../skills/stripe-integration/): Payments and subscriptions.
|
||||
- [`twilio-communications`](../../skills/twilio-communications/): SMS, voice, WhatsApp.
|
||||
- [`hubspot-integration`](../../skills/hubspot-integration/): CRM integration.
|
||||
- [`plaid-fintech`](../../skills/plaid-fintech/): Bank account linking and ACH.
|
||||
- [`algolia-search`](../../skills/algolia-search/): Search implementation.
|
||||
|
||||
### 🎯 The "Architecture & Design" Pack
|
||||
|
||||
_For system design and technical decisions._
|
||||
|
||||
- [`senior-architect`](../../skills/senior-architect/): Comprehensive software architecture.
|
||||
- [`architecture-patterns`](../../skills/architecture-patterns/): Clean Architecture, DDD, Hexagonal.
|
||||
- [`microservices-patterns`](../../skills/microservices-patterns/): Microservices architecture.
|
||||
- [`event-sourcing-architect`](../../skills/event-sourcing-architect/): Event sourcing and CQRS.
|
||||
- [`architecture-decision-records`](../../skills/architecture-decision-records/): Document technical decisions.
|
||||
|
||||
### 🧱 The "DDD & Evented Architecture" Pack
|
||||
|
||||
_For teams modeling complex domains and evolving toward evented systems._
|
||||
|
||||
- [`domain-driven-design`](../../skills/domain-driven-design/): Route DDD work from strategic modeling to implementation patterns.
|
||||
- [`ddd-strategic-design`](../../skills/ddd-strategic-design/): Subdomains, bounded contexts, and ubiquitous language.
|
||||
- [`ddd-context-mapping`](../../skills/ddd-context-mapping/): Cross-context integration and anti-corruption boundaries.
|
||||
- [`ddd-tactical-patterns`](../../skills/ddd-tactical-patterns/): Aggregates, value objects, repositories, and domain events.
|
||||
- [`cqrs-implementation`](../../skills/cqrs-implementation/): Read/write model separation.
|
||||
- [`event-store-design`](../../skills/event-store-design/): Event persistence and replay architecture.
|
||||
- [`saga-orchestration`](../../skills/saga-orchestration/): Cross-context long-running transaction coordination.
|
||||
- [`projection-patterns`](../../skills/projection-patterns/): Materialized read models from event streams.
|
||||
|
||||
---
|
||||
|
||||
## 🧰 Maintainer & OSS
|
||||
|
||||
### 🛠️ The "OSS Maintainer" Pack
|
||||
|
||||
_For shipping clean changes in public repositories._
|
||||
|
||||
- [`commit`](../../skills/commit/): High-quality conventional commits.
|
||||
- [`create-pr`](../../skills/create-pr/): PR creation with review-ready context.
|
||||
- [`requesting-code-review`](../../skills/requesting-code-review/): Ask for targeted, high-signal reviews.
|
||||
- [`receiving-code-review`](../../skills/receiving-code-review/): Apply feedback with technical rigor.
|
||||
- [`changelog-automation`](../../skills/changelog-automation/): Keep release notes and changelogs consistent.
|
||||
- [`git-advanced-workflows`](../../skills/git-advanced-workflows/): Rebase, cherry-pick, bisect, recovery.
|
||||
- [`documentation-templates`](../../skills/documentation-templates/): Standardize docs and handoffs.
|
||||
|
||||
### 🧱 The "Skill Author" Pack
|
||||
|
||||
_For creating and maintaining high-quality SKILL.md assets._
|
||||
|
||||
- [`skill-creator`](../../skills/skill-creator/): Design effective new skills.
|
||||
- [`skill-developer`](../../skills/skill-developer/): Implement triggers, hooks, and skill lifecycle.
|
||||
- [`writing-skills`](../../skills/writing-skills/): Improve clarity and structure of skill instructions.
|
||||
- [`documentation-generation-doc-generate`](../../skills/documentation-generation-doc-generate/): Generate maintainable technical docs.
|
||||
- [`lint-and-validate`](../../skills/lint-and-validate/): Validate quality after edits.
|
||||
- [`verification-before-completion`](../../skills/verification-before-completion/): Confirm changes before claiming done.
|
||||
|
||||
---
|
||||
|
||||
## 📚 How to Use Bundles
|
||||
|
||||
### 1) Pick by immediate goal
|
||||
|
||||
- Need to ship a feature now: `Essentials` + one domain pack (`Web Wizard`, `Python Pro`, `DevOps & Cloud`).
|
||||
- Need reliability and hardening: add `QA & Testing` + `Security Developer`.
|
||||
- Need product growth: add `Startup Founder` or `Marketing & Growth`.
|
||||
|
||||
### 2) Start with 3-5 skills, not 20
|
||||
|
||||
Pick the minimum set for your current milestone. Expand only when you hit a real gap.
|
||||
|
||||
### 3) Invoke skills consistently
|
||||
|
||||
- **Claude Code**: `>> /skill-name help me...`
|
||||
- **Cursor**: `@skill-name` in chat
|
||||
- **Gemini CLI**: `Use skill-name...`
|
||||
- **Codex CLI**: `Use skill-name...`
|
||||
|
||||
### 4) Build your personal shortlist
|
||||
|
||||
Keep a small list of high-frequency skills and reuse it across tasks to reduce context switching.
|
||||
|
||||
## 🧩 Recommended Bundle Combos
|
||||
|
||||
### Ship a SaaS MVP (2 weeks)
|
||||
|
||||
`Essentials` + `Full-Stack Developer` + `QA & Testing` + `Startup Founder`
|
||||
|
||||
### Harden an existing production app
|
||||
|
||||
`Essentials` + `Security Developer` + `DevOps & Cloud` + `Observability & Monitoring`
|
||||
|
||||
### Build an AI product
|
||||
|
||||
`Essentials` + `Agent Architect` + `LLM Application Developer` + `Data Engineering`
|
||||
|
||||
### Grow traffic and conversions
|
||||
|
||||
`Web Wizard` + `Marketing & Growth` + `Data & Analytics`
|
||||
|
||||
### Launch and maintain open source
|
||||
|
||||
`Essentials` + `OSS Maintainer` + `Architecture & Design`
|
||||
|
||||
---
|
||||
|
||||
## 🎓 Learning Paths
|
||||
|
||||
### Beginner → Intermediate → Advanced
|
||||
|
||||
**Web Development:**
|
||||
|
||||
1. Start: `Essentials` → `Web Wizard`
|
||||
2. Grow: `Full-Stack Developer` → `Architecture & Design`
|
||||
3. Master: `Observability & Monitoring` → `Security Developer`
|
||||
|
||||
**AI/ML:**
|
||||
|
||||
1. Start: `Essentials` → `Agent Architect`
|
||||
2. Grow: `LLM Application Developer` → `Data Engineering`
|
||||
3. Master: Advanced RAG and agent orchestration
|
||||
|
||||
**Security:**
|
||||
|
||||
1. Start: `Essentials` → `Security Developer`
|
||||
2. Grow: `Security Engineer` → Advanced pentesting
|
||||
3. Master: Red team tactics and threat modeling
|
||||
|
||||
**Open Source Maintenance:**
|
||||
|
||||
1. Start: `Essentials` → `OSS Maintainer`
|
||||
2. Grow: `Architecture & Design` → `QA & Testing`
|
||||
3. Master: `Skill Author` + release automation workflows
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
Found a skill that should be in a bundle? Or want to create a new bundle? [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues) or submit a PR!
|
||||
|
||||
---
|
||||
|
||||
## 📖 Related Documentation
|
||||
|
||||
- [Getting Started Guide](getting-started.md)
|
||||
- [Full Skill Catalog](../../CATALOG.md)
|
||||
- [Contributing Guide](../../CONTRIBUTING.md)
|
||||
|
||||
---
|
||||
|
||||
_Last updated: March 2026 | Total Skills: 1,204+ | Total Bundles: 26_
|
||||
197
docs/users/faq.md
Normal file
197
docs/users/faq.md
Normal file
@@ -0,0 +1,197 @@
|
||||
# ❓ Frequently Asked Questions (FAQ)
|
||||
|
||||
**Got questions?** You're not alone! Here are answers to the most common questions about Antigravity Awesome Skills.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 General Questions
|
||||
|
||||
### What are "skills" exactly?
|
||||
|
||||
Skills are specialized instruction files that teach AI assistants how to handle specific tasks. Think of them as expert knowledge modules that your AI can load on-demand.
|
||||
**Simple analogy:** Just like you might consult different experts (a lawyer, a doctor, a mechanic), these skills let your AI become an expert in different areas when you need them.
|
||||
|
||||
### Do I need to install all 1,204+ skills?
|
||||
|
||||
**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 books are there, but you only read the ones you need.
|
||||
**Pro Tip:** Use [Starter Packs](bundles.md) to install only what matches your role.
|
||||
|
||||
### What is the difference between Bundles and Workflows?
|
||||
|
||||
- **Bundles** are curated recommendations grouped by role or domain.
|
||||
- **Workflows** are ordered execution playbooks for concrete outcomes.
|
||||
|
||||
Use bundles when you are deciding _which skills_ to include. Use workflows when you need _step-by-step execution_.
|
||||
|
||||
Start from:
|
||||
|
||||
- [bundles.md](bundles.md)
|
||||
- [workflows.md](workflows.md)
|
||||
|
||||
### Which AI tools work with these skills?
|
||||
|
||||
- ✅ **Claude Code** (Anthropic CLI)
|
||||
- ✅ **Gemini CLI** (Google)
|
||||
- ✅ **Codex CLI** (OpenAI)
|
||||
- ✅ **Cursor** (AI IDE)
|
||||
- ✅ **Antigravity IDE**
|
||||
- ✅ **OpenCode**
|
||||
- ⚠️ **GitHub Copilot** (partial support via copy-paste)
|
||||
|
||||
### Are these skills free to use?
|
||||
|
||||
**Yes!** This repository is licensed under MIT License.
|
||||
|
||||
- ✅ Free for personal use
|
||||
- ✅ Free for commercial use
|
||||
- ✅ You can modify them
|
||||
|
||||
### Do skills work offline?
|
||||
|
||||
The skill files themselves are stored locally on your computer, but your AI assistant needs an internet connection to function.
|
||||
|
||||
---
|
||||
|
||||
## 🔒 Security & Trust (V4 Update)
|
||||
|
||||
### What do the Risk Labels mean?
|
||||
|
||||
We classify skills so you know what you're running:
|
||||
|
||||
- ⚪ **Safe (White/Blue)**: Read-only, planning, or benign skills.
|
||||
- 🔴 **Risk (Red)**: Skills that modify files (delete), use network scanners, or perform destructive actions. **Use with caution.**
|
||||
- 🟣 **Official (Purple)**: Maintained by trusted vendors (Anthropic, DeepMind, etc.).
|
||||
|
||||
### Can these skills hack my computer?
|
||||
|
||||
**No.** Skills are text files. However, they _instruct_ the AI to run commands. If a skill says "delete all files", a compliant AI might try to do it.
|
||||
_Always check the Risk label and review the code._
|
||||
|
||||
---
|
||||
|
||||
## 📦 Installation & Setup
|
||||
|
||||
### Where should I install the skills?
|
||||
|
||||
The universal path that works with most tools is `.agent/skills/`.
|
||||
|
||||
**Using npx:** `npx antigravity-awesome-skills` (or `npx github:sickn33/antigravity-awesome-skills` if you get a 404).
|
||||
|
||||
**Using git clone:**
|
||||
|
||||
```bash
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
**Tool-specific paths:**
|
||||
|
||||
- Claude Code: `.claude/skills/`
|
||||
- Gemini CLI: `.gemini/skills/`
|
||||
- Codex CLI: `.codex/skills/`
|
||||
- Cursor: `.cursor/skills/` or project root
|
||||
|
||||
### Does this work with Windows?
|
||||
|
||||
**Yes**, but some "Official" skills use **symlinks** which Windows handles poorly by default.
|
||||
Run git with:
|
||||
|
||||
```bash
|
||||
git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
Or enable "Developer Mode" in Windows Settings.
|
||||
|
||||
### How do I update skills?
|
||||
|
||||
Navigate to your skills directory and pull the latest changes:
|
||||
|
||||
```bash
|
||||
cd .agent/skills
|
||||
git pull origin main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Using Skills
|
||||
|
||||
> **💡 For a complete guide with examples, see [usage.md](usage.md)**
|
||||
|
||||
### How do I invoke a skill?
|
||||
|
||||
Use the `@` symbol followed by the skill name:
|
||||
|
||||
```bash
|
||||
@brainstorming help me design a todo app
|
||||
```
|
||||
|
||||
### Can I use multiple skills at once?
|
||||
|
||||
**Yes!** You can invoke multiple skills:
|
||||
|
||||
```bash
|
||||
@brainstorming help me design this, then use @writing-plans to create a task list.
|
||||
```
|
||||
|
||||
### How do I know which skill to use?
|
||||
|
||||
1. **Browse the catalog**: Check the [Skill Catalog](../../CATALOG.md).
|
||||
2. **Search**: `ls skills/ | grep "keyword"`
|
||||
3. **Ask your AI**: "What skills do you have for testing?"
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ Troubleshooting
|
||||
|
||||
### My AI assistant doesn't recognize skills
|
||||
|
||||
**Possible causes:**
|
||||
|
||||
1. **Wrong installation path**: Check your tool's docs. Try `.agent/skills/`.
|
||||
2. **Restart Needed**: Restart your AI/IDE after installing.
|
||||
3. **Typos**: Did you type `@brain-storming` instead of `@brainstorming`?
|
||||
|
||||
### A skill gives incorrect or outdated advice
|
||||
|
||||
Please [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues)!
|
||||
Include:
|
||||
|
||||
- Which skill
|
||||
- What went wrong
|
||||
- What should happen instead
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Contribution
|
||||
|
||||
### I'm new to open source. Can I contribute?
|
||||
|
||||
**Absolutely!** We welcome beginners.
|
||||
|
||||
- Fix typos
|
||||
- Add examples
|
||||
- Improve docs
|
||||
Check out [CONTRIBUTING.md](../../CONTRIBUTING.md) for instructions.
|
||||
|
||||
### My PR failed "Quality Bar" check. Why?
|
||||
|
||||
V4 introduces automated quality control. Your skill might be missing:
|
||||
|
||||
1. A valid `description`.
|
||||
2. Usage examples.
|
||||
Run `npm run validate` locally to check before you push.
|
||||
|
||||
### Can I update an "Official" skill?
|
||||
|
||||
**No.** Official skills (in `skills/official/`) are mirrored from vendors. Open an issue instead.
|
||||
|
||||
---
|
||||
|
||||
## 💡 Pro Tips
|
||||
|
||||
- Start with `@brainstorming` before building anything new
|
||||
- Use `@systematic-debugging` when stuck on bugs
|
||||
- Try `@test-driven-development` for better code quality
|
||||
- Explore `@skill-creator` to make your own skills
|
||||
|
||||
**Still confused?** [Open a discussion](https://github.com/sickn33/antigravity-awesome-skills/discussions) and we'll help you out! 🙌
|
||||
142
docs/users/getting-started.md
Normal file
142
docs/users/getting-started.md
Normal file
@@ -0,0 +1,142 @@
|
||||
# Getting Started with Antigravity Awesome Skills (V7.0.0)
|
||||
|
||||
**New here? This guide will help you supercharge your AI Agent in 5 minutes.**
|
||||
|
||||
> **💡 Confused about what to do after installation?** Check out the [**Complete Usage Guide**](usage.md) for detailed explanations and examples!
|
||||
|
||||
---
|
||||
|
||||
## 🤔 What Are "Skills"?
|
||||
|
||||
AI Agents (like **Claude Code**, **Gemini**, **Cursor**) are smart, but they lack specific knowledge about your tools.
|
||||
**Skills** are specialized instruction manuals (markdown files) that teach your AI how to perform specific tasks perfectly, every time.
|
||||
|
||||
**Analogy:** Your AI is a brilliant intern. **Skills** are the SOPs (Standard Operating Procedures) that make them a Senior Engineer.
|
||||
|
||||
---
|
||||
|
||||
## ⚡️ Quick Start: The "Starter Packs"
|
||||
|
||||
Don't panic about the 1,200+ skills. You don't need them all at once.
|
||||
We have curated **Starter Packs** to get you running immediately.
|
||||
|
||||
You **install the full repo once** (npx or clone); Starter Packs are curated lists to help you **pick which skills to use** by role (e.g. Web Wizard, Hacker Pack)—they are not a different way to install.
|
||||
|
||||
### 1. Install the Repo
|
||||
|
||||
**Option A — npx (easiest):**
|
||||
|
||||
```bash
|
||||
npx antigravity-awesome-skills
|
||||
```
|
||||
|
||||
This clones to `~/.gemini/antigravity/skills` by default. Use `--cursor`, `--claude`, `--gemini`, `--codex`, or `--kiro` to install for a specific tool, or `--path <dir>` for a custom location. Run `npx antigravity-awesome-skills --help` for details.
|
||||
|
||||
If you see a 404 error, use: `npx github:sickn33/antigravity-awesome-skills`
|
||||
|
||||
**Option B — git clone:**
|
||||
|
||||
```bash
|
||||
# Universal (works for most agents)
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||||
```
|
||||
|
||||
### 2. Pick Your Persona
|
||||
|
||||
Find the bundle that matches your role (see [bundles.md](bundles.md)):
|
||||
|
||||
| Persona | Bundle Name | What's Inside? |
|
||||
| :-------------------- | :------------- | :------------------------------------------------ |
|
||||
| **Web Developer** | `Web Wizard` | React Patterns, Tailwind mastery, Frontend Design |
|
||||
| **Security Engineer** | `Hacker Pack` | OWASP, Metasploit, Pentest Methodology |
|
||||
| **Manager / PM** | `Product Pack` | Brainstorming, Planning, SEO, Strategy |
|
||||
| **Everything** | `Essentials` | Clean Code, Planning, Validation (The Basics) |
|
||||
|
||||
---
|
||||
|
||||
## 🧭 Bundles vs Workflows
|
||||
|
||||
Bundles and workflows solve different problems:
|
||||
|
||||
- **Bundles** = curated sets by role (what to pick).
|
||||
- **Workflows** = step-by-step playbooks (how to execute).
|
||||
|
||||
Start with bundles in [bundles.md](bundles.md), then run a workflow from [workflows.md](workflows.md) when you need guided execution.
|
||||
|
||||
Example:
|
||||
|
||||
> "Use **@antigravity-workflows** and run `ship-saas-mvp` for my project idea."
|
||||
|
||||
---
|
||||
|
||||
## 🚀 How to Use a Skill
|
||||
|
||||
Once installed, just talk to your AI naturally.
|
||||
|
||||
### Example 1: Planning a Feature (**Essentials**)
|
||||
|
||||
> "Use **@brainstorming** to help me design a new login flow."
|
||||
|
||||
**What happens:** The AI loads the brainstorming skill, asks you structured questions, and produces a professional spec.
|
||||
|
||||
### Example 2: Checking Your Code (**Web Wizard**)
|
||||
|
||||
> "Run **@lint-and-validate** on this file and fix errors."
|
||||
|
||||
**What happens:** The AI follows strict linting rules defined in the skill to clean your code.
|
||||
|
||||
### Example 3: Security Audit (**Hacker Pack**)
|
||||
|
||||
> "Use **@api-security-best-practices** to review my API endpoints."
|
||||
|
||||
**What happens:** The AI audits your code against OWASP standards.
|
||||
|
||||
---
|
||||
|
||||
## 🔌 Supported Tools
|
||||
|
||||
| Tool | Status | Path |
|
||||
| :-------------- | :-------------- | :-------------------------------------------------------------------- |
|
||||
| **Claude Code** | ✅ Full Support | `.claude/skills/` |
|
||||
| **Gemini CLI** | ✅ Full Support | `.gemini/skills/` |
|
||||
| **Codex CLI** | ✅ Full Support | `.codex/skills/` |
|
||||
| **Kiro CLI** | ✅ Full Support | Global: `~/.kiro/skills/` · Workspace: `.kiro/skills/` |
|
||||
| **Kiro IDE** | ✅ Full Support | Global: `~/.kiro/skills/` · Workspace: `.kiro/skills/` |
|
||||
| **Antigravity** | ✅ Native | Global: `~/.gemini/antigravity/skills/` · Workspace: `.agent/skills/` |
|
||||
| **Cursor** | ✅ Native | `.cursor/skills/` |
|
||||
| **OpenCode** | ✅ Full Support | `.agents/skills/` |
|
||||
| **AdaL CLI** | ✅ Full Support | `.adal/skills/` |
|
||||
| **Copilot** | ⚠️ Text Only | Manual copy-paste |
|
||||
|
||||
---
|
||||
|
||||
## 🛡️ Trust & Safety (New in V4)
|
||||
|
||||
We classify skills so you know what you're running:
|
||||
|
||||
- 🟣 **Official**: Maintained by Anthropic/Google/Vendors (High Trust).
|
||||
- 🔵 **Safe**: Community skills that are non-destructive (Read-only/Planning).
|
||||
- 🔴 **Risk**: Skills that modify systems or perform security tests (Authorized Use Only).
|
||||
|
||||
_Check the [Skill Catalog](../../CATALOG.md) for the full list._
|
||||
|
||||
---
|
||||
|
||||
## ❓ FAQ
|
||||
|
||||
**Q: Do I need to install all 1,204+ skills?**
|
||||
A: You clone the whole repo once; your AI only _reads_ the skills you invoke (or that are relevant), so it stays lightweight. **Starter Packs** in [bundles.md](bundles.md) are curated lists to help you discover the right skills for your role—they don't change how you install.
|
||||
|
||||
**Q: Can I make my own skills?**
|
||||
A: Yes! Use the **@skill-creator** skill to build your own.
|
||||
|
||||
**Q: Is this free?**
|
||||
A: Yes, MIT License. Open Source forever.
|
||||
|
||||
---
|
||||
|
||||
## ⏭️ Next Steps
|
||||
|
||||
1. [Browse the Bundles](bundles.md)
|
||||
2. [See Real-World Examples](../contributors/examples.md)
|
||||
3. [Contribute a Skill](../../CONTRIBUTING.md)
|
||||
304
docs/users/kiro-integration.md
Normal file
304
docs/users/kiro-integration.md
Normal file
@@ -0,0 +1,304 @@
|
||||
# Kiro CLI Integration Guide
|
||||
|
||||
## Overview
|
||||
|
||||
This guide explains how to use Antigravity Awesome Skills with **Kiro CLI**, AWS's agentic AI-powered coding assistant.
|
||||
|
||||
## What is Kiro?
|
||||
|
||||
Kiro is AWS's agentic AI IDE that combines:
|
||||
|
||||
- **Autonomous coding agents** that work independently for extended periods
|
||||
- **Context-aware assistance** with deep understanding of your codebase
|
||||
- **AWS service integration** with native support for CDK, SAM, and Terraform
|
||||
- **MCP (Model Context Protocol)** for secure external API and database calls
|
||||
- **Spec-driven development** that turns natural language into structured specifications
|
||||
|
||||
## Why Use Skills with Kiro?
|
||||
|
||||
Kiro's agentic capabilities are enhanced by skills that provide:
|
||||
|
||||
- **Domain expertise** across 1,204+ specialized areas
|
||||
- **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
|
||||
- **Workflow automation** for common development tasks
|
||||
- **AWS-specific patterns** for serverless, infrastructure, and cloud architecture
|
||||
|
||||
## Installation
|
||||
|
||||
### Quick Install
|
||||
|
||||
```bash
|
||||
# Install to Kiro's default skills directory
|
||||
npx antigravity-awesome-skills --kiro
|
||||
```
|
||||
|
||||
This installs skills to `~/.kiro/skills/`
|
||||
|
||||
### Manual Installation
|
||||
|
||||
```bash
|
||||
# Clone directly to Kiro's skills directory
|
||||
git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.kiro/skills
|
||||
```
|
||||
|
||||
### Verification
|
||||
|
||||
```bash
|
||||
# Verify installation
|
||||
test -d ~/.kiro/skills && echo "✓ Skills installed successfully"
|
||||
ls ~/.kiro/skills/skills/ | head -10
|
||||
```
|
||||
|
||||
## Using Skills with Kiro
|
||||
|
||||
### Basic Invocation
|
||||
|
||||
Kiro uses natural language prompts to invoke skills:
|
||||
|
||||
```
|
||||
Use the @brainstorming skill to help me design a serverless API
|
||||
```
|
||||
|
||||
```
|
||||
Apply @aws-serverless patterns to this Lambda function
|
||||
```
|
||||
|
||||
```
|
||||
Run @security-audit on my CDK stack
|
||||
```
|
||||
|
||||
### Recommended Skills for Kiro Users
|
||||
|
||||
#### AWS & Cloud Infrastructure
|
||||
|
||||
- `@aws-serverless` - Serverless architecture patterns
|
||||
- `@aws-cdk` - AWS CDK best practices
|
||||
- `@aws-sam` - SAM template patterns
|
||||
- `@terraform-expert` - Terraform infrastructure as code
|
||||
- `@docker-expert` - Container optimization
|
||||
- `@kubernetes-expert` - K8s deployment patterns
|
||||
|
||||
#### Architecture & Design
|
||||
|
||||
- `@architecture` - System design and ADRs
|
||||
- `@c4-context` - C4 model diagrams
|
||||
- `@senior-architect` - Scalable architecture patterns
|
||||
- `@microservices-patterns` - Microservices design
|
||||
|
||||
#### Security
|
||||
|
||||
- `@api-security-best-practices` - API security hardening
|
||||
- `@vulnerability-scanner` - Security vulnerability detection
|
||||
- `@owasp-top-10` - OWASP security patterns
|
||||
- `@aws-security-best-practices` - AWS security configuration
|
||||
|
||||
#### Development
|
||||
|
||||
- `@typescript-expert` - TypeScript best practices
|
||||
- `@python-patterns` - Python design patterns
|
||||
- `@react-patterns` - React component patterns
|
||||
- `@test-driven-development` - TDD workflows
|
||||
|
||||
#### DevOps & Automation
|
||||
|
||||
- `@ci-cd-pipeline` - CI/CD automation
|
||||
- `@github-actions` - GitHub Actions workflows
|
||||
- `@monitoring-observability` - Observability patterns
|
||||
- `@incident-response` - Incident management
|
||||
|
||||
## Kiro-Specific Workflows
|
||||
|
||||
### 1. Serverless Application Development
|
||||
|
||||
```
|
||||
1. Use @brainstorming to design the application architecture
|
||||
2. Apply @aws-serverless to create Lambda functions
|
||||
3. Use @aws-cdk to generate infrastructure code
|
||||
4. Run @test-driven-development to add tests
|
||||
5. Apply @ci-cd-pipeline to set up deployment
|
||||
```
|
||||
|
||||
### 2. Infrastructure as Code
|
||||
|
||||
```
|
||||
1. Use @architecture to document the system design
|
||||
2. Apply @terraform-expert to write Terraform modules
|
||||
3. Run @security-audit to check for vulnerabilities
|
||||
4. Use @documentation to generate README and runbooks
|
||||
```
|
||||
|
||||
### 3. API Development
|
||||
|
||||
```
|
||||
1. Use @api-design to plan endpoints
|
||||
2. Apply @typescript-expert for implementation
|
||||
3. Run @api-security-best-practices for hardening
|
||||
4. Use @openapi-spec to generate documentation
|
||||
```
|
||||
|
||||
## Advanced Features
|
||||
|
||||
### MCP Integration
|
||||
|
||||
Kiro's MCP support allows skills to:
|
||||
|
||||
- Call external APIs securely
|
||||
- Query databases with context
|
||||
- Integrate with AWS services
|
||||
- Access documentation in real-time
|
||||
|
||||
Skills that leverage MCP:
|
||||
|
||||
- `@rag-engineer` - RAG system implementation
|
||||
- `@langgraph` - Agent workflow orchestration
|
||||
- `@prompt-engineer` - LLM prompt optimization
|
||||
|
||||
### Autonomous Operation
|
||||
|
||||
Kiro can work independently for extended periods. Use skills to guide long-running tasks:
|
||||
|
||||
```
|
||||
Use @systematic-debugging to investigate and fix all TypeScript errors in the codebase,
|
||||
then apply @test-driven-development to add missing tests, and finally run @documentation
|
||||
to update all README files.
|
||||
```
|
||||
|
||||
### Context-Aware Assistance
|
||||
|
||||
Kiro maintains deep context. Reference multiple skills in complex workflows:
|
||||
|
||||
```
|
||||
I'm building a SaaS application. Use @brainstorming for the MVP plan,
|
||||
@aws-serverless for the backend, @react-patterns for the frontend,
|
||||
@stripe-integration for payments, and @security-audit for hardening.
|
||||
```
|
||||
|
||||
## Bundles for Kiro Users
|
||||
|
||||
Pre-curated skill collections optimized for common Kiro use cases:
|
||||
|
||||
### AWS Developer Bundle
|
||||
|
||||
- `@aws-serverless`
|
||||
- `@aws-cdk`
|
||||
- `@aws-sam`
|
||||
- `@lambda-best-practices`
|
||||
- `@dynamodb-patterns`
|
||||
- `@api-gateway-patterns`
|
||||
|
||||
### Full-Stack AWS Bundle
|
||||
|
||||
- `@aws-serverless`
|
||||
- `@react-patterns`
|
||||
- `@typescript-expert`
|
||||
- `@api-design`
|
||||
- `@test-driven-development`
|
||||
- `@ci-cd-pipeline`
|
||||
|
||||
### DevOps & Infrastructure Bundle
|
||||
|
||||
- `@terraform-expert`
|
||||
- `@docker-expert`
|
||||
- `@kubernetes-expert`
|
||||
- `@monitoring-observability`
|
||||
- `@incident-response`
|
||||
- `@security-audit`
|
||||
|
||||
See [bundles.md](bundles.md) for complete bundle listings.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Skills Not Loading
|
||||
|
||||
```bash
|
||||
# Check installation path
|
||||
ls -la ~/.kiro/skills/
|
||||
|
||||
# Reinstall if needed
|
||||
rm -rf ~/.kiro/skills
|
||||
npx antigravity-awesome-skills --kiro
|
||||
```
|
||||
|
||||
### Skill Not Found
|
||||
|
||||
Ensure you're using the correct skill name:
|
||||
|
||||
```bash
|
||||
# List all available skills
|
||||
ls ~/.kiro/skills/skills/
|
||||
```
|
||||
|
||||
### Permission Issues
|
||||
|
||||
```bash
|
||||
# Fix permissions
|
||||
chmod -R 755 ~/.kiro/skills/
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Start with bundles** - Use pre-curated collections for your role
|
||||
2. **Combine skills** - Reference multiple skills in complex tasks
|
||||
3. **Be specific** - Clearly state which skill to use and what to do
|
||||
4. **Iterate** - Let Kiro work autonomously, then refine with additional skills
|
||||
5. **Document** - Use `@documentation` to keep your codebase well-documented
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1: Build a Serverless API
|
||||
|
||||
```
|
||||
I need to build a REST API for a todo application using AWS Lambda and DynamoDB.
|
||||
|
||||
Use @brainstorming to design the architecture, then apply @aws-serverless
|
||||
to implement the Lambda functions, @dynamodb-patterns for data modeling,
|
||||
and @api-security-best-practices for security hardening.
|
||||
|
||||
Generate the infrastructure using @aws-cdk and add tests with @test-driven-development.
|
||||
```
|
||||
|
||||
### Example 2: Migrate to Microservices
|
||||
|
||||
```
|
||||
I want to break down this monolithic application into microservices.
|
||||
|
||||
Use @architecture to create an ADR for the migration strategy,
|
||||
apply @microservices-patterns for service boundaries,
|
||||
@docker-expert for containerization, and @kubernetes-expert for orchestration.
|
||||
|
||||
Document the migration plan with @documentation.
|
||||
```
|
||||
|
||||
### Example 3: Security Audit
|
||||
|
||||
```
|
||||
Perform a comprehensive security audit of this application.
|
||||
|
||||
Use @security-audit to scan for vulnerabilities, @owasp-top-10 to check
|
||||
for common issues, @api-security-best-practices for API hardening,
|
||||
and @aws-security-best-practices for cloud configuration.
|
||||
|
||||
Generate a report with findings and remediation steps.
|
||||
```
|
||||
|
||||
## Resources
|
||||
|
||||
- [Kiro Official Documentation](https://kiro.dev)
|
||||
- [AWS Blog: Transform DevOps with Kiro](https://aws.amazon.com/blogs/publicsector/transform-devops-practice-with-kiro-ai-powered-agents/)
|
||||
- [Complete Skills Catalog](../../CATALOG.md)
|
||||
- [Usage Guide](usage.md)
|
||||
- [Workflow Examples](workflows.md)
|
||||
|
||||
## Contributing
|
||||
|
||||
Found a Kiro-specific use case or workflow? Contribute to this guide:
|
||||
|
||||
1. Fork the repository
|
||||
2. Add your examples to this file
|
||||
3. Submit a pull request
|
||||
|
||||
## Support
|
||||
|
||||
- **Issues**: [GitHub Issues](https://github.com/sickn33/antigravity-awesome-skills/issues)
|
||||
- **Discussions**: [GitHub Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions)
|
||||
- **Community**: [Community Guidelines](../contributors/community-guidelines.md)
|
||||
1722
docs/users/security-skills.md
Normal file
1722
docs/users/security-skills.md
Normal file
File diff suppressed because it is too large
Load Diff
394
docs/users/usage.md
Normal file
394
docs/users/usage.md
Normal file
@@ -0,0 +1,394 @@
|
||||
# 📖 Usage Guide: How to Actually Use These Skills
|
||||
|
||||
> **Confused after installation?** This guide walks you through exactly what to do next, step by step.
|
||||
|
||||
---
|
||||
|
||||
## 🤔 "I just installed the repository. Now what?"
|
||||
|
||||
Great question! Here's what just happened and what to do next:
|
||||
|
||||
### What You Just Did
|
||||
|
||||
When you ran `npx antigravity-awesome-skills` or cloned the repository, you:
|
||||
|
||||
✅ **Downloaded 1,204+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or `~/.agent/skills/` if you used `--path`)
|
||||
✅ **Made them available** to your AI assistant
|
||||
❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
|
||||
|
||||
Think of it like installing a toolbox. You have all the tools now, but you need to **pick which ones to use** for each job.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Step 1: Understanding "Bundles" (This is NOT Another Install!)
|
||||
|
||||
**Common confusion:** "Do I need to download each skill separately?"
|
||||
|
||||
**Answer: NO!** Here's what bundles actually are:
|
||||
|
||||
### What Bundles Are
|
||||
|
||||
Bundles are **recommended lists** of skills grouped by role. They help you decide which skills to start using.
|
||||
|
||||
**Analogy:**
|
||||
|
||||
- You installed a toolbox with 1,204+ tools (✅ done)
|
||||
- Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools"
|
||||
- You don't install bundles—you **pick skills from them**
|
||||
|
||||
### What Bundles Are NOT
|
||||
|
||||
❌ Separate installations
|
||||
❌ Different download commands
|
||||
❌ Something you need to "activate"
|
||||
|
||||
### Example: The "Web Wizard" Bundle
|
||||
|
||||
When you see the [Web Wizard bundle](bundles.md#-the-web-wizard-pack), it lists:
|
||||
|
||||
- `frontend-design`
|
||||
- `react-best-practices`
|
||||
- `tailwind-patterns`
|
||||
- etc.
|
||||
|
||||
These are **recommendations** for which skills a web developer should try first. They're already installed—you just need to **use them in your prompts**.
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Step 2: How to Actually Execute/Use a Skill
|
||||
|
||||
This is the part that should have been explained better! Here's how to use skills:
|
||||
|
||||
### The Simple Answer
|
||||
|
||||
**Just mention the skill name in your conversation with your AI assistant.**
|
||||
|
||||
### Different Tools, Different Syntax
|
||||
|
||||
The exact syntax varies by tool, but it's always simple:
|
||||
|
||||
#### Claude Code (CLI)
|
||||
|
||||
```bash
|
||||
# In your terminal/chat with Claude Code:
|
||||
>> Use @brainstorming to help me design a todo app
|
||||
```
|
||||
|
||||
#### Cursor (IDE)
|
||||
|
||||
```bash
|
||||
# In the Cursor chat panel:
|
||||
@brainstorming help me design a todo app
|
||||
```
|
||||
|
||||
#### Gemini CLI
|
||||
|
||||
```bash
|
||||
# In your conversation with Gemini:
|
||||
Use the brainstorming skill to help me plan my app
|
||||
```
|
||||
|
||||
#### Codex CLI
|
||||
|
||||
```bash
|
||||
# In your conversation with Codex:
|
||||
Apply @brainstorming to design a new feature
|
||||
```
|
||||
|
||||
#### Antigravity IDE
|
||||
|
||||
```bash
|
||||
# In agent mode:
|
||||
Use @brainstorming to plan this feature
|
||||
```
|
||||
|
||||
> **Pro Tip:** Most modern tools use the `@skill-name` syntax. When in doubt, try that first!
|
||||
|
||||
---
|
||||
|
||||
## 💬 Step 3: What Should My Prompts Look Like?
|
||||
|
||||
Here are **real-world examples** of good prompts:
|
||||
|
||||
### Example 1: Starting a New Project
|
||||
|
||||
**Bad Prompt:**
|
||||
|
||||
> "Help me build a todo app"
|
||||
|
||||
**Good Prompt:**
|
||||
|
||||
> "Use @brainstorming to help me design a todo app with user authentication and cloud sync"
|
||||
|
||||
**Why it's better:** You're explicitly invoking the skill and providing context.
|
||||
|
||||
---
|
||||
|
||||
### Example 2: Reviewing Code
|
||||
|
||||
**Bad Prompt:**
|
||||
|
||||
> "Check my code"
|
||||
|
||||
**Good Prompt:**
|
||||
|
||||
> "Use @lint-and-validate to check `src/components/Button.tsx` for issues"
|
||||
|
||||
**Why it's better:** Specific skill + specific file = precise results.
|
||||
|
||||
---
|
||||
|
||||
### Example 3: Security Audit
|
||||
|
||||
**Bad Prompt:**
|
||||
|
||||
> "Make my API secure"
|
||||
|
||||
**Good Prompt:**
|
||||
|
||||
> "Use @api-security-best-practices to review my REST endpoints in `routes/api/users.js`"
|
||||
|
||||
**Why it's better:** The AI knows exactly which skill's standards to apply.
|
||||
|
||||
---
|
||||
|
||||
### Example 4: Combining Multiple Skills
|
||||
|
||||
**Good Prompt:**
|
||||
|
||||
> "Use @brainstorming to design a payment flow, then apply @stripe-integration to implement it"
|
||||
|
||||
**Why it's good:** You can chain skills together in a single prompt!
|
||||
|
||||
---
|
||||
|
||||
## 🎓 Step 4: Your First Skill (Hands-On Tutorial)
|
||||
|
||||
Let's actually use a skill right now. Follow these steps:
|
||||
|
||||
### Scenario: You want to plan a new feature
|
||||
|
||||
1. **Pick a skill:** Let's use `brainstorming` (from the "Essentials" bundle)
|
||||
|
||||
2. **Open your AI assistant** (Claude Code, Cursor, etc.)
|
||||
|
||||
3. **Type this exact prompt:**
|
||||
|
||||
```
|
||||
Use @brainstorming to help me design a user profile page for my app
|
||||
```
|
||||
|
||||
4. **Press Enter**
|
||||
|
||||
5. **What happens next:**
|
||||
- The AI loads the brainstorming skill
|
||||
- It will start asking you structured questions (one at a time)
|
||||
- It will guide you through understanding, requirements, and design
|
||||
- You answer each question, and it builds a complete spec
|
||||
|
||||
6. **Result:** You'll end up with a detailed design document—without writing a single line of code yet!
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ Step 5: Picking Your First Skills (Practical Advice)
|
||||
|
||||
Don't try to use all 1,204+ skills at once. Here's a sensible approach:
|
||||
|
||||
### Start with "The Essentials" (5 skills, everyone needs these)
|
||||
|
||||
1. **`@brainstorming`** - Plan before you build
|
||||
2. **`@lint-and-validate`** - Keep code clean
|
||||
3. **`@git-pushing`** - Save work safely
|
||||
4. **`@systematic-debugging`** - Fix bugs faster
|
||||
5. **`@concise-planning`** - Organize tasks
|
||||
|
||||
**How to use them:**
|
||||
|
||||
- Before writing new code → `@brainstorming`
|
||||
- After writing code → `@lint-and-validate`
|
||||
- Before committing → `@git-pushing`
|
||||
- When stuck → `@systematic-debugging`
|
||||
|
||||
### Then Add Role-Specific Skills (5-10 more)
|
||||
|
||||
Find your role in [bundles.md](bundles.md) and pick 5-10 skills from that bundle.
|
||||
|
||||
**Example for Web Developer:**
|
||||
|
||||
- `@frontend-design`
|
||||
- `@react-best-practices`
|
||||
- `@tailwind-patterns`
|
||||
- `@seo-audit`
|
||||
|
||||
**Example for Security Engineer:**
|
||||
|
||||
- `@api-security-best-practices`
|
||||
- `@vulnerability-scanner`
|
||||
- `@ethical-hacking-methodology`
|
||||
|
||||
### Finally, Add On-Demand Skills (as needed)
|
||||
|
||||
Keep the [CATALOG.md](../../CATALOG.md) open as reference. When you need something specific:
|
||||
|
||||
> "I need to integrate Stripe payments"
|
||||
> → Search catalog → Find `@stripe-integration` → Use it!
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Complete Example: Building a Feature End-to-End
|
||||
|
||||
Let's walk through a realistic scenario:
|
||||
|
||||
### Task: "Add a blog to my Next.js website"
|
||||
|
||||
#### Step 1: Plan (use @brainstorming)
|
||||
|
||||
```
|
||||
You: Use @brainstorming to design a blog system for my Next.js site
|
||||
|
||||
AI: [Asks structured questions about requirements]
|
||||
You: [Answer questions]
|
||||
AI: [Produces detailed design spec]
|
||||
```
|
||||
|
||||
#### Step 2: Implement (use @nextjs-best-practices)
|
||||
|
||||
```
|
||||
You: Use @nextjs-best-practices to scaffold the blog with App Router
|
||||
|
||||
AI: [Creates file structure, sets up routes, adds components]
|
||||
```
|
||||
|
||||
#### Step 3: Style (use @tailwind-patterns)
|
||||
|
||||
```
|
||||
You: Use @tailwind-patterns to make the blog posts look modern
|
||||
|
||||
AI: [Applies Tailwind styling with responsive design]
|
||||
```
|
||||
|
||||
#### Step 4: SEO (use @seo-audit)
|
||||
|
||||
```
|
||||
You: Use @seo-audit to optimize the blog for search engines
|
||||
|
||||
AI: [Adds meta tags, sitemaps, structured data]
|
||||
```
|
||||
|
||||
#### Step 5: Test & Deploy
|
||||
|
||||
```
|
||||
You: Use @test-driven-development to add tests, then @vercel-deployment to deploy
|
||||
|
||||
AI: [Creates tests, sets up CI/CD, deploys to Vercel]
|
||||
```
|
||||
|
||||
**Result:** Professional blog built with best practices, without manually researching each step!
|
||||
|
||||
---
|
||||
|
||||
## 🆘 Common Questions
|
||||
|
||||
### "Which tool should I use? Claude Code, Cursor, Gemini?"
|
||||
|
||||
**Any of them!** Skills work universally. Pick the tool you already use or prefer:
|
||||
|
||||
- **Claude Code** - Best for terminal/CLI workflows
|
||||
- **Cursor** - Best for IDE integration
|
||||
- **Gemini CLI** - Best for Google ecosystem
|
||||
- **Codex CLI** - Best for OpenAI ecosystem
|
||||
|
||||
### "Can I see all available skills?"
|
||||
|
||||
Yes! Three ways:
|
||||
|
||||
1. Browse [CATALOG.md](../../CATALOG.md) (searchable list)
|
||||
2. Run `ls ~/.agent/skills/` (if installed there)
|
||||
3. Ask your AI: "What skills do you have for [topic]?"
|
||||
|
||||
### "Do I need to restart my IDE after installing?"
|
||||
|
||||
Usually no, but if your AI doesn't recognize a skill:
|
||||
|
||||
1. Try restarting your IDE/CLI
|
||||
2. Check the installation path matches your tool
|
||||
3. Try the explicit path: `npx antigravity-awesome-skills --claude` (or `--cursor`, `--gemini`, etc.)
|
||||
|
||||
### "Can I create my own skills?"
|
||||
|
||||
Yes! Use the `@skill-creator` skill:
|
||||
|
||||
```
|
||||
Use @skill-creator to help me build a custom skill for [your task]
|
||||
```
|
||||
|
||||
### "What if a skill doesn't work as expected?"
|
||||
|
||||
1. Check the skill's SKILL.md file directly: `~/.agent/skills/[skill-name]/SKILL.md`
|
||||
2. Read the description to ensure you're using it correctly
|
||||
3. [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues) with details
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Quick Reference Card
|
||||
|
||||
**Save this for quick lookup:**
|
||||
|
||||
| Task | Skill to Use | Example Prompt |
|
||||
| ---------------- | ------------------------------ | --------------------------------------------------- |
|
||||
| Plan new feature | `@brainstorming` | `Use @brainstorming to design a login system` |
|
||||
| Review code | `@lint-and-validate` | `Use @lint-and-validate on src/app.js` |
|
||||
| Debug issue | `@systematic-debugging` | `Use @systematic-debugging to fix login error` |
|
||||
| Security audit | `@api-security-best-practices` | `Use @api-security-best-practices on my API routes` |
|
||||
| SEO check | `@seo-audit` | `Use @seo-audit on my landing page` |
|
||||
| React component | `@react-patterns` | `Use @react-patterns to build a form component` |
|
||||
| Deploy app | `@vercel-deployment` | `Use @vercel-deployment to ship this to production` |
|
||||
|
||||
---
|
||||
|
||||
## 🚦 Next Steps
|
||||
|
||||
Now that you understand how to use skills:
|
||||
|
||||
1. ✅ **Try one skill right now** - Start with `@brainstorming` on any idea you have
|
||||
2. 📚 **Pick 3-5 skills** from your role's bundle in [bundles.md](bundles.md)
|
||||
3. 🔖 **Bookmark** [CATALOG.md](../../CATALOG.md) for when you need something specific
|
||||
4. 🎯 **Try a workflow** from [workflows.md](workflows.md) for a complete end-to-end process
|
||||
|
||||
---
|
||||
|
||||
## 💡 Pro Tips for Maximum Effectiveness
|
||||
|
||||
### Tip 1: Start Every Feature with @brainstorming
|
||||
|
||||
> Before writing code, use `@brainstorming` to plan. You'll save hours of refactoring.
|
||||
|
||||
### Tip 2: Chain Skills in Order
|
||||
|
||||
> Don't try to do everything at once. Use skills sequentially: Plan → Build → Test → Deploy
|
||||
|
||||
### Tip 3: Be Specific in Prompts
|
||||
|
||||
> Bad: "Use @react-patterns"
|
||||
> Good: "Use @react-patterns to build a modal component with animations"
|
||||
|
||||
### Tip 4: Reference File Paths
|
||||
|
||||
> Help the AI focus: "Use @security-auditor on routes/api/auth.js"
|
||||
|
||||
### Tip 5: Combine Skills for Complex Tasks
|
||||
|
||||
> "Use @brainstorming to design, then @test-driven-development to implement with tests"
|
||||
|
||||
---
|
||||
|
||||
## 📞 Still Confused?
|
||||
|
||||
If something still doesn't make sense:
|
||||
|
||||
1. Check the [FAQ](faq.md)
|
||||
2. See [Real-World Examples](../contributors/examples.md)
|
||||
3. [Open a Discussion](https://github.com/sickn33/antigravity-awesome-skills/discussions)
|
||||
4. [File an Issue](https://github.com/sickn33/antigravity-awesome-skills/issues) to help us improve this guide!
|
||||
|
||||
Remember: You're not alone! The whole point of this project is to make AI assistants easier to use. If this guide didn't help, let us know so we can fix it. 🙌
|
||||
509
docs/users/visual-guide.md
Normal file
509
docs/users/visual-guide.md
Normal file
@@ -0,0 +1,509 @@
|
||||
# Visual Quick Start Guide
|
||||
|
||||
**Learn by seeing!** This guide uses diagrams and visual examples to help you understand skills.
|
||||
|
||||
---
|
||||
|
||||
## The Big Picture
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ YOU (Developer) │
|
||||
│ ↓ │
|
||||
│ "Help me build a payment system" │
|
||||
│ ↓ │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ AI ASSISTANT │
|
||||
│ ↓ │
|
||||
│ Loads @stripe-integration skill │
|
||||
│ ↓ │
|
||||
│ Becomes an expert in Stripe payments │
|
||||
│ ↓ │
|
||||
│ Provides specialized help with code examples │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📦 Repository Structure (Visual)
|
||||
|
||||
```
|
||||
antigravity-awesome-skills/
|
||||
│
|
||||
├── 📄 README.md ← Overview and quick start
|
||||
├── 📄 CONTRIBUTING.md ← Contributor workflow
|
||||
├── 📄 CATALOG.md ← Full generated catalog
|
||||
│
|
||||
├── 📁 skills/ ← 1,204+ skills live here
|
||||
│ │
|
||||
│ ├── 📁 brainstorming/
|
||||
│ │ └── 📄 SKILL.md ← Skill definition
|
||||
│ │
|
||||
│ ├── 📁 stripe-integration/
|
||||
│ │ ├── 📄 SKILL.md
|
||||
│ │ └── 📁 examples/ ← Optional extras
|
||||
│ │
|
||||
│ ├── 📁 game-development/
|
||||
│ │ └── 📁 2d-games/
|
||||
│ │ └── 📄 SKILL.md ← Nested skills also supported
|
||||
│ │
|
||||
│ └── ... (1,200+ total)
|
||||
│
|
||||
├── 📁 apps/
|
||||
│ └── 📁 web-app/ ← Interactive browser
|
||||
│
|
||||
├── 📁 tools/
|
||||
│ ├── 📁 scripts/ ← Validators and generators
|
||||
│ ├── 📁 lib/ ← Shared helpers
|
||||
│ └── 📁 bin/ ← Installer entrypoint
|
||||
│
|
||||
└── 📁 docs/
|
||||
├── 📁 users/ ← Getting started, bundles, workflows
|
||||
├── 📁 contributors/ ← Template, anatomy, quality bar
|
||||
├── 📁 maintainers/ ← Release and maintenance docs
|
||||
└── 📁 sources/ ← Attribution and licenses
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## How Skills Work (Flow Diagram)
|
||||
|
||||
```
|
||||
┌──────────────┐
|
||||
│ 1. INSTALL │ Copy skills to .agent/skills/
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 2. INVOKE │ Type: @skill-name in AI chat
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 3. LOAD │ AI reads SKILL.md file
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 4. EXECUTE │ AI follows skill instructions
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 5. RESULT │ You get specialized help!
|
||||
└──────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Skill Categories (Visual Map)
|
||||
|
||||
```
|
||||
┌─────────────────────────┐
|
||||
│ 1,204+ SKILLS │
|
||||
└────────────┬────────────┘
|
||||
│
|
||||
┌────────────────────────┼────────────────────────┐
|
||||
│ │ │
|
||||
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
|
||||
│ PRODUCT │ │ DEVELOPMENT │ │ SECURITY │
|
||||
│ & UX │ │ & TESTING │ │ & RELIAB. │
|
||||
└────┬────┘ └──────┬──────┘ └──────┬──────┘
|
||||
│ │ │
|
||||
• Brainstorming • React / Next.js • AppSec reviews
|
||||
• Design systems • TDD / debugging • Pentest guides
|
||||
• Copywriting • API / backend • Cloud hardening
|
||||
• Incident response
|
||||
│ │ │
|
||||
└────────────────────────┼────────────────────────┘
|
||||
│
|
||||
┌────────────────────────┼────────────────────────┐
|
||||
│ │ │
|
||||
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
|
||||
│ AI │ │ DATA / OPS │ │ DOCS / OSS │
|
||||
│ AGENTS │ │ & CLOUD │ │ MAINTENANCE │
|
||||
└────┬────┘ └──────┬──────┘ └──────┬──────┘
|
||||
│ │ │
|
||||
• RAG systems • SQL / analytics • Release flow
|
||||
• LangGraph • Docker / K8s • Changelog
|
||||
• Prompt engineering • Terraform / AWS • PR / review
|
||||
• Tooling / MCP • Observability • Skill authoring
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Skill File Anatomy (Visual)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ SKILL.md │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌───────────────────────────────────────────────┐ │
|
||||
│ │ FRONTMATTER (Metadata) │ │
|
||||
│ │ ───────────────────────────────────────────── │ │
|
||||
│ │ --- │ │
|
||||
│ │ name: my-skill │ │
|
||||
│ │ description: "What this skill does" │ │
|
||||
│ │ --- │ │
|
||||
│ └───────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ ┌───────────────────────────────────────────────┐ │
|
||||
│ │ CONTENT (Instructions) │ │
|
||||
│ │ ───────────────────────────────────────────── │ │
|
||||
│ │ │ │
|
||||
│ │ # Skill Title │ │
|
||||
│ │ │ │
|
||||
│ │ ## Overview │ │
|
||||
│ │ What this skill does... │ │
|
||||
│ │ │ │
|
||||
│ │ ## When to Use │ │
|
||||
│ │ - Use when... │ │
|
||||
│ │ │ │
|
||||
│ │ ## Instructions │ │
|
||||
│ │ 1. First step... │ │
|
||||
│ │ 2. Second step... │ │
|
||||
│ │ │ │
|
||||
│ │ ## Examples │ │
|
||||
│ │ ```javascript │ │
|
||||
│ │ // Example code │ │
|
||||
│ │ ``` │ │
|
||||
│ │ │ │
|
||||
│ └───────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Installation (Visual Steps)
|
||||
|
||||
### Step 1: Clone the Repository
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Terminal │
|
||||
├─────────────────────────────────────────┤
|
||||
│ $ git clone https://github.com/ │
|
||||
│ sickn33/antigravity-awesome-skills │
|
||||
│ .agent/skills │
|
||||
│ │
|
||||
│ ✓ Cloning into '.agent/skills'... │
|
||||
│ ✓ Done! │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Step 2: Verify Installation
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ File Explorer │
|
||||
├─────────────────────────────────────────┤
|
||||
│ 📁 .agent/ │
|
||||
│ └── 📁 skills/ │
|
||||
│ ├── 📁 brainstorming/ │
|
||||
│ ├── 📁 stripe-integration/ │
|
||||
│ ├── 📁 react-best-practices/ │
|
||||
│ └── ... (1,200+ total) │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Step 3: Use a Skill
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ AI Assistant Chat │
|
||||
├─────────────────────────────────────────┤
|
||||
│ You: @brainstorming help me design │
|
||||
│ a todo app │
|
||||
│ │
|
||||
│ AI: Great! Let me help you think │
|
||||
│ through this. First, let's │
|
||||
│ understand your requirements... │
|
||||
│ │
|
||||
│ What's the primary use case? │
|
||||
│ a) Personal task management │
|
||||
│ b) Team collaboration │
|
||||
│ c) Project planning │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Example: Using a Skill (Step-by-Step)
|
||||
|
||||
### Scenario: You want to add Stripe payments to your app
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 1: Identify the Need │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ "I need to add payment processing to my app" │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 2: Find the Right Skill │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ Search: "payment" or "stripe" │
|
||||
│ Found: @stripe-integration │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 3: Invoke the Skill │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ You: @stripe-integration help me add subscription billing │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 4: AI Loads Skill Knowledge │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ • Stripe API patterns │
|
||||
│ • Webhook handling │
|
||||
│ • Subscription management │
|
||||
│ • Best practices │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ STEP 5: Get Expert Help │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ AI provides: │
|
||||
│ • Code examples │
|
||||
│ • Setup instructions │
|
||||
│ • Security considerations │
|
||||
│ • Testing strategies │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Finding Skills (Visual Guide)
|
||||
|
||||
### Method 1: Browse by Category
|
||||
```
|
||||
README.md → Scroll to "Full Skill Registry" → Find category → Pick skill
|
||||
```
|
||||
|
||||
### Method 2: Search by Keyword
|
||||
```
|
||||
Terminal → ls skills/ | grep "keyword" → See matching skills
|
||||
```
|
||||
|
||||
### Method 3: Use the Index
|
||||
```
|
||||
Open skills_index.json → Search for keyword → Find skill path
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Creating Your First Skill (Visual Workflow)
|
||||
|
||||
```
|
||||
┌──────────────┐
|
||||
│ 1. IDEA │ "I want to share my Docker knowledge"
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 2. CREATE │ mkdir skills/docker-mastery
|
||||
└──────┬───────┘ touch skills/docker-mastery/SKILL.md
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 3. WRITE │ Add frontmatter + content
|
||||
└──────┬───────┘ (Use docs/contributors/skill-template.md)
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 4. TEST │ Copy to .agent/skills/
|
||||
└──────┬───────┘ Try: @docker-mastery
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 5. VALIDATE │ npm run validate
|
||||
└──────┬───────┘
|
||||
│
|
||||
↓
|
||||
┌──────────────┐
|
||||
│ 6. SUBMIT │ git commit + push + Pull Request
|
||||
└──────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Skill Complexity Levels
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ SKILL COMPLEXITY │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ SIMPLE STANDARD COMPLEX │
|
||||
│ ────── ──────── ─────── │
|
||||
│ │
|
||||
│ • 1 file • 1 file • Multiple │
|
||||
│ • 100-200 words • 300-800 words • 800-2000 │
|
||||
│ • Basic structure • Full structure • Scripts │
|
||||
│ • No extras • Examples • Examples │
|
||||
│ • Best practices • Templates│
|
||||
│ • Docs │
|
||||
│ Example: Example: Example: │
|
||||
│ git-pushing brainstorming loki-mode │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Contribution Impact (Visual)
|
||||
|
||||
```
|
||||
Your Contribution
|
||||
│
|
||||
├─→ Improves Documentation
|
||||
│ │
|
||||
│ └─→ Helps 1000s of developers understand
|
||||
│
|
||||
├─→ Creates New Skill
|
||||
│ │
|
||||
│ └─→ Enables new capabilities for everyone
|
||||
│
|
||||
├─→ Fixes Bug/Typo
|
||||
│ │
|
||||
│ └─→ Prevents confusion for future users
|
||||
│
|
||||
└─→ Adds Example
|
||||
│
|
||||
└─→ Makes learning easier for beginners
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Learning Path (Visual Roadmap)
|
||||
|
||||
```
|
||||
START HERE
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Read │
|
||||
│ GETTING_STARTED │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Try 2-3 Skills │
|
||||
│ in AI Assistant │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Read │
|
||||
│ SKILL_ANATOMY │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Study Existing │
|
||||
│ Skills │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Create Simple │
|
||||
│ Skill │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Read │
|
||||
│ CONTRIBUTING │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
┌─────────────────┐
|
||||
│ Submit PR │
|
||||
└────────┬────────┘
|
||||
│
|
||||
↓
|
||||
CONTRIBUTOR! 🎉
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 💡 Quick Tips (Visual Cheatsheet)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ QUICK REFERENCE │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 📥 INSTALL │
|
||||
│ git clone [repo] .agent/skills │
|
||||
│ │
|
||||
│ 🎯 USE │
|
||||
│ @skill-name [your request] │
|
||||
│ │
|
||||
│ 🔍 FIND │
|
||||
│ ls skills/ | grep "keyword" │
|
||||
│ │
|
||||
│ ✅ VALIDATE │
|
||||
│ npm run validate │
|
||||
│ │
|
||||
│ 📝 CREATE │
|
||||
│ 1. mkdir skills/my-skill │
|
||||
│ 2. Create SKILL.md with frontmatter │
|
||||
│ 3. Add content │
|
||||
│ 4. Test & validate │
|
||||
│ 5. Submit PR │
|
||||
│ │
|
||||
│ 🆘 HELP │
|
||||
│ • docs/users/getting-started.md │
|
||||
│ • CONTRIBUTING.md │
|
||||
│ • docs/contributors/skill-anatomy.md │
|
||||
│ • GitHub Issues - Ask questions │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Success Stories (Visual Timeline)
|
||||
|
||||
```
|
||||
Day 1: Install skills
|
||||
│
|
||||
└─→ "Wow, @brainstorming helped me design my app!"
|
||||
|
||||
Day 3: Use 5 different skills
|
||||
│
|
||||
└─→ "These skills save me so much time!"
|
||||
|
||||
Week 1: Create first skill
|
||||
│
|
||||
└─→ "I shared my expertise as a skill!"
|
||||
|
||||
Week 2: Skill gets merged
|
||||
│
|
||||
└─→ "My skill is helping others! 🎉"
|
||||
|
||||
Month 1: Regular contributor
|
||||
│
|
||||
└─→ "I've contributed 5 skills and improved docs!"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. ✅ **Understand** the visual structure
|
||||
2. ✅ **Install** skills in your AI tool
|
||||
3. ✅ **Try** 2-3 skills from different categories
|
||||
4. ✅ **Read** CONTRIBUTING.md
|
||||
5. ✅ **Create** your first skill
|
||||
6. ✅ **Share** with the community
|
||||
|
||||
---
|
||||
|
||||
**Visual learner?** This guide should help! Still have questions? Check out:
|
||||
- [getting-started.md](getting-started.md) - Text-based intro
|
||||
- [skill-anatomy.md](../contributors/skill-anatomy.md) - Detailed breakdown
|
||||
- [CONTRIBUTING.md](../../CONTRIBUTING.md) - How to contribute
|
||||
|
||||
**Ready to contribute?** You've got this! 💪
|
||||
215
docs/users/workflows.md
Normal file
215
docs/users/workflows.md
Normal file
@@ -0,0 +1,215 @@
|
||||
# Antigravity Workflows
|
||||
|
||||
> Workflow playbooks to orchestrate multiple skills with less friction.
|
||||
|
||||
## What Is a Workflow?
|
||||
|
||||
A workflow is a guided, step-by-step execution path that combines multiple skills for one concrete outcome.
|
||||
|
||||
- **Bundles** tell you which skills are relevant for a role.
|
||||
- **Workflows** tell you how to use those skills in sequence to complete a real objective.
|
||||
|
||||
If bundles are your toolbox, workflows are your execution playbook.
|
||||
|
||||
---
|
||||
|
||||
## How to Use Workflows
|
||||
|
||||
1. Install the repository once (`npx antigravity-awesome-skills`).
|
||||
2. Pick a workflow matching your immediate goal.
|
||||
3. Execute steps in order and invoke the listed skills in each step.
|
||||
4. Keep output artifacts at each step (plan, decisions, tests, validation evidence).
|
||||
|
||||
You can combine workflows with bundles from [bundles.md](bundles.md) when you need broader coverage.
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Ship a SaaS MVP
|
||||
|
||||
Build and ship a minimal but production-minded SaaS product.
|
||||
|
||||
**Related bundles:** `Essentials`, `Full-Stack Developer`, `QA & Testing`, `DevOps & Cloud`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Local repository and runtime configured.
|
||||
- Clear user problem and MVP scope.
|
||||
- Basic deployment target selected.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Plan the scope**
|
||||
- **Goal:** Define MVP boundaries and acceptance criteria.
|
||||
- **Skills:** [`@brainstorming`](../../skills/brainstorming/), [`@concise-planning`](../../skills/concise-planning/), [`@writing-plans`](../../skills/writing-plans/)
|
||||
- **Prompt example:** `Usa @concise-planning per definire milestones e criteri di accettazione del mio MVP SaaS.`
|
||||
|
||||
2. **Build backend and API**
|
||||
- **Goal:** Implement core entities, APIs, and auth baseline.
|
||||
- **Skills:** [`@backend-dev-guidelines`](../../skills/backend-dev-guidelines/), [`@api-patterns`](../../skills/api-patterns/), [`@database-design`](../../skills/database-design/)
|
||||
- **Prompt example:** `Usa @backend-dev-guidelines per creare API e servizi del dominio billing.`
|
||||
|
||||
3. **Build frontend**
|
||||
- **Goal:** Ship core user flow with clear UX states.
|
||||
- **Skills:** [`@frontend-developer`](../../skills/frontend-developer/), [`@react-patterns`](../../skills/react-patterns/), [`@frontend-design`](../../skills/frontend-design/)
|
||||
- **Prompt example:** `Usa @frontend-developer per implementare onboarding, empty state e dashboard iniziale.`
|
||||
|
||||
4. **Test and validate**
|
||||
- **Goal:** Cover critical user journeys before release.
|
||||
- **Skills:** [`@test-driven-development`](../../skills/test-driven-development/), [`@browser-automation`](../../skills/browser-automation/), `@go-playwright` (optional, Go stack)
|
||||
- **Prompt example:** `Usa @browser-automation per creare test E2E sui flussi signup e checkout.`
|
||||
- **Go note:** Se il progetto QA e tooling sono in Go, preferisci `@go-playwright`.
|
||||
|
||||
5. **Ship safely**
|
||||
- **Goal:** Release with observability and rollback plan.
|
||||
- **Skills:** [`@deployment-procedures`](../../skills/deployment-procedures/), [`@observability-engineer`](../../skills/observability-engineer/)
|
||||
- **Prompt example:** `Usa @deployment-procedures per una checklist di rilascio con rollback.`
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Security Audit for a Web App
|
||||
|
||||
Run a focused security review from scope definition to remediation validation.
|
||||
|
||||
**Related bundles:** `Security Engineer`, `Security Developer`, `Observability & Monitoring`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Explicit authorization for testing.
|
||||
- In-scope targets documented.
|
||||
- Logging and environment details available.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Define scope and threat model**
|
||||
- **Goal:** Identify assets, trust boundaries, and attack paths.
|
||||
- **Skills:** [`@ethical-hacking-methodology`](../../skills/ethical-hacking-methodology/), [`@threat-modeling-expert`](../../skills/threat-modeling-expert/), [`@attack-tree-construction`](../../skills/attack-tree-construction/)
|
||||
- **Prompt example:** `Usa @threat-modeling-expert per mappare asset critici e trust boundaries della mia web app.`
|
||||
|
||||
2. **Review auth and access control**
|
||||
- **Goal:** Detect account takeover and authorization flaws.
|
||||
- **Skills:** [`@broken-authentication`](../../skills/broken-authentication/), [`@auth-implementation-patterns`](../../skills/auth-implementation-patterns/), [`@idor-testing`](../../skills/idor-testing/)
|
||||
- **Prompt example:** `Usa @idor-testing per verificare accessi non autorizzati su endpoint multitenant.`
|
||||
|
||||
3. **Assess API and input security**
|
||||
- **Goal:** Uncover high-impact API and injection vulnerabilities.
|
||||
- **Skills:** [`@api-security-best-practices`](../../skills/api-security-best-practices/), [`@api-fuzzing-bug-bounty`](../../skills/api-fuzzing-bug-bounty/), [`@top-web-vulnerabilities`](../../skills/top-web-vulnerabilities/)
|
||||
- **Prompt example:** `Usa @api-security-best-practices per audit endpoint auth, billing e admin.`
|
||||
|
||||
4. **Harden and verify**
|
||||
- **Goal:** Convert findings into fixes and verify evidence of mitigation.
|
||||
- **Skills:** [`@security-auditor`](../../skills/security-auditor/), [`@sast-configuration`](../../skills/sast-configuration/), [`@verification-before-completion`](../../skills/verification-before-completion/)
|
||||
- **Prompt example:** `Usa @verification-before-completion per provare che le mitigazioni sono effettive.`
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Build an AI Agent System
|
||||
|
||||
Design and deliver a production-grade agent with measurable reliability.
|
||||
|
||||
**Related bundles:** `Agent Architect`, `LLM Application Developer`, `Data Engineering`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Narrow use case with measurable outcomes.
|
||||
- Access to model provider(s) and observability tooling.
|
||||
- Initial dataset or knowledge corpus.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Define target behavior and KPIs**
|
||||
- **Goal:** Set quality, latency, and failure thresholds.
|
||||
- **Skills:** [`@ai-agents-architect`](../../skills/ai-agents-architect/), [`@agent-evaluation`](../../skills/agent-evaluation/), [`@product-manager-toolkit`](../../skills/product-manager-toolkit/)
|
||||
- **Prompt example:** `Usa @agent-evaluation per definire benchmark e criteri di successo del mio agente.`
|
||||
|
||||
2. **Design retrieval and memory**
|
||||
- **Goal:** Build reliable retrieval and context architecture.
|
||||
- **Skills:** [`@llm-app-patterns`](../../skills/llm-app-patterns/), [`@rag-implementation`](../../skills/rag-implementation/), [`@vector-database-engineer`](../../skills/vector-database-engineer/)
|
||||
- **Prompt example:** `Usa @rag-implementation per progettare pipeline di chunking, embedding e retrieval.`
|
||||
|
||||
3. **Implement orchestration**
|
||||
- **Goal:** Implement deterministic orchestration and tool boundaries.
|
||||
- **Skills:** [`@langgraph`](../../skills/langgraph/), [`@mcp-builder`](../../skills/mcp-builder/), [`@workflow-automation`](../../skills/workflow-automation/)
|
||||
- **Prompt example:** `Usa @langgraph per implementare il grafo agente con fallback e human-in-the-loop.`
|
||||
|
||||
4. **Evaluate and iterate**
|
||||
- **Goal:** Improve weak points with a structured loop.
|
||||
- **Skills:** [`@agent-evaluation`](../../skills/agent-evaluation/), [`@langfuse`](../../skills/langfuse/), [`@kaizen`](../../skills/kaizen/)
|
||||
- **Prompt example:** `Usa @kaizen per prioritizzare le correzioni sulle failure modes rilevate dai test.`
|
||||
|
||||
---
|
||||
|
||||
## Workflow: QA and Browser Automation
|
||||
|
||||
Create resilient browser automation with deterministic execution in CI.
|
||||
|
||||
**Related bundles:** `QA & Testing`, `Full-Stack Developer`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Test environments and stable credentials.
|
||||
- Critical user journeys identified.
|
||||
- CI pipeline available.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Prepare test strategy**
|
||||
- **Goal:** Scope journeys, fixtures, and execution environments.
|
||||
- **Skills:** [`@e2e-testing-patterns`](../../skills/e2e-testing-patterns/), [`@test-driven-development`](../../skills/test-driven-development/)
|
||||
- **Prompt example:** `Usa @e2e-testing-patterns per definire suite E2E minima ma ad alto impatto.`
|
||||
|
||||
2. **Implement browser tests**
|
||||
- **Goal:** Build robust test coverage with stable selectors.
|
||||
- **Skills:** [`@browser-automation`](../../skills/browser-automation/), `@go-playwright` (optional, Go stack)
|
||||
- **Prompt example:** `Usa @go-playwright per implementare browser automation in un progetto Go.`
|
||||
|
||||
3. **Triage and harden**
|
||||
- **Goal:** Remove flaky behavior and enforce repeatability.
|
||||
- **Skills:** [`@systematic-debugging`](../../skills/systematic-debugging/), [`@test-fixing`](../../skills/test-fixing/), [`@verification-before-completion`](../../skills/verification-before-completion/)
|
||||
- **Prompt example:** `Usa @systematic-debugging per classificare e risolvere le flakiness in CI.`
|
||||
|
||||
---
|
||||
|
||||
## Workflow: Design a DDD Core Domain
|
||||
|
||||
Model a complex domain coherently, then implement tactical and evented patterns only where justified.
|
||||
|
||||
**Related bundles:** `Architecture & Design`, `DDD & Evented Architecture`
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Access to at least one domain expert or product owner proxy.
|
||||
- Current system context and integration landscape available.
|
||||
- Agreement on business goals and key domain outcomes.
|
||||
|
||||
### Steps
|
||||
|
||||
1. **Assess DDD fit and scope**
|
||||
- **Goal:** Decide whether full DDD, partial DDD, or simple modular architecture is appropriate.
|
||||
- **Skills:** [`@domain-driven-design`](../../skills/domain-driven-design/), [`@architecture-decision-records`](../../skills/architecture-decision-records/)
|
||||
- **Prompt example:** `Use @domain-driven-design to evaluate if full DDD is justified for our billing and fulfillment platform.`
|
||||
|
||||
2. **Create strategic model**
|
||||
- **Goal:** Define subdomains, bounded contexts, and ubiquitous language.
|
||||
- **Skills:** [`@ddd-strategic-design`](../../skills/ddd-strategic-design/)
|
||||
- **Prompt example:** `Use @ddd-strategic-design to classify subdomains and propose bounded contexts with ownership.`
|
||||
|
||||
3. **Map context relationships**
|
||||
- **Goal:** Define upstream/downstream contracts and anti-corruption boundaries.
|
||||
- **Skills:** [`@ddd-context-mapping`](../../skills/ddd-context-mapping/)
|
||||
- **Prompt example:** `Use @ddd-context-mapping to model Checkout, Billing, and Inventory interactions with clear contract ownership.`
|
||||
|
||||
4. **Implement tactical model**
|
||||
- **Goal:** Encode invariants with aggregates, value objects, and domain events.
|
||||
- **Skills:** [`@ddd-tactical-patterns`](../../skills/ddd-tactical-patterns/), [`@test-driven-development`](../../skills/test-driven-development/)
|
||||
- **Prompt example:** `Use @ddd-tactical-patterns to design aggregates and invariants for order lifecycle transitions.`
|
||||
|
||||
5. **Adopt evented patterns selectively**
|
||||
- **Goal:** Apply CQRS, event store, projections, and sagas only where complexity and scale require them.
|
||||
- **Skills:** [`@cqrs-implementation`](../../skills/cqrs-implementation/), [`@event-store-design`](../../skills/event-store-design/), [`@projection-patterns`](../../skills/projection-patterns/), [`@saga-orchestration`](../../skills/saga-orchestration/)
|
||||
- **Prompt example:** `Use @cqrs-implementation and @projection-patterns to scale read-side reporting without compromising domain invariants.`
|
||||
|
||||
---
|
||||
|
||||
## Machine-Readable Workflows
|
||||
|
||||
For tooling and automation, workflow metadata is available in [data/workflows.json](../../data/workflows.json).
|
||||
6
package-lock.json
generated
6
package-lock.json
generated
@@ -1,15 +1,15 @@
|
||||
{
|
||||
"name": "antigravity-awesome-skills",
|
||||
"version": "6.12.0",
|
||||
"version": "7.0.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "antigravity-awesome-skills",
|
||||
"version": "6.12.0",
|
||||
"version": "7.0.0",
|
||||
"license": "MIT",
|
||||
"bin": {
|
||||
"antigravity-awesome-skills": "bin/install.js"
|
||||
"antigravity-awesome-skills": "tools/bin/install.js"
|
||||
},
|
||||
"devDependencies": {
|
||||
"yaml": "^2.8.2"
|
||||
|
||||
39
package.json
39
package.json
@@ -1,27 +1,30 @@
|
||||
{
|
||||
"name": "antigravity-awesome-skills",
|
||||
"version": "7.0.0",
|
||||
"description": "1,200+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.",
|
||||
"description": "1,204+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.",
|
||||
"license": "MIT",
|
||||
"scripts": {
|
||||
"validate": "node scripts/run-python.js scripts/validate_skills.py",
|
||||
"validate:strict": "node scripts/run-python.js scripts/validate_skills.py --strict",
|
||||
"index": "node scripts/run-python.js scripts/generate_index.py",
|
||||
"readme": "node scripts/run-python.js scripts/update_readme.py",
|
||||
"validate": "node tools/scripts/run-python.js tools/scripts/validate_skills.py",
|
||||
"validate:strict": "node tools/scripts/run-python.js tools/scripts/validate_skills.py --strict",
|
||||
"validate:references": "node tools/scripts/run-python.js tools/scripts/validate_references.py",
|
||||
"index": "node tools/scripts/run-python.js tools/scripts/generate_index.py",
|
||||
"readme": "node tools/scripts/run-python.js tools/scripts/update_readme.py",
|
||||
"sync:metadata": "node tools/scripts/run-python.js tools/scripts/sync_repo_metadata.py",
|
||||
"chain": "npm run validate && npm run index && npm run readme",
|
||||
"catalog": "node scripts/build-catalog.js",
|
||||
"sync:all": "npm run sync:metadata && npm run chain",
|
||||
"catalog": "node tools/scripts/build-catalog.js",
|
||||
"build": "npm run chain && npm run catalog",
|
||||
"test": "node scripts/tests/run-test-suite.js",
|
||||
"test:local": "node scripts/tests/run-test-suite.js --local",
|
||||
"test:network": "node scripts/tests/run-test-suite.js --network",
|
||||
"sync:microsoft": "node scripts/run-python.js scripts/sync_microsoft_skills.py",
|
||||
"test": "node tools/scripts/tests/run-test-suite.js",
|
||||
"test:local": "node tools/scripts/tests/run-test-suite.js --local",
|
||||
"test:network": "node tools/scripts/tests/run-test-suite.js --network",
|
||||
"sync:microsoft": "node tools/scripts/run-python.js tools/scripts/sync_microsoft_skills.py",
|
||||
"sync:all-official": "npm run sync:microsoft && npm run chain",
|
||||
"update:skills": "node scripts/run-python.js scripts/generate_index.py && node scripts/copy-file.js skills_index.json web-app/public/skills.json",
|
||||
"app:setup": "node scripts/setup_web.js",
|
||||
"app:install": "cd web-app && npm install",
|
||||
"app:dev": "npm run app:setup && cd web-app && npm run dev",
|
||||
"app:build": "npm run app:setup && cd web-app && npm run build",
|
||||
"app:preview": "cd web-app && npm run preview"
|
||||
"update:skills": "node tools/scripts/run-python.js tools/scripts/generate_index.py && node tools/scripts/copy-file.js skills_index.json apps/web-app/public/skills.json",
|
||||
"app:setup": "node tools/scripts/setup_web.js",
|
||||
"app:install": "cd apps/web-app && npm install",
|
||||
"app:dev": "npm run app:setup && cd apps/web-app && npm run dev",
|
||||
"app:build": "npm run app:setup && cd apps/web-app && npm run build",
|
||||
"app:preview": "cd apps/web-app && npm run preview"
|
||||
},
|
||||
"devDependencies": {
|
||||
"yaml": "^2.8.2"
|
||||
@@ -31,10 +34,10 @@
|
||||
"url": "git+https://github.com/sickn33/antigravity-awesome-skills.git"
|
||||
},
|
||||
"bin": {
|
||||
"antigravity-awesome-skills": "bin/install.js"
|
||||
"antigravity-awesome-skills": "tools/bin/install.js"
|
||||
},
|
||||
"files": [
|
||||
"bin"
|
||||
"tools/bin"
|
||||
],
|
||||
"keywords": [
|
||||
"claude-code",
|
||||
|
||||
171
release_notes.md
171
release_notes.md
@@ -1,170 +1,3 @@
|
||||
# v7.0.0 - 20k Stars Celebration
|
||||
# Release Process
|
||||
|
||||
🎉 **20,000 GitHub Stars Milestone Achieved!** 🎉
|
||||
|
||||
Thank you to our incredible community for making **Antigravity Awesome Skills** the most comprehensive agentic skills collection ever created. From 0 to 20,000 stars, this journey has been powered by developers, security researchers, data scientists, and AI enthusiasts worldwide.
|
||||
|
||||
---
|
||||
|
||||
## What's New in v7.0.0
|
||||
|
||||
### 300+ New Skills from 35+ Community Repositories
|
||||
|
||||
This release adds **300+ new skills**, expanding our collection to **1,200+ total skills**. We've integrated skills from the best community repositories, organized into powerful new categories:
|
||||
|
||||
## Featured Skill Collections
|
||||
|
||||
### 🎨 UI/UX & Frontend (35+ skills)
|
||||
- **Complete Three.js Suite**: 10 skills covering 3D graphics fundamentals to advanced shaders
|
||||
- **Makepad Framework**: 19 skills for the Rust-based UI framework
|
||||
- **Expo/React Native**: 8 skills for cross-platform mobile development
|
||||
- **UI Polish Toolkit**: Accessibility fixes, metadata optimization, motion performance
|
||||
- **SwiftUI Expert**: Complete iOS development guide with 14 references
|
||||
|
||||
### 🤖 Automation & Integration (35+ skills)
|
||||
- **Google Workspace**: Full integration with Gmail, Calendar, Docs, Sheets, Drive, Slides
|
||||
- **n8n Workflow Automation**: 7 skills for building automated workflows
|
||||
- **WhatsApp Automation**: Complete messaging automation suite
|
||||
- **Linear Integration**: Project management with Linear
|
||||
- **Developer Workflow**: Git automation, PR management, bug hunting from Sentry
|
||||
|
||||
### 🛡️ Security & Auditing (40+ skills)
|
||||
- **Trail of Bits Collection**: 40+ security skills including Semgrep rules, static analysis, vulnerability detection
|
||||
- **ffuf Web Fuzzing**: Advanced web application testing
|
||||
- **Security Bluebook Builder**: Create security policies with best practices
|
||||
- **Language-Specific Auditors**: Go, Python, Rust security analysis
|
||||
|
||||
### 📊 Machine Learning & Data Science (35+ skills)
|
||||
- **HuggingFace Integration**: 6 skills for ML model training, datasets, evaluation
|
||||
- **Data Science Essentials**: NumPy, Pandas, SciPy, Matplotlib, Scikit-learn
|
||||
- **Bioinformatics**: Biopython, Scanpy, UniProt, PubMed integration
|
||||
- **Scientific Computing**: 13+ specialized scientific tools
|
||||
- **Quantum Computing**: Cirq (Google) and Qiskit (IBM) frameworks
|
||||
- **Financial Analysis**: Alpha Vantage, quantitative analysis, risk modeling
|
||||
|
||||
### 🏥 Health & Wellness (20+ skills)
|
||||
- **Complete Health Suite**: Sleep, nutrition, fitness analyzers
|
||||
- **Specialized Analyzers**: Mental health, occupational health, oral health, skin health
|
||||
- **TCM Support**: Traditional Chinese Medicine constitution analysis
|
||||
- **Wellness Tracking**: Goals, trends, emergency cards
|
||||
|
||||
### 🧠 Context Engineering & AI (15+ skills)
|
||||
- **Context Patterns**: Fundamentals, degradation, compression, optimization
|
||||
- **Multi-Agent Systems**: Architectural patterns for agent coordination
|
||||
- **Advanced Evaluation**: LLM-as-judge frameworks with bias mitigation
|
||||
|
||||
### 🌐 AWS Development (6+ skills)
|
||||
- Agentic AI on AWS, CDK development, cost optimization, serverless EDA
|
||||
|
||||
### 📝 Functional Programming (12+ skills)
|
||||
- **fp-ts Complete Guide**: Core patterns, React integration, error handling
|
||||
- **Quick References**: Types, pipe/flow, Option, Either, TaskEither
|
||||
|
||||
---
|
||||
|
||||
## Community Credits
|
||||
|
||||
### Official Team Skills
|
||||
We extend our deepest gratitude to the official teams who contributed their expertise:
|
||||
|
||||
| Team | Skills Contributed |
|
||||
|------|-------------------|
|
||||
| **Vercel Labs** | `vercel-deploy-claimable` |
|
||||
| **Google Labs** | `enhance-prompt`, `remotion`, `stitch-loop` |
|
||||
| **HuggingFace** | Dataset viewer, Datasets library, Evaluation, Model trainer, Paper publisher, Tool builder |
|
||||
| **Expo** | UI SwiftUI, UI Jetpack Compose, Tailwind setup, Native UI, API routes, Dev client, CI/CD workflows, Data fetching |
|
||||
| **Sentry** | 20 developer workflow skills including commit, PR management, bug hunting |
|
||||
| **Trail of Bits** | 40+ security auditing and analysis skills |
|
||||
| **Neon** | `claimable-postgres` |
|
||||
|
||||
### Individual Contributors
|
||||
A massive thank you to the individual developers and maintainers who shared their skills:
|
||||
|
||||
| Contributor | Repository | Skills |
|
||||
|-------------|------------|--------|
|
||||
| **ibelick** | [ui-skills](https://github.com/ibelick/ui-skills) | UI/UX polish (4 skills) |
|
||||
| **sanjay3290** | [ai-skills](https://github.com/sanjay3290/ai-skills) | Google Workspace integration (6 skills) |
|
||||
| **czlonkowski** | [n8n-skills](https://github.com/czlonkowski/n8n-skills) | n8n automation (7 skills) |
|
||||
| **gokapso** | [agent-skills](https://github.com/gokapso/agent-skills) | WhatsApp automation (3 skills) |
|
||||
| **wrsmith108** | [linear-claude-skill](https://github.com/wrsmith108/linear-claude-skill), [varlock](https://github.com/wrsmith108/varlock-claude-skill) | Linear integration, secure variables |
|
||||
| **robzolkos** | [skill-rails-upgrade](https://github.com/robzolkos/skill-rails-upgrade) | Rails upgrade assistant |
|
||||
| **scarletkc** | [vexor](https://github.com/scarletkc/vexor) | Semantic file discovery |
|
||||
| **zarazhangrui** | [frontend-slides](https://github.com/zarazhangrui/frontend-slides) | HTML presentations |
|
||||
| **AvdLee** | [SwiftUI-Agent-Skill](https://github.com/AvdLee/SwiftUI-Agent-Skill) | SwiftUI development |
|
||||
| **CloudAI-X** | [threejs-skills](https://github.com/CloudAI-X/threejs-skills) | Three.js 3D graphics (10 skills) |
|
||||
| **ZhangHanDong** | [makepad-skills](https://github.com/ZhangHanDong/makepad-skills) | Makepad framework (19 skills) |
|
||||
| **muratcankoylan** | [Agent-Skills-for-Context-Engineering](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) | Context engineering (13 skills) |
|
||||
| **huifer** | [Claude-Ally-Health](https://github.com/huifer/Claude-Ally-Health) | Health & wellness (19 skills) |
|
||||
| **K-Dense-AI** | [claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) | Scientific computing (80+ skills) |
|
||||
| **jthack** | [ffuf_claude_skill](https://github.com/jthack/ffuf_claude_skill) | Web fuzzing |
|
||||
| **NotMyself** | [claude-win11-speckit-update-skill](https://github.com/NotMyself/claude-win11-speckit-update-skill) | SpecKit updater |
|
||||
| **SHADOWPR0** | [security-bluebook-builder](https://github.com/SHADOWPR0/security-bluebook-builder), [beautiful_prose](https://github.com/SHADOWPR0/beautiful_prose) | Security docs, writing style |
|
||||
| **SeanZoR** | [claude-speed-reader](https://github.com/SeanZoR/claude-speed-reader) | Speed reading |
|
||||
| **whatiskadudoing** | [fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Functional programming (22 skills) |
|
||||
| **zxkane** | [aws-skills](https://github.com/zxkane/aws-skills) | AWS development (6 skills) |
|
||||
| **Shpigford** | [skills](https://github.com/Shpigford/skills) | Developer tools (8 skills) |
|
||||
| **frmoretto** | [clarity-gate](https://github.com/frmoretto/clarity-gate) | RAG verification |
|
||||
|
||||
### Top Repository Contributors
|
||||
Based on commit history, our heartfelt thanks to:
|
||||
|
||||
1. **@sck_0** - 377 commits - Core maintenance and skill curation
|
||||
2. **@github-actions[bot]** - 145 commits - CI/CD automation
|
||||
3. **@sickn33** - 54 commits - Repository founder and maintainer
|
||||
4. **@Mohammad-Faiz-Cloud-Engineer** - 38 commits
|
||||
5. **@munir-abbasi** - 31 commits
|
||||
6. **@zinzied** - 21 commits
|
||||
7. **@ssumanbiswas** - 10 commits
|
||||
8. **@Dokhacgiakhoa** - 10 commits
|
||||
9. **@IanJ332** - 9 commits
|
||||
10. **@jackjin1997** - 9 commits
|
||||
|
||||
And 40+ more contributors who made this possible!
|
||||
|
||||
---
|
||||
|
||||
## Statistics
|
||||
|
||||
| Metric | Before v7.0.0 | After v7.0.0 |
|
||||
|--------|---------------|--------------|
|
||||
| **Total Skills** | ~900 | **1,200+** |
|
||||
| **New Skills** | - | **~300** |
|
||||
| **External Repositories** | ~10 | **35+** |
|
||||
| **GitHub Stars** | 20,000 | 20,000+ |
|
||||
| **Categories** | 15 | **25+** |
|
||||
|
||||
---
|
||||
|
||||
## Upgrade Instructions
|
||||
|
||||
```bash
|
||||
# Update to v7.0.0
|
||||
git pull origin main
|
||||
|
||||
# Reinstall skills
|
||||
npx antigravity-awesome-skills
|
||||
|
||||
# Or update via npm
|
||||
npm install -g antigravity-awesome-skills@latest
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## What's Next?
|
||||
|
||||
With 1,200+ skills now available, we're planning:
|
||||
- **v7.1**: More community contributions and official vendor skills
|
||||
- **Web App v2**: Enhanced search and skill recommendation engine
|
||||
- **Skill Bundles**: Curated collections for specific roles (Security Engineer, Data Scientist, etc.)
|
||||
|
||||
---
|
||||
|
||||
## Thank You!
|
||||
|
||||
To every star-gazer, contributor, issue-reporter, and skill-user: **Thank you!** This release is a testament to the power of open-source community collaboration.
|
||||
|
||||
Here's to the next 20,000 stars! 🚀
|
||||
|
||||
---
|
||||
|
||||
*Released on March 6, 2026 by the Antigr Awesome Skills Team*
|
||||
This document moved to [`docs/maintainers/release-process.md`](docs/maintainers/release-process.md).
|
||||
|
||||
78
scripts/sync_repo_metadata.py
Normal file
78
scripts/sync_repo_metadata.py
Normal file
@@ -0,0 +1,78 @@
|
||||
#!/usr/bin/env python3
|
||||
import argparse
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import sys
|
||||
|
||||
from update_readme import configure_utf8_output, find_repo_root, load_metadata, update_readme
|
||||
|
||||
|
||||
ABOUT_DESCRIPTION_RE = re.compile(r'"description"\s*:\s*"([^"]*)"')
|
||||
|
||||
|
||||
def update_package_description(base_dir: str, metadata: dict, dry_run: bool) -> bool:
|
||||
package_path = os.path.join(base_dir, "package.json")
|
||||
with open(package_path, "r", encoding="utf-8") as file:
|
||||
content = file.read()
|
||||
|
||||
new_description = (
|
||||
f"{metadata['total_skills_label']} agentic skills for Claude Code, Gemini CLI, "
|
||||
"Cursor, Antigravity & more. Installer CLI."
|
||||
)
|
||||
updated_content = ABOUT_DESCRIPTION_RE.sub(
|
||||
f'"description": "{new_description}"', content, count=1
|
||||
)
|
||||
|
||||
if updated_content == content:
|
||||
return False
|
||||
|
||||
if dry_run:
|
||||
print(f"[dry-run] Would update package description in {package_path}")
|
||||
return True
|
||||
|
||||
with open(package_path, "w", encoding="utf-8", newline="\n") as file:
|
||||
file.write(updated_content)
|
||||
print(f"✅ Updated package description in {package_path}")
|
||||
return True
|
||||
|
||||
|
||||
def print_manual_github_about(metadata: dict) -> None:
|
||||
description = (
|
||||
f"{metadata['total_skills_label']} curated SKILL.md files for Claude Code, "
|
||||
"Cursor, Gemini CLI, Codex, Copilot, and Antigravity."
|
||||
)
|
||||
print("\nManual GitHub repo settings update:")
|
||||
print(f"- About description: {description}")
|
||||
print("- Suggested topics: claude-code, cursor, gemini-cli, codex-cli, github-copilot, antigravity")
|
||||
|
||||
|
||||
def parse_args() -> argparse.Namespace:
|
||||
parser = argparse.ArgumentParser(
|
||||
description="Synchronize repository metadata across README and package.json."
|
||||
)
|
||||
parser.add_argument("--dry-run", action="store_true", help="Preview updates without writing files.")
|
||||
return parser.parse_args()
|
||||
|
||||
|
||||
def main() -> int:
|
||||
args = parse_args()
|
||||
base_dir = find_repo_root(os.path.dirname(__file__))
|
||||
metadata = load_metadata(base_dir)
|
||||
|
||||
print("Repository metadata")
|
||||
print(json.dumps(metadata, indent=2))
|
||||
|
||||
readme_metadata = update_readme(dry_run=args.dry_run)
|
||||
package_updated = update_package_description(base_dir, metadata, args.dry_run)
|
||||
print_manual_github_about(readme_metadata)
|
||||
|
||||
if args.dry_run and not package_updated:
|
||||
print("\n[dry-run] No package.json description changes required.")
|
||||
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
configure_utf8_output()
|
||||
sys.exit(main())
|
||||
@@ -1,9 +1,16 @@
|
||||
#!/usr/bin/env python3
|
||||
import argparse
|
||||
import io
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import sys
|
||||
import urllib.error
|
||||
import urllib.request
|
||||
from datetime import datetime, timezone
|
||||
|
||||
GITHUB_REPO = "sickn33/antigravity-awesome-skills"
|
||||
SYNC_COMMENT_RE = re.compile(r"<!-- registry-sync: .*? -->")
|
||||
|
||||
|
||||
def configure_utf8_output() -> None:
|
||||
@@ -28,63 +35,227 @@ def configure_utf8_output() -> None:
|
||||
)
|
||||
|
||||
|
||||
def update_readme():
|
||||
base_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
||||
def find_repo_root(start_path: str) -> str:
|
||||
current = os.path.abspath(start_path)
|
||||
while True:
|
||||
if os.path.isfile(os.path.join(current, "package.json")) and os.path.isfile(
|
||||
os.path.join(current, "README.md")
|
||||
):
|
||||
return current
|
||||
parent = os.path.dirname(current)
|
||||
if parent == current:
|
||||
raise FileNotFoundError("Could not locate repository root from script path.")
|
||||
current = parent
|
||||
|
||||
|
||||
def format_skill_count(total_skills: int) -> str:
|
||||
return f"{total_skills:,}+"
|
||||
|
||||
|
||||
def format_star_badge_count(stars: int) -> str:
|
||||
if stars >= 1000:
|
||||
rounded = int(round(stars / 1000.0))
|
||||
return f"{rounded}%2C000%2B"
|
||||
return f"{stars}%2B"
|
||||
|
||||
|
||||
def format_star_milestone(stars: int) -> str:
|
||||
if stars >= 1000:
|
||||
rounded = int(round(stars / 1000.0))
|
||||
return f"{rounded},000+"
|
||||
return f"{stars}+"
|
||||
|
||||
|
||||
def format_star_celebration(stars: int) -> str:
|
||||
if stars >= 1000:
|
||||
rounded = int(round(stars / 1000.0))
|
||||
return f"{rounded}k"
|
||||
return str(stars)
|
||||
|
||||
|
||||
def fetch_star_count(repo: str) -> int | None:
|
||||
url = f"https://api.github.com/repos/{repo}"
|
||||
request = urllib.request.Request(
|
||||
url,
|
||||
headers={
|
||||
"Accept": "application/vnd.github+json",
|
||||
"User-Agent": "antigravity-awesome-skills-readme-sync",
|
||||
},
|
||||
)
|
||||
try:
|
||||
with urllib.request.urlopen(request, timeout=10) as response:
|
||||
payload = json.load(response)
|
||||
except (urllib.error.URLError, TimeoutError, json.JSONDecodeError):
|
||||
return None
|
||||
stars = payload.get("stargazers_count")
|
||||
return int(stars) if isinstance(stars, int) else None
|
||||
|
||||
|
||||
def load_metadata(base_dir: str, repo: str = GITHUB_REPO) -> dict:
|
||||
readme_path = os.path.join(base_dir, "README.md")
|
||||
package_path = os.path.join(base_dir, "package.json")
|
||||
index_path = os.path.join(base_dir, "skills_index.json")
|
||||
|
||||
print(f"📖 Reading skills index from: {index_path}")
|
||||
with open(index_path, "r", encoding="utf-8") as f:
|
||||
skills = json.load(f)
|
||||
with open(index_path, "r", encoding="utf-8") as file:
|
||||
skills = json.load(file)
|
||||
|
||||
total_skills = len(skills)
|
||||
print(f"🔢 Total skills found: {total_skills}")
|
||||
with open(package_path, "r", encoding="utf-8") as file:
|
||||
package = json.load(file)
|
||||
|
||||
print(f"📝 Updating README at: {readme_path}")
|
||||
with open(readme_path, "r", encoding="utf-8") as f:
|
||||
content = f.read()
|
||||
with open(readme_path, "r", encoding="utf-8") as file:
|
||||
current_readme = file.read()
|
||||
|
||||
# 1. Update Title Count
|
||||
content = re.sub(
|
||||
r"(# 🌌 Antigravity Awesome Skills: )\d+(\+ Agentic Skills)",
|
||||
rf"\g<1>{total_skills}\g<2>",
|
||||
content,
|
||||
current_star_match = re.search(r"⭐%20([\d%2C\+]+)%20Stars", current_readme)
|
||||
current_stars = None
|
||||
if current_star_match:
|
||||
compact = current_star_match.group(1).replace("%2C", "").replace("%2B", "")
|
||||
compact = compact.rstrip("+")
|
||||
if compact.isdigit():
|
||||
current_stars = int(compact)
|
||||
|
||||
live_stars = fetch_star_count(repo)
|
||||
total_stars = live_stars if live_stars is not None else current_stars or 0
|
||||
|
||||
return {
|
||||
"repo": repo,
|
||||
"version": str(package.get("version", "0.0.0")),
|
||||
"total_skills": len(skills),
|
||||
"total_skills_label": format_skill_count(len(skills)),
|
||||
"stars": total_stars,
|
||||
"star_badge_count": format_star_badge_count(total_stars),
|
||||
"star_milestone": format_star_milestone(total_stars),
|
||||
"star_celebration": format_star_celebration(total_stars),
|
||||
"updated_at": datetime.now(timezone.utc).replace(microsecond=0).isoformat(),
|
||||
"used_live_star_count": live_stars is not None,
|
||||
}
|
||||
|
||||
|
||||
def apply_metadata(content: str, metadata: dict) -> str:
|
||||
total_skills = metadata["total_skills"]
|
||||
total_skills_label = metadata["total_skills_label"]
|
||||
version = metadata["version"]
|
||||
star_badge_count = metadata["star_badge_count"]
|
||||
star_milestone = metadata["star_milestone"]
|
||||
star_celebration = metadata["star_celebration"]
|
||||
sync_comment = (
|
||||
f"<!-- registry-sync: version={version}; skills={total_skills}; "
|
||||
f"stars={metadata['stars']}; updated_at={metadata['updated_at']} -->"
|
||||
)
|
||||
|
||||
# 2. Update Blockquote Count
|
||||
content = re.sub(
|
||||
r"(Collection of )\d+(\+ Universal)",
|
||||
rf"\g<1>{total_skills}\g<2>",
|
||||
r"^# 🌌 Antigravity Awesome Skills: .*?$",
|
||||
(
|
||||
f"# 🌌 Antigravity Awesome Skills: {total_skills_label} "
|
||||
"Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More"
|
||||
),
|
||||
content,
|
||||
count=1,
|
||||
flags=re.MULTILINE,
|
||||
)
|
||||
|
||||
# 3. Update Intro Text Count
|
||||
content = re.sub(
|
||||
r"(library of \*\*)\d+( high-performance agentic skills\*\*)",
|
||||
rf"\g<1>{total_skills}\g<2>",
|
||||
r"^> \*\*The Ultimate Collection of .*?\*\*$",
|
||||
(
|
||||
f"> **The Ultimate Collection of {total_skills_label} Universal Agentic "
|
||||
"Skills for AI Coding Assistants — Claude Code, Gemini CLI, Codex CLI, "
|
||||
"Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL**"
|
||||
),
|
||||
content,
|
||||
count=1,
|
||||
flags=re.MULTILINE,
|
||||
)
|
||||
|
||||
# 4. Update Browse section header
|
||||
content = re.sub(
|
||||
r"## Browse \d+\+ Skills",
|
||||
f"## Browse {total_skills}+ Skills",
|
||||
r"https://img\.shields\.io/badge/⭐%20[\d%2C\+]+%20Stars-gold\?style=for-the-badge",
|
||||
f"https://img.shields.io/badge/⭐%20{star_badge_count}%20Stars-gold?style=for-the-badge",
|
||||
content,
|
||||
count=1,
|
||||
)
|
||||
|
||||
# 5. Update TOC link for Browse (anchor matches header-derived slug)
|
||||
content = re.sub(
|
||||
r"\[📚 Browse \d+\+ Skills\]\(#browse-\d+-skills\)",
|
||||
f"[📚 Browse {total_skills}+ Skills](#browse-{total_skills}-skills)",
|
||||
r"^\*\*Antigravity Awesome Skills\*\* is a curated, battle-tested library of \*\*.*?\*\* designed",
|
||||
(
|
||||
f"**Antigravity Awesome Skills** is a curated, battle-tested library of "
|
||||
f"**{total_skills_label} high-performance agentic skills** designed"
|
||||
),
|
||||
content,
|
||||
count=1,
|
||||
flags=re.MULTILINE,
|
||||
)
|
||||
content = re.sub(
|
||||
r"\[📚 Browse \d[\d,]*\+ Skills\]\(#browse-[^)]+\)",
|
||||
f"[📚 Browse {total_skills_label} Skills](#browse-{total_skills}-skills)",
|
||||
content,
|
||||
count=1,
|
||||
)
|
||||
content = re.sub(
|
||||
r"\*\*Welcome to the V[\d.]+ .*? Stars Celebration Release!\*\*",
|
||||
f"**Welcome to the V{version} {star_celebration} Stars Celebration Release!**",
|
||||
content,
|
||||
count=1,
|
||||
)
|
||||
content = re.sub(
|
||||
r"> \*\*🌟 .*? GitHub Stars Milestone!\*\*",
|
||||
f"> **🌟 {star_milestone} GitHub Stars Milestone!**",
|
||||
content,
|
||||
count=1,
|
||||
)
|
||||
content = re.sub(
|
||||
r"\*\*Antigravity Awesome Skills\*\* \(Release [\d.]+\) is a massive upgrade to your AI's capabilities, now featuring \*\*.*?\*\* skills",
|
||||
(
|
||||
f"**Antigravity Awesome Skills** (Release {version}) is a massive upgrade "
|
||||
f"to your AI's capabilities, now featuring **{total_skills_label} skills**"
|
||||
),
|
||||
content,
|
||||
count=1,
|
||||
)
|
||||
content = re.sub(
|
||||
r"## Browse \d[\d,]*\+ Skills",
|
||||
f"## Browse {total_skills_label} Skills",
|
||||
content,
|
||||
count=1,
|
||||
)
|
||||
content = re.sub(
|
||||
r"<!-- registry-sync: .*? -->\n?",
|
||||
"",
|
||||
content,
|
||||
count=1,
|
||||
)
|
||||
return f"{sync_comment}\n{content.lstrip()}"
|
||||
|
||||
with open(readme_path, "w", encoding="utf-8", newline="\n") as f:
|
||||
f.write(content)
|
||||
|
||||
def update_readme(dry_run: bool = False) -> dict:
|
||||
base_dir = find_repo_root(os.path.dirname(__file__))
|
||||
readme_path = os.path.join(base_dir, "README.md")
|
||||
metadata = load_metadata(base_dir)
|
||||
|
||||
print(f"📖 Reading README from: {readme_path}")
|
||||
print(f"🔢 Total skills found: {metadata['total_skills']}")
|
||||
print(f"🏷️ Version found: {metadata['version']}")
|
||||
if metadata["used_live_star_count"]:
|
||||
print(f"⭐ Live GitHub stars found: {metadata['stars']}")
|
||||
else:
|
||||
print(f"⭐ Using existing README star count: {metadata['stars']}")
|
||||
|
||||
with open(readme_path, "r", encoding="utf-8") as file:
|
||||
content = file.read()
|
||||
|
||||
updated_content = apply_metadata(content, metadata)
|
||||
if dry_run:
|
||||
print("🧪 Dry run enabled; README.md not written.")
|
||||
return metadata
|
||||
|
||||
with open(readme_path, "w", encoding="utf-8", newline="\n") as file:
|
||||
file.write(updated_content)
|
||||
|
||||
print("✅ README.md updated successfully.")
|
||||
return metadata
|
||||
|
||||
|
||||
def parse_args() -> argparse.Namespace:
|
||||
parser = argparse.ArgumentParser(description="Sync generated metadata into README.md.")
|
||||
parser.add_argument("--dry-run", action="store_true", help="Compute metadata without writing files.")
|
||||
return parser.parse_args()
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
configure_utf8_output()
|
||||
update_readme()
|
||||
args = parse_args()
|
||||
update_readme(dry_run=args.dry_run)
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user