@waensaran/antigravity-skills 1.0.0

package/README.md

@@ -0,0 +1,264 @@
+# Antigravity Skill Vault
+
+A curated collection of **Agent Skills** for **Google Antigravity**, ported from the [Claude Code Agents](https://github.com/wshobson/agents) repository.
+
+This vault transforms the extensive Claude Code ecosystem into **Antigravity Skills**, providing your agent with repeatable workflows, domain expertise, and specialized tools.
+
+---
+
+## 🚀 Overview
+
+This repository contains **300+ specialized skills** across software development, operations, security, and business domains. Each skill is a directory-based package that teaches Antigravity's agent how to perform specific tasks.
+
+### What's Included?
+
+The skills are derived from three types of Claude Code components, all unified into the Antigravity Skill format:
+
+1.  **Domain Skills** (e.g., `k8s-manifest-generator`, `async-python-patterns`): Specialized knowledge packages.
+2.  **Specialist Agents** (e.g., `backend-architect`, `security-auditor`): Persona-based instruction sets for complex reasoning.
+3.  **Commands & Workflows** (e.g., `full-stack-orchestration-full-stack-feature`, `conductor-implement`): Structured, multi-step procedures.
+
+---
+
+## 📂 Categories
+
+Skills are flattened in the `skills/` directory, but cover these broad categories:
+
+### 💻 Development & Languages
+- **Python**: `python-pro`, `fastapi-pro`, `async-python-patterns`, `uv-package-manager`
+- **JavaScript/TypeScript**: `typescript-pro`, `react-modernization`, `nextjs-app-router-patterns`
+- **Systems**: `rust-pro`, `golang-pro`, `memory-safety-patterns`
+- **Mobile**: `frontend-mobile-development-component-scaffold`, `react-native-architecture`
+
+### ☁️ Infrastructure & Operations
+- **Kubernetes**: `kubernetes-architect`, `helm-chart-scaffolding`, `gitops-workflow`
+- **Cloud**: `cloud-architect`, `terraform-module-library`, `cost-optimization`
+- **CI/CD**: `cicd-automation-workflow-automate`, `github-actions-templates`, `gitlab-ci-patterns`
+
+### 🔒 Security & Quality
+- **Security**: `security-auditor`, `sast-configuration`, `security-scanning-security-hardening`
+- **Code Quality**: `code-review-ai-ai-review`, `code-refactoring-refactor-clean`, `codebase-cleanup-tech-debt`
+- **Testing**: `unit-testing-test-generate`, `tdd-workflows-tdd-cycle`, `e2e-testing-patterns`
+
+### 🔄 Workflows & Architecture
+- **Conductor**: `conductor-implement`, `context-driven-development` (Context-Driven Development)
+- **Architecture**: `c4-architecture-c4-architecture`, `microservices-patterns`, `api-design-principles`
+- **Orchestration**: `full-stack-orchestration-full-stack-feature`, `incident-response-incident-response`
+
+### 📊 Data & AI
+- **Data Engineering**: `data-engineer`, `spark-optimization`, `dbt-transformation-patterns`
+- **AI/ML**: `ml-pipeline-workflow`, `prompt-engineering-patterns`, `rag-implementation`
+
+---
+
+## 🎯 Install Strategically (Token Efficient)
+
+Antigravity loads metadata (name + description) from every installed skill at session start. More skills means more token usage and a higher chance of irrelevant auto-activation. Prefer targeted installs via search, tags, or bundles. `install --all` is advanced and not recommended for most projects.
+
+## 🧭 Catalog & Discovery
+
+This repo ships a generated catalog for discovery:
+
+- `CATALOG.md` (human-readable index)
+- `catalog.json` (machine-readable index used by the CLI)
+- `bundles.json` (curated bundles)
+- `aliases.json` (short names that map to long skill IDs)
+
+Regenerate after adding/editing skills:
+
+```bash
+npm run build:catalog
+```
+
+## 🛠️ How to Use
+
+When a conversation starts, Antigravity loads the **metadata** (name & description) from all skills.
+ANTIGRAVITY automatically activates a skill when your request matches its description.
+
+**Examples:**
+
+*   *"Help me design a REST API for a user service"* → Activates `api-design-principles` and `backend-architect`.
+*   *"Scaffold a new FastAPI project"* → Activates `python-development-python-scaffold`.
+*   *"Review this PR for security issues"* → Activates `security-scanning-security-hardening` or `security-auditor`.
+*   *"Start a new feature track for login"* → Activates `conductor-new-track`.
+
+---
+
+You can install skills in **two scopes**:
+
+-   **Workspace scope** (project-specific): `<workspace-root>/.agent/skills/`
+-   **Global scope** (available in all projects): `~/.gemini/antigravity/skills/`
+
+### Using `npx` (Recommended)
+
+You can easily install skills directly from the repository without cloning it manually.
+
+**1. Search skills (recommended first):**
+
+```bash
+npx @waensaran/antigravity-skills search <query>
+# Example:
+npx @waensaran/antigravity-skills search kubernetes
+```
+
+**2. List available skills:**
+
+```bash
+npx @waensaran/antigravity-skills list
+```
+
+**3. Install a specific skill to your current project:**
+
+```bash
+npx @waensaran/antigravity-skills install <skill-name>
+# Example:
+npx @waensaran/antigravity-skills install bash-pro
+```
+
+**4. Install by tag or bundle (targeted sets):**
+
+```bash
+# By tag
+npx @waensaran/antigravity-skills install --tag kubernetes
+
+# By bundle
+npx @waensaran/antigravity-skills install --bundle core-dev
+```
+
+Available bundles: `core-dev`, `security-core`, `k8s-core`, `data-core`, `ops-core`.
+
+**5. Install a skill globally:**
+
+```bash
+npx @waensaran/antigravity-skills install <skill-name> --global
+# Example:
+npx @waensaran/antigravity-skills install bash-pro --global
+```
+
+**6. Check installed skills:**
+
+```bash
+# List local specific skills
+npx @waensaran/antigravity-skills installed
+
+# List globally installed skills
+npx @waensaran/antigravity-skills installed --global
+```
+
+**7. Update installed skills:**
+
+```bash
+# Update a specific skill
+npx @waensaran/antigravity-skills update <skill-name>
+
+# Update ALL installed skills
+npx @waensaran/antigravity-skills update
+
+# Update global skills
+npx @waensaran/antigravity-skills update --global
+```
+
+**8. Doctor / stats:**
+
+```bash
+npx @waensaran/antigravity-skills doctor
+npx @waensaran/antigravity-skills stats
+```
+
+**9. Install ALL skills (advanced, not recommended):**
+
+```bash
+# To your current workspace
+npx @waensaran/antigravity-skills install --all
+
+# Globally
+npx @waensaran/antigravity-skills install --all --global
+```
+
+> **Note:** Installing all skills increases token usage and can trigger unrelated skills. Prefer targeted installs.
+
+Aliases are supported via `aliases.json` (for long skill names).
+
+Example:
+
+```bash
+npx @waensaran/antigravity-skills install full-stack-feature
+```
+
+### Manual Installation
+
+If you prefer to clone the repository:
+
+**Option A — Install to a workspace**
+
+```bash
+mkdir -p .agent/skills
+cp -R /path/to/antigravity-skills/skills/<skill-name> .agent/skills/
+```
+
+**Option B — Install globally**
+
+```bash
+mkdir -p ~/.gemini/antigravity/skills
+cp -R /path/to/antigravity-skills/skills/<skill-name> ~/.gemini/antigravity/skills/
+```
+
+> **Note:** After copying skills, restart your agent session so Antigravity re-detects them.
+
+---
+
+## ➕ Adding New Skills
+
+1.  Create a folder: `skills/<skill-name>/`
+2.  Add `SKILL.md` (required)
+3.  (Optional) Add helpers: `scripts/`, `references/`, `assets/`
+
+### Authoring Guidelines
+
+- Keep `SKILL.md` concise; move long examples to `resources/` or `examples/`.
+- Use narrow descriptions (for example: "Use when you need to ...") and include "Do not use" to reduce over-activation.
+- Add a "Safety" section for skills that propose terminal or infrastructure changes.
+- Regenerate catalog files with `npm run build:catalog` and validate with `npm run validate:skills`.
+- CI runs strict validation using `validation-baseline.json` for existing gaps; new skills must include the required sections.
+- If you backfill existing skills, refresh the baseline with `node scripts/validate-skills.js --write-baseline`.
+
+### SKILL.md Template
+
+```markdown
+---
+name: <skill-name>
+description: <one sentence describing when to use this skill>
+---
+
+# <Skill Title>
+
+## Use this skill when
+- ...
+
+## Do not use this skill when
+- ...
+
+## Instructions
+1. ...
+2. ...
+```
+
+---
+
+## 🔐 Security
+
+See [SECURITY.md](SECURITY.md) for safety expectations when writing skills that touch terminals or infrastructure.
+
+---
+
+## 🏅 Credits & Acknowledgements
+
+- **Original Content**: © [Claude Code Agents](https://github.com/wshobson/agents)
+- **Ported to Antigravity & CLI Framework**: [Yudhi (rmyndharis)](https://github.com/rmyndharis/antigravity-skills)
+- **Maintained & Published by**: [@waensaran](https://github.com/waensaran)
+
+---
+
+## 📜 License
+
+MIT License. See [LICENSE](LICENSE) file for details.

package/SECURITY.md

@@ -0,0 +1,15 @@
+# Security Policy
+
+This repository ships skills that may recommend terminal commands or infrastructure changes. Keep safety in mind when authoring or updating skills.
+
+## Authoring Guidelines
+
+- Require explicit confirmation before destructive actions (for example: rm -rf, kubectl delete, terraform apply).
+- Prefer read-only, plan, or dry-run commands before any write operation.
+- Avoid embedding secrets, tokens, or credentials in examples. Use placeholders.
+- Add a "Safety" section in SKILL.md for any skill that touches production, infrastructure, or data.
+- Default to least-privilege guidance and highlight rollback steps when relevant.
+
+## Reporting
+
+If you discover a security issue in this repository, please open an issue with details and reproduction steps.

package/aliases.json

@@ -0,0 +1,65 @@
+{
+  "generatedAt": "2026-01-18T08:13:56.813Z",
+  "aliases": {
+    "accessibility-compliance-audit": "accessibility-compliance-accessibility-audit",
+    "agent-orchestration-improve": "agent-orchestration-improve-agent",
+    "agent-orchestration-optimize": "agent-orchestration-multi-agent-optimize",
+    "api-testing-mock": "api-testing-observability-api-mock",
+    "application-performance-optimization": "application-performance-performance-optimization",
+    "backend-development-feature": "backend-development-feature-development",
+    "c4-architecture": "c4-architecture-c4-architecture",
+    "cicd-automation-automate": "cicd-automation-workflow-automate",
+    "code-documentation-explain": "code-documentation-code-explain",
+    "code-documentation-generate": "code-documentation-doc-generate",
+    "code-refactoring-restore": "code-refactoring-context-restore",
+    "code-refactoring-clean": "code-refactoring-refactor-clean",
+    "codebase-cleanup-clean": "codebase-cleanup-refactor-clean",
+    "comprehensive-review-full": "comprehensive-review-full-review",
+    "comprehensive-review-enhance": "comprehensive-review-pr-enhance",
+    "context-management-restore": "context-management-context-restore",
+    "context-management-save": "context-management-context-save",
+    "data-engineering-feature": "data-engineering-data-driven-feature",
+    "data-engineering-pipeline": "data-engineering-data-pipeline",
+    "database-cloud-optimize": "database-cloud-optimization-cost-optimize",
+    "database-migrations-observability": "database-migrations-migration-observability",
+    "database-migrations-sql": "database-migrations-sql-migrations",
+    "debugging-toolkit-debug": "debugging-toolkit-smart-debug",
+    "dependency-management-audit": "dependency-management-deps-audit",
+    "deployment-validation-validate": "deployment-validation-config-validate",
+    "distributed-debugging-trace": "distributed-debugging-debug-trace",
+    "documentation-generation-generate": "documentation-generation-doc-generate",
+    "error-debugging-analysis": "error-debugging-error-analysis",
+    "error-debugging-review": "error-debugging-multi-agent-review",
+    "error-diagnostics-analysis": "error-diagnostics-error-analysis",
+    "error-diagnostics-trace": "error-diagnostics-error-trace",
+    "error-diagnostics-debug": "error-diagnostics-smart-debug",
+    "framework-migration-migrate": "framework-migration-code-migrate",
+    "framework-migration-upgrade": "framework-migration-deps-upgrade",
+    "framework-migration-modernize": "framework-migration-legacy-modernize",
+    "frontend-mobile-scaffold": "frontend-mobile-development-component-scaffold",
+    "frontend-mobile-scan": "frontend-mobile-security-xss-scan",
+    "full-stack-feature": "full-stack-orchestration-full-stack-feature",
+    "git-pr-workflow": "git-pr-workflows-git-workflow",
+    "incident-response": "incident-response-incident-response",
+    "javascript-typescript-scaffold": "javascript-typescript-typescript-scaffold",
+    "llm-application-assistant": "llm-application-dev-ai-assistant",
+    "llm-application-agent": "llm-application-dev-langchain-agent",
+    "llm-application-optimize": "llm-application-dev-prompt-optimize",
+    "machine-learning-pipeline": "machine-learning-ops-ml-pipeline",
+    "multi-platform-apps": "multi-platform-apps-multi-platform",
+    "observability-monitoring-setup": "observability-monitoring-monitor-setup",
+    "observability-monitoring-implement": "observability-monitoring-slo-implement",
+    "performance-testing-ai": "performance-testing-review-ai-review",
+    "performance-testing-agent": "performance-testing-review-multi-agent-review",
+    "python-development-scaffold": "python-development-python-scaffold",
+    "security-compliance-check": "security-compliance-compliance-check",
+    "security-scanning-dependencies": "security-scanning-security-dependencies",
+    "security-scanning-hardening": "security-scanning-security-hardening",
+    "security-scanning-sast": "security-scanning-security-sast",
+    "startup-business-case": "startup-business-analyst-business-case",
+    "startup-business-projections": "startup-business-analyst-financial-projections",
+    "startup-business-opportunity": "startup-business-analyst-market-opportunity",
+    "systems-programming-project": "systems-programming-rust-project",
+    "team-collaboration-notes": "team-collaboration-standup-notes"
+  }
+}