From 068b4b5d2d560c0221251dfc6d08153a6db30c6b Mon Sep 17 00:00:00 2001 From: sck_0 Date: Wed, 28 Jan 2026 18:01:08 +0100 Subject: [PATCH] chore: update code --- .github/MAINTENANCE.md | 6 ++-- CHANGELOG.md | 4 +-- README.md | 30 +++++++++++-------- FAQ.md => docs/FAQ.md | 8 ++--- GETTING_STARTED.md => docs/GETTING_STARTED.md | 14 ++++----- docs/VISUAL_GUIDE.md | 8 ++--- docs/vi/GETTING_STARTED.md | 2 +- skills/README.md | 6 ++-- 8 files changed, 42 insertions(+), 36 deletions(-) rename FAQ.md => docs/FAQ.md (94%) rename GETTING_STARTED.md => docs/GETTING_STARTED.md (89%) diff --git a/.github/MAINTENANCE.md b/.github/MAINTENANCE.md index f8da9d22..7eadfef1 100644 --- a/.github/MAINTENANCE.md +++ b/.github/MAINTENANCE.md @@ -124,8 +124,8 @@ 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. `GETTING_STARTED.md` (Beginner Guide) -3. `FAQ.md` (Troubleshooting) +2. `docs/GETTING_STARTED.md` (Beginner Guide) +3. `docs/FAQ.md` (Troubleshooting) _Common pitfall: Updating the clone URL in README but leaving an old one in FAQ._ @@ -138,7 +138,7 @@ Locations to check: 1. **Title of `README.md`**: "356+ Agentic Skills..." 2. **`## Full Skill Registry (356/356)` header**. -3. **`GETTING_STARTED.md` intro**. +3. **`docs/GETTING_STARTED.md` intro**. ### D. Credits Policy (Who goes where?) diff --git a/CHANGELOG.md b/CHANGELOG.md index 118d9986..1c7d6069 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -99,7 +99,7 @@ The following skills are now correctly indexed and visible in the registry: ### Changed - **Documentation**: Added `docs/CI_DRIFT_FIX.md` as a canonical reference for resolving drift issues. -- **Guidance**: Updated `GETTING_STARTED.md` counts to match the full registry (253+ skills). +- **Guidance**: Updated `docs/GETTING_STARTED.md` counts to match the full registry (253+ skills). - **Maintenance**: Updated `MAINTENANCE.md` with strict protocols for handling generated files. ## [3.0.0] - 2026-01-25 - "The Governance Update" @@ -259,7 +259,7 @@ The following skills are now correctly indexed and visible in the registry: - `cc-skill-project-guidelines-example` - `cc-skill-security-review` - `cc-skill-strategic-compact` -- **Documentation**: New `WALKTHROUGH.md` for import process details. +- **Documentation**: New `docs/WALKTHROUGH.md` for import process details. ### Changed diff --git a/README.md b/README.md index 5c7d7581..ca4c0f25 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# 🌌 Antigravity Awesome Skills: 257+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More +# 🌌 Antigravity Awesome Skills: 552+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More -> **The Ultimate Collection of 257+ Universal Agentic Skills for AI Coding Assistants β€” Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode** +> **The Ultimate Collection of 552+ Universal Agentic Skills for AI Coding Assistants β€” Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode** [![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) @@ -11,7 +11,7 @@ [![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray)](https://github.com/opencode-ai/opencode) [![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/sickn33/antigravity-awesome-skills) -**Antigravity Awesome Skills** is a curated, battle-tested library of **257 high-performance agentic skills** designed to work seamlessly across all major AI coding assistants: +**Antigravity Awesome Skills** is a curated, battle-tested library of **552 high-performance agentic skills** designed to work seamlessly across all major AI coding assistants: - 🟣 **Claude Code** (Anthropic CLI) - πŸ”΅ **Gemini CLI** (Google DeepMind) @@ -29,7 +29,7 @@ This repository provides essential skills to transform your AI assistant into a - [πŸ”Œ Compatibility & Invocation](#compatibility--invocation) - [πŸ“¦ Features & Categories](#features--categories) - [🎁 Curated Collections (Bundles)](#curated-collections) -- [πŸ“š Browse 550+ Skills](#browse-550-skills) +- [πŸ“š Browse 552+ Skills](#browse-552-skills) - [πŸ› οΈ Installation](#installation) - [🀝 How to Contribute](#how-to-contribute) - [πŸ‘₯ Contributors & Credits](#credits--sources) @@ -52,7 +52,7 @@ AI Agents (like Claude Code, Cursor, or Gemini) are smart, but they lack **speci ### 2. ⚑️ Quick Start (The "Bundle" Way) -Don't install 250+ skills manually. Use our **Starter Packs**: +Don't install 552+ skills manually. Use our **Starter Packs**: 1. **Clone the repo**: ```bash @@ -70,7 +70,7 @@ Once installed, just ask your agent naturally: > "Use the **@brainstorming** skill to help me plan a SaaS." > "Run **@lint-and-validate** on this file." -πŸ‘‰ **[Read the Full Getting Started Guide](GETTING_STARTED.md)** +πŸ‘‰ **[Read the Full Getting Started Guide](docs/GETTING_STARTED.md)** --- @@ -104,17 +104,23 @@ This repository aggregates the best capabilities from across the open-source com The repository is organized into specialized domains to transform your AI into an expert across the entire software development lifecycle: -- **Engineering & Architecture**: 50+ skills for Backend, Frontend, DevOps, and System Design including `backend-architect`, `c4-architecture`, and `kubernetes-architect`. -- **AI & Data**: 80+ skills covering LLMs, RAG, Agents (LangChain/CrewAI), and Data Engineering. -- **Security**: 30+ skills for Penetration Testing, Code Auditing, and Security Compliance. -- **Product & Business**: 35+ skills for Startup Analytics, Marketing Strategy, and SEO. -- **Development**: 70+ skills for Python, TypeScript/JavaScript, Rust, Go, and more. +| Category | Focus | Example skills | +| :--- | :--- | :--- | +| Architecture (52) | System design, ADRs, C4, and scalable patterns | `architecture`, `c4-context`, `senior-architect` | +| Business (35) | Growth, pricing, CRO, SEO, and go-to-market | `copywriting`, `pricing-strategy`, `seo-audit` | +| Data & AI (81) | LLM apps, RAG, agents, observability, analytics | `rag-engineer`, `prompt-engineer`, `langgraph` | +| Development (72) | Language mastery, framework patterns, code quality | `typescript-expert`, `python-patterns`, `react-patterns` | +| General (95) | Planning, docs, product ops, writing, guidelines | `brainstorming`, `doc-coauthoring`, `writing-plans` | +| Infrastructure (72) | DevOps, cloud, serverless, deployment, CI/CD | `docker-expert`, `aws-serverless`, `vercel-deployment` | +| Security (107) | AppSec, pentesting, vuln analysis, compliance | `api-security-best-practices`, `sql-injection-testing`, `vulnerability-scanner` | +| Testing (21) | TDD, test design, fixes, QA workflows | `test-driven-development`, `testing-patterns`, `test-fixing` | +| Workflow (17) | Automation, orchestration, jobs, agents | `workflow-automation`, `inngest`, `trigger-dev` | ## Curated Collections [Check out our Starter Packs in docs/BUNDLES.md](docs/BUNDLES.md) to find the perfect toolkit for your role. -## Browse 550+ Skills +## Browse 552+ Skills We have moved the full skill registry to a dedicated catalog to keep this README clean. diff --git a/FAQ.md b/docs/FAQ.md similarity index 94% rename from FAQ.md rename to docs/FAQ.md index 8652a6d8..ec8ba0e3 100644 --- a/FAQ.md +++ b/docs/FAQ.md @@ -11,11 +11,11 @@ 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 256+ skills? +### Do I need to install all 552+ 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](docs/BUNDLES.md) to install only what matches your role. +**Pro Tip:** Use [Starter Packs](BUNDLES.md) to install only what matches your role. ### Which AI tools work with these skills? @@ -116,7 +116,7 @@ Use the `@` symbol followed by the skill name: ### How do I know which skill to use? -1. **Browse the README**: Check the [Full Skill Registry](README.md#full-skill-registry-256256). +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?" @@ -152,7 +152,7 @@ Include: - Fix typos - Add examples - Improve docs - Check out [CONTRIBUTING.md](CONTRIBUTING.md) for instructions. + Check out [CONTRIBUTING.md](../CONTRIBUTING.md) for instructions. ### My PR failed "Quality Bar" check. Why? diff --git a/GETTING_STARTED.md b/docs/GETTING_STARTED.md similarity index 89% rename from GETTING_STARTED.md rename to docs/GETTING_STARTED.md index 07156c62..c401bf7f 100644 --- a/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 256+ skills. You don't need them all at once. +Don't panic about the 552+ skills. You don't need them all at once. We have curated **Starter Packs** to get you running immediately. ### 1. Install the Repo @@ -29,7 +29,7 @@ git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skill ### 2. Pick Your Persona -Find the bundle that matches your role (see [docs/BUNDLES.md](docs/BUNDLES.md)): +Find the bundle that matches your role (see [BUNDLES.md](BUNDLES.md)): | Persona | Bundle Name | What's Inside? | | :-------------------- | :------------- | :------------------------------------------------ | @@ -84,13 +84,13 @@ We classify skills so you know what you're running: - πŸ”΅ **Safe**: Community skills that are non-destructive (Read-only/Planning). - πŸ”΄ **Risk**: Skills that modify systems or perform security tests (Authorized Use Only). -_Check the [Full Registry](README.md#full-skill-registry-256256) for risk labels._ +_Check the [Skill Catalog](../CATALOG.md) for the full list._ --- ## ❓ FAQ -**Q: Do I need to install all 250 skills?** +**Q: Do I need to install all 552 skills?** A: You clone the whole repo, but your AI only _reads_ the ones you ask for (or that are relevant). It's lightweight! **Q: Can I make my own skills?** @@ -103,6 +103,6 @@ A: Yes, MIT License. Open Source forever. ## ⏭️ Next Steps -1. [Browse the Bundles](docs/BUNDLES.md) -2. [See Real-World Examples](docs/EXAMPLES.md) -3. [Contribute a Skill](CONTRIBUTING.md) +1. [Browse the Bundles](BUNDLES.md) +2. [See Real-World Examples](EXAMPLES.md) +3. [Contribute a Skill](../CONTRIBUTING.md) diff --git a/docs/VISUAL_GUIDE.md b/docs/VISUAL_GUIDE.md index 0957a715..3fc6864a 100644 --- a/docs/VISUAL_GUIDE.md +++ b/docs/VISUAL_GUIDE.md @@ -31,9 +31,7 @@ antigravity-awesome-skills/ β”‚ β”œβ”€β”€ πŸ“„ README.md ← Overview & skill list -β”œβ”€β”€ πŸ“„ GETTING_STARTED.md ← Start here! (NEW) β”œβ”€β”€ πŸ“„ CONTRIBUTING.md ← How to contribute -β”œβ”€β”€ πŸ“„ FAQ.md ← Troubleshooting β”‚ β”œβ”€β”€ πŸ“ skills/ ← All 250+ skills live here β”‚ β”‚ @@ -54,6 +52,8 @@ antigravity-awesome-skills/ β”‚ └── πŸ“„ MAINTENANCE.md ← Maintainers Guide β”‚ └── πŸ“ docs/ ← Documentation + β”œβ”€β”€ πŸ“„ GETTING_STARTED.md ← Start here! (NEW) + β”œβ”€β”€ πŸ“„ FAQ.md ← Troubleshooting β”œβ”€β”€ πŸ“„ BUNDLES.md ← Starter Packs (NEW) β”œβ”€β”€ πŸ“„ QUALITY_BAR.md ← Quality Standards β”œβ”€β”€ πŸ“„ SKILL_ANATOMY.md ← How skills work @@ -456,7 +456,7 @@ START HERE β”‚ 5. Submit PR β”‚ β”‚ β”‚ β”‚ πŸ†˜ HELP β”‚ -β”‚ β€’ GETTING_STARTED.md - Basics β”‚ +β”‚ β€’ docs/GETTING_STARTED.md - Basics β”‚ β”‚ β€’ CONTRIBUTING.md - How to contribute β”‚ β”‚ β€’ SKILL_ANATOMY.md - Deep dive β”‚ β”‚ β€’ GitHub Issues - Ask questions β”‚ @@ -505,7 +505,7 @@ Month 1: Regular contributor **Visual learner?** This guide should help! Still have questions? Check out: -- [GETTING_STARTED.md](../GETTING_STARTED.md) - Text-based intro +- [GETTING_STARTED.md](GETTING_STARTED.md) - Text-based intro - [SKILL_ANATOMY.md](SKILL_ANATOMY.md) - Detailed breakdown - [CONTRIBUTING.md](../CONTRIBUTING.md) - How to contribute diff --git a/docs/vi/GETTING_STARTED.md b/docs/vi/GETTING_STARTED.md index a1c8807e..0eb6727c 100644 --- a/docs/vi/GETTING_STARTED.md +++ b/docs/vi/GETTING_STARTED.md @@ -1,6 +1,6 @@ # BαΊ―t Δ‘αΊ§u vα»›i Antigravity Awesome Skills (V3) -[Đọc bαΊ£n gα»‘c tiαΊΏng Anh](./GETTING_STARTED.md) +[Đọc bαΊ£n gα»‘c tiαΊΏng Anh](../GETTING_STARTED.md) **BαΊ‘n lΓ  người mα»›i? HΖ°α»›ng dαΊ«n nΓ y sαΊ½ giΓΊp bαΊ‘n "nΓ’ng cαΊ₯p" trΓ­ tuệ cho AI Agent chỉ trong 5 phΓΊt.** diff --git a/skills/README.md b/skills/README.md index 17a65a38..e536163f 100644 --- a/skills/README.md +++ b/skills/README.md @@ -170,9 +170,9 @@ description: "What this skill does" ## Documentation -- **[Getting Started](../GETTING_STARTED.md)** - Quick start guide +- **[Getting Started](../docs/GETTING_STARTED.md)** - Quick start guide - **[Examples](../docs/EXAMPLES.md)** - Real-world usage examples -- **[FAQ](../FAQ.md)** - Common questions +- **[FAQ](../docs/FAQ.md)** - Common questions - **[Visual Guide](../docs/VISUAL_GUIDE.md)** - Diagrams and flowcharts --- @@ -198,4 +198,4 @@ Found a skill that needs improvement? Want to add a new skill? --- -**Need help?** Check the [FAQ](../FAQ.md) or open an issue on GitHub! +**Need help?** Check the [FAQ](../docs/FAQ.md) or open an issue on GitHub!