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.
2026-03-06 15:01:38 +01:00
parent 5d17564608
commit 45844de534
3384 changed files with 13894 additions and 586586 deletions
--- a/docs/users/bundles.md
+++ b/docs/users/bundles.md
@@ -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_