diff --git a/CATALOG.md b/CATALOG.md index 5f878da2..c9f1a0a4 100644 --- a/CATALOG.md +++ b/CATALOG.md @@ -2,7 +2,7 @@ Generated at: 2026-02-08T00:00:00.000Z -Total skills: 713 +Total skills: 714 ## architecture (63) @@ -531,7 +531,7 @@ TRIGGER: "shopify", "shopify app", "checkout extension",... | shopify | shopify, | `wireshark-analysis` | This skill should be used when the user asks to "analyze network traffic with Wireshark", "capture packets for troubleshooting", "filter PCAP files", "follow... | wireshark | wireshark, network, traffic, analysis, skill, should, used, user, asks, analyze, capture, packets | | `workflow-automation` | Workflow automation is the infrastructure that makes AI agents reliable. Without durable execution, a network hiccup during a 10-step payment flow means lost... | | automation, infrastructure, makes, ai, agents, reliable, without, durable, execution, network, hiccup, during | -## security (113) +## security (114) | Skill | Description | Tags | Triggers | | --- | --- | --- | --- | @@ -539,6 +539,7 @@ TRIGGER: "shopify", "shopify app", "checkout extension",... | shopify | shopify, | `active-directory-attacks` | This skill should be used when the user asks to "attack Active Directory", "exploit AD", "Kerberoasting", "DCSync", "pass-the-hash", "BloodHound enumeration"... | active, directory, attacks | active, directory, attacks, skill, should, used, user, asks, attack, exploit, ad, kerberoasting | | `agent-memory-systems` | Memory is the cornerstone of intelligent agents. Without it, every interaction starts from zero. This skill covers the architecture of agent memory: short-te... | agent, memory | agent, memory, cornerstone, intelligent, agents, without, every, interaction, starts, zero, skill, covers | | `ai-product` | Every product will be AI-powered. The question is whether you'll build it right or ship a demo that falls apart in production. This skill covers LLM integra... | ai, product | ai, product, every, powered, question, whether, ll, right, ship, demo, falls, apart | +| `antigravity-workflows` | Orchestrate multiple Antigravity skills through guided workflows for SaaS MVP delivery, security audits, AI agent builds, and browser QA. | antigravity | antigravity, orchestrate, multiple, skills, through, guided, saas, mvp, delivery, security, audits, ai | | `api-fuzzing-bug-bounty` | This skill should be used when the user asks to "test API security", "fuzz APIs", "find IDOR vulnerabilities", "test REST API", "test GraphQL", "API penetrat... | api, fuzzing, bug, bounty | api, fuzzing, bug, bounty, skill, should, used, user, asks, test, security, fuzz | | `api-security-best-practices` | Implement secure API design patterns including authentication, authorization, input validation, rate limiting, and protection against common API vulnerabilities | api, security, best, practices | api, security, best, practices, secure, including, authentication, authorization, input, validation, rate, limiting | | `attack-tree-construction` | Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to s... | attack, tree, construction | attack, tree, construction, trees, visualize, threat, paths, mapping, scenarios, identifying, defense, gaps | diff --git a/README.md b/README.md index e62c5aed..ff9c7248 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# 🌌 Antigravity Awesome Skills: 713+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More +# 🌌 Antigravity Awesome Skills: 714+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More -> **The Ultimate Collection of 713+ Universal Agentic Skills for AI Coding Assistants β€” Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL** +> **The Ultimate Collection of 714+ Universal Agentic Skills for AI Coding Assistants β€” Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL** [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai) @@ -16,7 +16,7 @@ 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 **713 high-performance agentic skills** designed to work seamlessly across all major AI coding assistants: +**Antigravity Awesome Skills** is a curated, battle-tested library of **714 high-performance agentic skills** designed to work seamlessly across all major AI coding assistants: - 🟣 **Claude Code** (Anthropic CLI) - πŸ”΅ **Gemini CLI** (Google DeepMind) @@ -36,8 +36,9 @@ This repository provides essential skills to transform your AI assistant into a - [πŸ› οΈ Installation](#installation) - [🧯 Troubleshooting](#troubleshooting) - [🎁 Curated Collections (Bundles)](#curated-collections) +- [🧭 Antigravity Workflows](#antigravity-workflows) - [πŸ“¦ Features & Categories](#features--categories) -- [πŸ“š Browse 713+ Skills](#browse-713-skills) +- [πŸ“š Browse 714+ Skills](#browse-714-skills) - [🀝 How to Contribute](#how-to-contribute) - [🀝 Community](#community) - [β˜• Support the Project](#support-the-project) @@ -238,6 +239,23 @@ Examples: - 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: @@ -256,7 +274,7 @@ The repository is organized into specialized domains to transform your AI into a Counts change as new skills are added. For the current full registry, see [CATALOG.md](CATALOG.md). -## Browse 713+ Skills +## Browse 714+ Skills We have moved the full skill registry to a dedicated catalog to keep this README clean. diff --git a/data/bundles.json b/data/bundles.json index c684b018..bd07ce8c 100644 --- a/data/bundles.json +++ b/data/bundles.json @@ -143,6 +143,7 @@ "description": "Security, privacy, and compliance essentials.", "skills": [ "accessibility-compliance-accessibility-audit", + "antigravity-workflows", "api-fuzzing-bug-bounty", "api-security-best-practices", "attack-tree-construction", diff --git a/data/catalog.json b/data/catalog.json index 7809e86f..6c3e2377 100644 --- a/data/catalog.json +++ b/data/catalog.json @@ -1,6 +1,6 @@ { "generatedAt": "2026-02-08T00:00:00.000Z", - "total": 713, + "total": 714, "skills": [ { "id": "3d-web-experience", @@ -728,6 +728,30 @@ ], "path": "skills/anti-reversing-techniques/SKILL.md" }, + { + "id": "antigravity-workflows", + "name": "antigravity-workflows", + "description": "Orchestrate multiple Antigravity skills through guided workflows for SaaS MVP delivery, security audits, AI agent builds, and browser QA.", + "category": "security", + "tags": [ + "antigravity" + ], + "triggers": [ + "antigravity", + "orchestrate", + "multiple", + "skills", + "through", + "guided", + "saas", + "mvp", + "delivery", + "security", + "audits", + "ai" + ], + "path": "skills/antigravity-workflows/SKILL.md" + }, { "id": "api-design-principles", "name": "api-design-principles", diff --git a/data/workflows.json b/data/workflows.json new file mode 100644 index 00000000..732851be --- /dev/null +++ b/data/workflows.json @@ -0,0 +1,216 @@ +{ + "generatedAt": "2026-02-10T00:00:00.000Z", + "version": 1, + "workflows": [ + { + "id": "ship-saas-mvp", + "name": "Ship a SaaS MVP", + "description": "End-to-end workflow to scope, build, test, and ship a SaaS MVP quickly.", + "category": "web", + "relatedBundles": [ + "core-dev", + "ops-core" + ], + "steps": [ + { + "title": "Plan the scope", + "goal": "Convert the idea into a clear implementation plan and milestones.", + "recommendedSkills": [ + "brainstorming", + "concise-planning", + "writing-plans" + ], + "notes": "Define problem, user persona, MVP boundaries, and acceptance criteria before coding." + }, + { + "title": "Build backend and API", + "goal": "Implement the core data model, API contracts, and auth baseline.", + "recommendedSkills": [ + "backend-dev-guidelines", + "api-patterns", + "database-design", + "auth-implementation-patterns" + ], + "notes": "Prefer small vertical slices; keep API contracts explicit and testable." + }, + { + "title": "Build frontend", + "goal": "Deliver the primary user flows with production-grade UX patterns.", + "recommendedSkills": [ + "frontend-developer", + "react-patterns", + "frontend-design" + ], + "notes": "Prioritize onboarding, empty states, and one complete happy-path flow." + }, + { + "title": "Test and validate", + "goal": "Catch regressions and ensure key flows work before release.", + "recommendedSkills": [ + "test-driven-development", + "systematic-debugging", + "browser-automation", + "go-playwright" + ], + "notes": "Use go-playwright when the product stack or QA tooling is Go-based." + }, + { + "title": "Ship safely", + "goal": "Release with basic observability and rollback readiness.", + "recommendedSkills": [ + "deployment-procedures", + "observability-engineer", + "postmortem-writing" + ], + "notes": "Define release checklist, minimum telemetry, and rollback triggers." + } + ] + }, + { + "id": "security-audit-web-app", + "name": "Security Audit for a Web App", + "description": "Structured workflow for baseline AppSec review and risk triage.", + "category": "security", + "relatedBundles": [ + "security-core", + "ops-core" + ], + "steps": [ + { + "title": "Define scope and threat model", + "goal": "Identify critical assets, trust boundaries, and threat scenarios.", + "recommendedSkills": [ + "ethical-hacking-methodology", + "threat-modeling-expert", + "attack-tree-construction" + ], + "notes": "Document in-scope targets, assumptions, and out-of-scope constraints." + }, + { + "title": "Review authentication and authorization", + "goal": "Find broken auth patterns and access-control weaknesses.", + "recommendedSkills": [ + "broken-authentication", + "auth-implementation-patterns", + "idor-testing" + ], + "notes": "Prioritize account takeover and privilege escalation paths." + }, + { + "title": "Assess API and input security", + "goal": "Detect high-impact API and injection risks.", + "recommendedSkills": [ + "api-security-best-practices", + "api-fuzzing-bug-bounty", + "top-web-vulnerabilities" + ], + "notes": "Map findings to severity and exploitability, not only CVSS." + }, + { + "title": "Harden and verify", + "goal": "Translate findings into concrete remediations and retest.", + "recommendedSkills": [ + "security-auditor", + "sast-configuration", + "verification-before-completion" + ], + "notes": "Track remediation owners and target dates; verify each fix with evidence." + } + ] + }, + { + "id": "build-ai-agent-system", + "name": "Build an AI Agent System", + "description": "Workflow to design, implement, and evaluate a production-ready AI agent.", + "category": "ai-agents", + "relatedBundles": [ + "core-dev", + "data-core" + ], + "steps": [ + { + "title": "Define use case and reliability targets", + "goal": "Choose a narrow use case and measurable quality goals.", + "recommendedSkills": [ + "ai-agents-architect", + "agent-evaluation", + "product-manager-toolkit" + ], + "notes": "Set latency, quality, and failure-rate thresholds before implementation." + }, + { + "title": "Design architecture and retrieval", + "goal": "Design tools, memory, and retrieval strategy for the agent.", + "recommendedSkills": [ + "llm-app-patterns", + "rag-implementation", + "vector-database-engineer", + "embedding-strategies" + ], + "notes": "Keep retrieval quality measurable and version prompt/tool contracts." + }, + { + "title": "Implement orchestration", + "goal": "Implement the orchestration loop and production safeguards.", + "recommendedSkills": [ + "langgraph", + "mcp-builder", + "workflow-automation" + ], + "notes": "Start with constrained tool permissions and explicit fallback behavior." + }, + { + "title": "Evaluate and iterate", + "goal": "Run benchmark scenarios and improve weak areas systematically.", + "recommendedSkills": [ + "agent-evaluation", + "langfuse", + "kaizen" + ], + "notes": "Use test datasets and failure buckets to guide each iteration cycle." + } + ] + }, + { + "id": "qa-browser-automation", + "name": "QA and Browser Automation", + "description": "Workflow for robust E2E and browser-driven validation across stacks.", + "category": "testing", + "relatedBundles": [ + "core-dev", + "ops-core" + ], + "steps": [ + { + "title": "Prepare test strategy", + "goal": "Define critical user journeys, environments, and test data.", + "recommendedSkills": [ + "e2e-testing-patterns", + "test-driven-development", + "code-review-checklist" + ], + "notes": "Focus on business-critical flows and keep setup deterministic." + }, + { + "title": "Implement browser tests", + "goal": "Automate key flows with resilient locators and stable waits.", + "recommendedSkills": [ + "browser-automation", + "go-playwright" + ], + "notes": "Use go-playwright for Go-native automation projects and Playwright for JS/TS stacks." + }, + { + "title": "Triage failures and harden", + "goal": "Stabilize flaky tests and establish repeatable CI execution.", + "recommendedSkills": [ + "systematic-debugging", + "test-fixing", + "verification-before-completion" + ], + "notes": "Classify failures by root cause: selector drift, timing, environment, data." + } + ] + } + ] +} diff --git a/docs/FAQ.md b/docs/FAQ.md index 1fcf786a..a0942bca 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -11,12 +11,23 @@ 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 626+ skills? +### Do I need to install all 700+ 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) diff --git a/docs/GETTING_STARTED.md b/docs/GETTING_STARTED.md index 8dac2d41..08db5dae 100644 --- a/docs/GETTING_STARTED.md +++ b/docs/GETTING_STARTED.md @@ -15,7 +15,7 @@ AI Agents (like **Claude Code**, **Gemini**, **Cursor**) are smart, but they lac ## ⚑️ Quick Start: The "Starter Packs" -Don't panic about the 626+ skills. You don't need them all at once. +Don't panic about the 700+ 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. @@ -52,6 +52,21 @@ Find the bundle that matches your role (see [BUNDLES.md](BUNDLES.md)): --- +## 🧭 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. @@ -103,7 +118,7 @@ _Check the [Skill Catalog](../CATALOG.md) for the full list._ ## ❓ FAQ -**Q: Do I need to install all 626 skills?** +**Q: Do I need to install all 700+ 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?** diff --git a/docs/WORKFLOWS.md b/docs/WORKFLOWS.md new file mode 100644 index 00000000..25ee8b05 --- /dev/null +++ b/docs/WORKFLOWS.md @@ -0,0 +1,174 @@ +# 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.` + +--- + +## Machine-Readable Workflows + +For tooling and automation, workflow metadata is available in [data/workflows.json](../data/workflows.json). diff --git a/skills/antigravity-workflows/SKILL.md b/skills/antigravity-workflows/SKILL.md new file mode 100644 index 00000000..4fbbe8f6 --- /dev/null +++ b/skills/antigravity-workflows/SKILL.md @@ -0,0 +1,80 @@ +--- +name: antigravity-workflows +description: "Orchestrate multiple Antigravity skills through guided workflows for SaaS MVP delivery, security audits, AI agent builds, and browser QA." +source: self +risk: none +--- + +# Antigravity Workflows + +Use this skill to turn a complex objective into a guided sequence of skill invocations. + +## When to Use This Skill + +Use this skill when: +- The user wants to combine several skills without manually selecting each one. +- The goal is multi-phase (for example: plan, build, test, ship). +- The user asks for best-practice execution for common scenarios like: + - Shipping a SaaS MVP + - Running a web security audit + - Building an AI agent system + - Implementing browser automation and E2E QA + +## Workflow Source of Truth + +Read workflows in this order: +1. `docs/WORKFLOWS.md` for human-readable playbooks. +2. `data/workflows.json` for machine-readable workflow metadata. + +## How to Run This Skill + +1. Identify the user's concrete outcome. +2. Propose the 1-2 best matching workflows. +3. Ask the user to choose one. +4. Execute step-by-step: + - Announce current step and expected artifact. + - Invoke recommended skills for that step. + - Verify completion criteria before moving to next step. +5. At the end, provide: + - Completed artifacts + - Validation evidence + - Remaining risks and next actions + +## Default Workflow Routing + +- Product delivery request -> `ship-saas-mvp` +- Security review request -> `security-audit-web-app` +- Agent/LLM product request -> `build-ai-agent-system` +- E2E/browser testing request -> `qa-browser-automation` + +## Copy-Paste Prompts + +```text +Use @antigravity-workflows to run the "Ship a SaaS MVP" workflow for my project idea. +``` + +```text +Use @antigravity-workflows and execute a full "Security Audit for a Web App" workflow. +``` + +```text +Use @antigravity-workflows to guide me through "Build an AI Agent System" with checkpoints. +``` + +```text +Use @antigravity-workflows to execute the "QA and Browser Automation" workflow and stabilize flaky tests. +``` + +## Limitations + +- This skill orchestrates; it does not replace specialized skills. +- It depends on the local availability of referenced skills. +- It does not guarantee success without environment access, credentials, or required infrastructure. +- For stack-specific browser automation in Go, `go-playwright` may require the corresponding skill to be present in your local skills repository. + +## Related Skills + +- `concise-planning` +- `brainstorming` +- `workflow-automation` +- `verification-before-completion` diff --git a/skills/antigravity-workflows/resources/implementation-playbook.md b/skills/antigravity-workflows/resources/implementation-playbook.md new file mode 100644 index 00000000..9db5deb7 --- /dev/null +++ b/skills/antigravity-workflows/resources/implementation-playbook.md @@ -0,0 +1,36 @@ +# Antigravity Workflows Implementation Playbook + +This document explains how an agent should execute workflow-based orchestration. + +## Execution Contract + +For every workflow: + +1. Confirm objective and scope. +2. Select the best-matching workflow. +3. Execute workflow steps in order. +4. Produce one concrete artifact per step. +5. Validate before continuing. + +## Step Artifact Examples + +- Plan step -> scope document or milestone checklist. +- Build step -> code changes and implementation notes. +- Test step -> test results and failure triage. +- Release step -> rollout checklist and risk log. + +## Safety Guardrails + +- Never run destructive actions without explicit user approval. +- If a required skill is missing, state the gap and fallback to closest available skill. +- When security testing is involved, ensure authorization is explicit. + +## Suggested Completion Format + +At workflow completion, return: + +1. Completed steps +2. Artifacts produced +3. Validation evidence +4. Open risks +5. Suggested next action diff --git a/skills_index.json b/skills_index.json index 85d5ee30..62e06621 100644 --- a/skills_index.json +++ b/skills_index.json @@ -278,6 +278,15 @@ "risk": "unknown", "source": "unknown" }, + { + "id": "antigravity-workflows", + "path": "skills/antigravity-workflows", + "category": "uncategorized", + "name": "antigravity-workflows", + "description": "Orchestrate multiple Antigravity skills through guided workflows for SaaS MVP delivery, security audits, AI agent builds, and browser QA.", + "risk": "none", + "source": "self" + }, { "id": "api-fuzzing-bug-bounty", "path": "skills/api-fuzzing-bug-bounty",