port-nuker 1.0.0 → 1.0.1

package/.agent/skills/CONTRIBUTING.md

@@ -1,236 +0,0 @@
-# 🤝 Contributing Guide - V3 Enterprise Edition
-
-**Thank you for wanting to make this repo better!** This guide shows you exactly how to contribute, even if you're new to open source.
-With V3, we raised the bar for quality. Please read the **new Quality Standards** below carefully.
-
----
-
-## 🧐 The "Quality Bar" (V3 Standard)
-
-**Critical for new skills:** Every skill submitted must pass our **5-Point Quality Check** (see `docs/QUALITY_BAR.md` for details):
-
-1.  **Metadata**: Correct Frontmatter (`name`, `description`).
-2.  **Safety**: No harmful commands without "Risk" labels.
-3.  **Clarity**: Clear "When to use" section.
-4.  **Examples**: At least one copy-paste usage example.
-5.  **Actions**: Must define concrete steps, not just "thoughts".
-
----
-
-## Ways to Contribute
-
-You don't need to be an expert! Here are ways anyone can help:
-
-### 1. Improve Documentation (Easiest!)
-
-- Fix typos or grammar
-- Make explanations clearer
-- Add examples to existing skills
-- Translate documentation to other languages
-
-### 2. Report Issues
-
-- Found something confusing? Tell us!
-- Skill not working? Let us know!
-- Have suggestions? We want to hear them!
-
-### 3. Create New Skills
-
-- Share your expertise as a skill
-- Fill gaps in the current collection
-- Improve existing skills
-
-### 4. Test and Validate
-
-- Try skills and report what works/doesn't work
-- Test on different AI tools
-- Suggest improvements
-
----
-
-## How to Create a New Skill
-
-### Step-by-Step Guide
-
-#### Step 1: Choose Your Skill Topic
-
-Ask yourself: "What do I wish my AI assistant knew better?".
-Example: "I'm good at Docker, let me create a Docker skill".
-
-#### Step 2: Create the Folder Structure
-
-Skills live in the `skills/` directory. Use `kebab-case` for folder names.
-
-```bash
-# Navigate to skills
-cd skills/
-
-# Create your skill folder
-mkdir my-awesome-skill
-cd my-awesome-skill
-
-# Create the SKILL.md file
-touch SKILL.md
-```
-
-#### Step 3: Write Your SKILL.md
-
-Every skill needs this basic structure. **Copy this template:**
-
-```markdown
----
-name: my-awesome-skill
-description: "Brief one-line description of what this skill does"
----
-
-# Skill Title
-
-## Overview
-
-Explain what this skill does and when to use it.
-
-## When to Use This Skill
-
-- Use when [scenario 1]
-- Use when [scenario 2]
-
-## How It Works
-
-Detailed step-by-step instructions for the AI...
-
-## Examples
-
-### Example 1
-
-\`\`\`
-code example here
-\`\`\`
-
-## Best Practices
-
-- ✅ Do this
-- ❌ Don't do this
-```
-
-#### Step 4: Validate (CRITICAL V3 STEP)
-
-Run the validation script locally. **We will not merge PRs that fail this check.**
-
-```bash
-# Soft mode (warnings only)
-python3 scripts/validate_skills.py
-
-# Hard mode (what CI runs)
-python3 scripts/validate_skills.py --strict
-```
-
-This checks:
-
-- ✅ `SKILL.md` exists
-- ✅ Frontmatter is correct
-- ✅ Name matches folder name
-- ✅ Quality Bar checks passed
-
-#### Step 5: Submit Your Skill
-
-```bash
-git add skills/my-awesome-skill/
-git commit -m "feat: add my-awesome-skill"
-git push origin my-branch
-```
-
----
-
-## Skill Template (Copy & Paste)
-
-Save time! Copy this template:
-
-```markdown
----
-name: your-skill-name
-description: "One sentence describing what this skill does and when to use it"
----
-
-# Your Skill Name
-
-## Overview
-
-[2-3 sentences explaining what this skill does]
-
-## When to Use This Skill
-
-- Use when you need to [scenario 1]
-- Use when you want to [scenario 2]
-
-## Step-by-Step Guide
-
-### 1. [First Step Name]
-
-[Detailed instructions]
-
-## Examples
-
-### Example 1: [Use Case Name]
-
-\`\`\`language
-// Example code here
-\`\`\`
-
-## Best Practices
-
-- ✅ **Do:** [Good practice]
-- ❌ **Don't:** [What to avoid]
-
-## Troubleshooting
-
-**Problem:** [Common Issue]
-**Solution:** [How to fix it]
-```
-
----
-
-## Commit Message Guidelines
-
-Use these prefixes:
-
-- `feat:` - New skill or major feature
-- `docs:` - Documentation improvements
-- `fix:` - Bug fixes
-- `refactor:` - Code improvements without changing functionality
-- `test:` - Adding or updating tests
-- `chore:` - Maintenance tasks
-
-**Examples:**
-
-```
-feat: add kubernetes-deployment skill
-docs: improve getting started guide
-fix: correct typo in stripe-integration skill
-```
-
----
-
-## Learning Resources
-
-### New to Git/GitHub?
-
-- [GitHub's Hello World Guide](https://guides.github.com/activities/hello-world/)
-- [Git Basics](https://git-scm.com/book/en/v2/Getting-Started-Git-Basics)
-
-### New to Markdown?
-
-- [Markdown Guide](https://www.markdownguide.org/basic-syntax/)
-
----
-
-## Code of Conduct
-
-- Be respectful and inclusive
-- Welcome newcomers
-- Focus on constructive feedback
-- **No harmful content**: See `docs/SECURITY_GUARDRAILS.md`.
-
----
-
-**Thank you for making this project better for everyone!**
-Every contribution, no matter how small, makes a difference. Whether you fix a typo, improve a sentence, or create a whole new skill - you're helping thousands of developers!

package/.agent/skills/FAQ.md

@@ -1,178 +0,0 @@
-# ❓ 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 250+ 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.
-
-### 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 (V3 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/`:
-
-```bash
-git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
-```
-
-**Tool-specific paths:**
-
-- Claude Code: `.claude/skills/`
-- Gemini CLI: `.gemini/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
-
-### How do I invoke a skill?
-
-Use the `@` symbol followed by the skill name:
-
-```
-@brainstorming help me design a todo app
-```
-
-### Can I use multiple skills at once?
-
-**Yes!** You can invoke multiple skills:
-
-```
-@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 README**: Check the [Full Skill Registry](README.md#full-skill-registry-255255).
-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?
-
-V3 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! 🙌

package/.agent/skills/GETTING_STARTED.md

@@ -1,108 +0,0 @@
-# Getting Started with Antigravity Awesome Skills (V3)
-
-**New here? This guide will help you supercharge your AI Agent in 5 minutes.**
-
----
-
-## 🤔 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 255+ skills. You don't need them all at once.
-We have curated **Starter Packs** to get you running immediately.
-
-### 1. Install the Repo
-
-Copy the skills to your agent's folder:
-
-```bash
-# Universal Installation (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 [docs/BUNDLES.md](docs/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)     |
-
----
-
-## 🚀 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/` |
-| **Antigravity** | ✅ Native       | `.agent/skills/`  |
-| **Cursor**      | ✅ Native       | `.cursor/skills/` |
-| **Copilot**     | ⚠️ Text Only    | Manual copy-paste |
-
----
-
-## 🛡️ Trust & Safety (New in V3)
-
-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 [Full Registry](README.md#full-skill-registry-255255) for risk labels._
-
----
-
-## ❓ FAQ
-
-**Q: Do I need to install all 250 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?**
-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](docs/BUNDLES.md)
-2. [See Real-World Examples](docs/EXAMPLES.md)
-3. [Contribute a Skill](CONTRIBUTING.md)

package/.agent/skills/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Antigravity User
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.