port-nuker 1.0.0 → 1.0.1

package/.agent/skills/.github/MAINTENANCE.md

@@ -1,230 +0,0 @@
-# 🛠️ Repository Maintenance Guide (V3)
-
-> **"If it's not documented, it's broken."**
-
-This guide details the exact procedures for maintaining `antigravity-awesome-skills`.
-It covers the **Quality Bar**, **Documentation Consistency**, and **Release Workflows**.
-
----
-
-## 0. 🤖 Agent Protocol (THE BIBLE)
-
-**AGENTS MUST READ AND FOLLOW THIS SECTION BEFORE MARKING ANY TASK AS COMPLETE.**
-
-There are 3 things that usually fail/get forgotten. **DO NOT FORGET THEM:**
-
-### 1. 📤 ALWAYS PUSH (Non-Negotiable)
-
-Committing is NOT enough. You must PUSH to the remote.
-
-- **BAD**: `git commit -m "feat: new skill"` (User sees nothing)
-- **GOOD**: `git commit -m "..." && git push origin main`
-
-### 2. 🔄 SYNC GENERATED FILES (Avoid CI Drift)
-
-If you touch `skills/`, you **MUST** run the validation chain.
-
-- Running `validate_skills.py` is NOT optional.
-- Running `generate_index.py` is NOT optional.
-- Running `update_readme.py` is NOT optional.
-  _If CI fails because of drift, you have failed._
-
-### 3. 📝 EVIDENCE OF WORK
-
-- You must create/update `walkthrough.md` or `RELEASE_NOTES.md` to document what changed.
-- If you made something new, **link it** in the artifacts.
-
-### 4. 🚫 NO BRANCHES
-
-- **ALWAYS use the `main` branch.**
-- NEVER create feature branches (e.g., `feat/new-skill`).
-- We commit directly to `main` to keep history linear and simple.
-
----
-
-## 1. 🚦 Daily Maintenance Routine
-
-### A. Validation Chain
-
-Before ANY commit that adds/modifies skills, run the chain:
-
-1.  **Validate Metadata & Quality**:
-
-    ```bash
-    python3 scripts/validate_skills.py
-    ```
-
-    _Must return 0 errors for new skills._
-
-2.  **Regenerate Index**:
-    python3 scripts/generate_index.py
-
-    ```
-
-    ```
-
-3.  **Update Readme**:
-
-    ```bash
-    python3 scripts/update_readme.py
-    ```
-
-4.  **COMMIT GENERATED FILES**:
-    ```bash
-    git add skills_index.json README.md
-    git commit -m "chore: sync generated files"
-    ```
-    > 🔴 **CRITICAL**: If you skip this, CI will fail with "Detected uncommitted changes".
-    > See [docs/CI_DRIFT_FIX.md](../docs/CI_DRIFT_FIX.md) for details.
-
-### B. Post-Merge Routine (Must Do)
-
-After multiple PR merges or significant changes:
-
-1.  **Sync Contributors List**:
-    - Run: `git shortlog -sn --all`
-    - Update `## Repo Contributors` in README.md.
-
-2.  **Verify Table of Contents**:
-    - Ensure all new headers have clean anchors.
-    - **NO EMOJIS** in H2 headers.
-
-3.  **Draft a Release**:
-    - Go to [Releases Page](https://github.com/sickn33/antigravity-awesome-skills/releases).
-    - Draft a new release for the merged changes.
-    - Tag version (e.g., `v3.1.0`).
-
----
-
-## 2. 📝 Documentation "Pixel Perfect" Rules
-
-We discovered several consistency issues during V3 development. Follow these rules STRICTLY.
-
-### A. Table of Contents (TOC) Anchors
-
-GitHub's anchor generation breaks if headers have emojis.
-
-- **BAD**: `## 🚀 New Here?` -> Anchor: `#--new-here` (Broken)
-- **GOOD**: `## New Here?` -> Anchor: `#new-here` (Clean)
-
-**Rule**: **NEVER put emojis in H2 (`##`) headers.** Put them in the text below if needed.
-
-### B. The "Trinity" of Docs
-
-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)
-
-_Common pitfall: Updating the clone URL in README but leaving an old one in FAQ._
-
-### C. Statistics Consistency (CRITICAL)
-
-If you add/remove skills, you **MUST** ensure the total count is identical in ALL locations.
-**Do not allow drift** (e.g., 356 in title, 354 in header).
-
-Locations to check:
-
-1.  **Title of `README.md`**: "356+ Agentic Skills..."
-2.  **`## Full Skill Registry (356/356)` header**.
-3.  **`GETTING_STARTED.md` intro**.
-
-### D. Credits Policy (Who goes where?)
-
-- **Credits & Sources**: Use this for **External Repos**.
-  - _Rule_: "I extracted skills from this link you sent me." -> Add to `## Credits & Sources`.
-- **Repo Contributors**: Use this for **Pull Requests**.
-  - _Rule_: "This user sent a PR." -> Add to `## Repo Contributors`.
-
-### E. Badges & Links
-
-- **Antigravity Badge**: Must point to `https://github.com/sickn33/antigravity-awesome-skills`, NOT `anthropics/antigravity`.
-- **License**: Ensure the link points to `LICENSE` file.
-
----
-
-## 3. 🛡️ Governance & Quality Bar
-
-### A. The 5-Point Quality Check
-
-Reject any PR that fails this:
-
-1.  **Metadata**: Has `name`, `description`?
-2.  **Safety**: `risk: offensive` used for red-team tools?
-3.  **Clarity**: Does it say _when_ to use it?
-4.  **Examples**: Copy-pasteable code blocks?
-5.  **Actions**: "Run this command" vs "Think about this".
-
-### B. Risk Labels (V3)
-
-- ⚪ **Safe**: Default.
-- 🔴 **Risk**: Destructive/Security tools. MUST have `[Authorized Use Only]` warning.
-- 🟣 **Official**: Vendor mirrors only.
-
----
-
-## 4. 🚀 Release Workflow
-
-When cutting a new version (e.g., V4):
-
-1.  **Run Full Validation**: `python3 scripts/validate_skills.py --strict`
-2.  **Update Changelog**: Create `RELEASE_NOTES.md`.
-3.  **Bump Version**: Update header in `README.md`.
-4.  **Tag Release**:
-    ```bash
-    git tag -a v3.0.0 -m "V3 Enterprise Edition"
-    git push origin v3.0.0
-    ```
-
-### 📋 Release Note Template
-
-All changeslogs/release notes MUST follow this structure to ensure professionalism and quality:
-
-```markdown
-# Release vX.Y.Z: [Theme Name]
-
-> **[One-line catchy summary of the release]**
-
-[Brief 2-3 sentence intro about the release's impact]
-
-## 🚀 New Skills
-
-### [Emoji] [Skill Name](skills/skill-name/)
-
-**[Bold high-level benefit]**
-[Description of what it does]
-
-- **Key Feature 1**: [Detail]
-- **Key Feature 2**: [Detail]
-
-> **Try it:** `(User Prompt) ...`
-
----
-
-## 📦 Improvements
-
-- **Registry Update**: Now tracking [N] skills.
-- **[Component]**: [Change detail]
-
-## 👥 Credits
-
-A huge shoutout to our community contributors:
-
-- **@username** for `skill-name`
-- **@username** for `fix-name`
-
----
-
-_Upgrade now: `git pull origin main` to fetch the latest skills._
-```
-
----
-
-## 5. 🚨 Emergency Fixes
-
-If a skill is found to be harmful or broken:
-
-1.  **Move to broken folder** (don't detect): `mv skills/bad-skill skills/.broken/`
-2.  **Or Add Warning**: Add `> [!WARNING]` to the top of `SKILL.md`.
-3.  **Push Immediately**.

package/.agent/skills/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,23 +0,0 @@
-# Pull Request Description
-
-Please include a summary of the change and which skill is added or fixed.
-
-## Quality Bar Checklist ✅
-
-**All items must be checked before merging.**
-
-- [ ] **Standards**: I have read `docs/QUALITY_BAR.md` and `docs/SECURITY_GUARDRAILS.md`.
-- [ ] **Metadata**: The `SKILL.md` frontmatter is valid (checked with `scripts/validate_skills.py`).
-- [ ] **Risk Label**: I have assigned the correct `risk:` tag (`none`, `safe`, `critical`, `offensive`).
-- [ ] **Triggers**: The "When to use" section is clear and specific.
-- [ ] **Security**: If this is an _offensive_ skill, I included the "Authorized Use Only" disclaimer.
-- [ ] **Local Test**: I have verified the skill works locally.
-- [ ] **Credits**: I have added the source credit in `README.md` (if applicable).
-
-## Type of Change
-
-- [ ] New Skill (Feature)
-- [ ] Documentation Update
-- [ ] Infrastructure
-
-## Screenshots (if applicable)

package/.agent/skills/.github/workflows/ci.yml

@@ -1,38 +0,0 @@
-name: Skills Registry CI
-
-on:
-  push:
-    branches: ["main", "feat/*"]
-  pull_request:
-    branches: ["main"]
-
-jobs:
-  validate-and-build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-
-      - name: Install dependencies
-        run: |
-          pip install pyyaml
-
-      - name: 🔍 Validate Skills (Soft Mode)
-        run: |
-          python3 scripts/validate_skills.py
-
-      - name: 🏗️ Generate Index
-        run: |
-          python3 scripts/generate_index.py
-
-      - name: 📝 Update README
-        run: |
-          python3 scripts/update_readme.py
-
-      - name: 🚨 Check for Uncommitted Drift
-        run: |
-          git diff --exit-code || (echo "❌ Detected uncommitted changes in README.md or skills_index.json. Please run scripts locally and commit." && exit 1)

package/.agent/skills/CHANGELOG.md

@@ -1,359 +0,0 @@
-# Changelog
-
-All notable changes to the **Antigravity Awesome Skills** collection are documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
----
-
----
-
----
-
-## [3.3.0] - 2026-01-26 - "News & Research"
-
-### Added
-
-- **New Skills**:
-  - `last30days`: Research any topic from the last 30 days on Reddit + X + Web.
-  - `daily-news-report`: Generate daily news reports from multiple sources.
-
-### Changed
-
-- **Registry**: Updated `skills_index.json` and `README.md` registry (Total: 255 skills).
-
-## [3.2.0] - 2026-01-26 - "Clarity & Consistency"
-
-### Changed
-
-- **Skills Refactoring**: Significant overhaul of `backend-dev-guidelines`, `frontend-design`, `frontend-dev-guidelines`, and `mobile-design`.
-  - **Consolidation**: Merged fragmented documentation into single, authoritative `SKILL.md` files.
-  - **Final Laws**: Introduced "Final Laws" sections to provide strict, non-negotiable decision frameworks.
-  - **Simplification**: Removed external file dependencies to improve context retrieval for AI agents.
-
-### Fixed
-
-- **Validation**: Fixed critical YAML frontmatter formatting issues in `seo-fundamentals`, `programmatic-seo`, and `schema-markup` that were blocking strict validation.
-- **Merge Conflicts**: Resolved text artifact conflicts in SEO skills.
-
-## [3.1.0] - 2026-01-26 - "Stable & Deterministic"
-
-### Fixed
-
-- **CI/CD Drift**: Resolved persistent "Uncommitted Changes" errors in CI by making the index generation script deterministic (sorting by name + ID).
-- **Registry Sync**: Synced `README.md` and `skills_index.json` to accurately reflect all 253 skills.
-
-### Added (Registry Restore)
-
-The following skills are now correctly indexed and visible in the registry:
-
-- **Marketing & Growth**: `programmatic-seo`, `schema-markup`, `seo-fundamentals`, `form-cro`, `popup-cro`, `analytics-tracking`.
-- **Security**: `windows-privilege-escalation`, `wireshark-analysis`, `wordpress-penetration-testing`, `writing-plans`.
-- **Development**: `tdd-workflow`, `web-performance-optimization`, `webapp-testing`, `workflow-automation`, `zapier-make-patterns`.
-- **Maker Tools**: `telegram-bot-builder`, `telegram-mini-app`, `viral-generator-builder`.
-
-### 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).
-- **Maintenance**: Updated `MAINTENANCE.md` with strict protocols for handling generated files.
-
-## [3.0.0] - 2026-01-25 - "The Governance Update"
-
-### Added
-
-- **Governance & Security**:
-  - `docs/QUALITY_BAR.md`: Defined 5-point validation standard (Metadata, Risk, Triggers).
-  - `docs/SECURITY_GUARDRAILS.md`: Enforced "Authorized Use Only" for offensive skills.
-  - `CODE_OF_CONDUCT.md`: Adhered to Contributor Covenant v2.1.
-- **Automation**:
-  - `scripts/validate_skills.py`: Automated Quality Bar enforcement (Soft Mode supported).
-  - `.github/workflows/ci.yml`: Automated PR checks.
-  - `scripts/generate_index.py`: Registry generation with Risk & Source columns.
-- **Experience**:
-  - `docs/BUNDLES.md`: 9 Starter Packs (Essentials, Security, Web, Agent, Game Dev, DevOps, Data, Testing, Creative).
-  - **Interactive Registry**: README now features Risk Levels (🔴/🟢/🟣) and Collections.
-- **Documentation**:
-  - `docs/EXAMPLES.md`: Cookbook with 3 real-world scenarios.
-  - `docs/SOURCES.md`: Legal ledger for attributions and licenses.
-  - `RELEASE_NOTES.md`: Generated release announcement (archived).
-
-### Changed
-
-- **Standardization**: All 250+ skills are now validated against the new Quality Bar schema.
-- **Project Structure**: Introduced `docs/` folder for scalable documentation.
-
-## [2.14.0] - 2026-01-25 - "Web Intelligence & Windows"
-
-### Added
-
-- **New Skill**:
-  - `context7-auto-research`: Auto-research capability for Claude Code.
-  - `codex-review`: Professional code review with AI integration.
-  - `exa-search`: Semantic search and discovery using Exa API.
-  - `firecrawl-scraper`: Deep web scraping and PDF parsing.
-  - `tavily-web`: Content extraction and research using Tavily.
-  - `busybox-on-windows`: UNIX tool suite for Windows environments.
-
-### Changed
-
-- **Documentation**: Updated `obsidian-clipper-template-creator` docs and templates.
-- **Index & Registry**: Updated `skills_index.json` and `README.md` registry.
-
-### Fixed
-
-- **Skills**: Fixed YAML frontmatter quoting in `lint-and-validate`.
-
-## [2.13.0] - 2026-01-24 - "NoSQL Expert"
-
-### Added
-
-- **New Skill**:
-  - `nosql-expert`: Expert guidance for distributed NoSQL databases (Cassandra, DynamoDB), focusing on query-first modeling and anti-patterns.
-
-### Changed
-
-- **Index & Registry**: Updated `skills_index.json` and `README.md` registry.
-
-### Contributors
-
-- [@sickn33](https://github.com/sickn33) - PR #23
-
-## [2.12.0] - 2026-01-23 - "Enterprise & UI Power"
-
-### Added
-
-- **New Skills**:
-  - `production-code-audit`: Comprehensive enterprise auditing skill for production readiness.
-  - `avalonia-layout-zafiro`: Zafiro layout guidelines for Avalonia UI.
-  - `avalonia-viewmodels-zafiro`: ViewModel composition patterns for Avalonia.
-  - `avalonia-zafiro-development`: Core development rules for Avalonia Zafiro applications.
-
-### Changed
-
-- **Index & Registry**: Updated `skills_index.json` and `README.md` registry (Total: 243 skills).
-
-### Contributors
-
-- [@SuperJMN](https://github.com/SuperJMN) - PR #20
-- [@Mohammad-Faiz-Cloud-Engineer](https://github.com/Mohammad-Faiz-Cloud-Engineer) - PR #21
-
-## [2.11.0] - 2026-01-23 - "Postgres Performance"
-
-### Added
-
-- **New Skill**:
-  - `postgres-best-practices`: Comprehensive Supabase PostgreSQL performance optimization guide with 30+ rules covering query performance, connection management, RLS security, schema design, locking, and monitoring.
-
-### Changed
-
-- **Official Sources**: Added [supabase/agent-skills](https://github.com/supabase/agent-skills) to Credits & Sources.
-- **Index & Registry**: Updated `skills_index.json` and `README.md` registry (Total: 239 skills).
-
-### Contributors
-
-- [@ar27111994](https://github.com/ar27111994) - PR #19
-
----
-
-## [2.10.0] - 2026-01-22 - "Developer Excellence"
-
-### Added
-
-- **New Skills**:
-  - `api-security-best-practices`: Comprehensive guide for secure API design and defense.
-  - `environment-setup-guide`: Systematic approach to project onboarding and tool configuration.
-  - `web-performance-optimization`: Methodologies for optimizing Core Web Vitals and loading speed.
-
-### Changed
-
-- **Enhanced Skill**:
-  - `code-review-checklist`: Replaced with a much more detailed and systematic version covering functionality, security, and quality.
-
-### Fixed
-
-- **Index & Registry**: Updated `skills_index.json` and `README.md` registry (Total: 238 skills).
-
-### Added
-
-- **Automation Support**:
-  - `scripts/update_readme.py`: Automated script to sync skill counts and regenerate the registry table.
-  - Updated `MAINTENANCE.md` to reflect the new automated workflow.
-- **Repository Quality**:
-  - `MAINTENANCE.md` is now tracked in the repository (removed from `.gitignore`).
-  - Improved contribution guidelines.
-
-## [2.8.0] - 2026-01-22 - "Documentation Power"
-
-### Added
-
-- **API Documentation Generator**: New skill to automatically generate comprehensive API documentation (`skills/api-documentation-generator`).
-- **Remotion Best Practices**: 28 modular rules for programmatic video creation (`skills/remotion-best-practices`).
-
-## [2.7.0] - 2026-01-22 - "Agent Memory"
-
-### Added
-
-- **Agent Memory MCP**: New skill providing persistent, searchable knowledge management for AI agents (`skills/agent-memory-mcp`).
-
-### Changed
-
-- **Renamed Skill**: `agent-memory` was renamed to `agent-memory-mcp` to avoid naming conflicts.
-
----
-
-## [2.6.0] - 2026-01-21 - "Everything Skills Edition"
-
-### Added
-
-- **8 Verified Skills** from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code):
-  - `cc-skill-backend-patterns`
-  - `cc-skill-clickhouse-io`
-  - `cc-skill-coding-standards`
-  - `cc-skill-continuous-learning`
-  - `cc-skill-frontend-patterns`
-  - `cc-skill-project-guidelines-example`
-  - `cc-skill-security-review`
-  - `cc-skill-strategic-compact`
-- **Documentation**: New `WALKTHROUGH.md` for import process details.
-
-### Changed
-
-- **Skill Cleanup**: Removed 27 unwanted agents, commands, and rules from the `everything-claude-code` import to focus strictly on skills.
-- **Index**: Regenerated `skills_index.json` (Total: 233 skills).
-- **Credits**: Updated README credits and registry.
-
-## [1.0.0] - 2026-01-19 - "Marketing Edition"
-
-### Added
-
-- **23 Marketing & Growth skills** from [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills):
-  - **CRO**: `page-cro`, `signup-flow-cro`, `onboarding-cro`, `form-cro`, `popup-cro`, `paywall-upgrade-cro`
-  - **Content**: `copywriting`, `copy-editing`, `email-sequence`
-  - **SEO**: `seo-audit`, `programmatic-seo`, `schema-markup`, `competitor-alternatives`
-  - **Paid**: `paid-ads`, `social-content`
-  - **Growth**: `referral-program`, `launch-strategy`, `free-tool-strategy`
-  - **Analytics**: `ab-test-setup`, `analytics-tracking`
-  - **Strategy**: `pricing-strategy`, `marketing-ideas`, `marketing-psychology`
-- New "Marketing & Growth" category in Features table
-
-### Changed
-
-- Total skills count: **179**
-
----
-
-## [0.7.0] - 2026-01-19 - "Education Edition"
-
-### Added
-
-- **Moodle External API Development** skill via PR #6
-- Comprehensive Moodle LMS web service API development
-
-### Changed
-
-- Total skills count: **156**
-
----
-
-## [0.6.0] - 2026-01-19 - "Vibeship Integration"
-
-### Added
-
-- **57 skills** from [vibeforge1111/vibeship-spawner-skills](https://github.com/vibeforge1111/vibeship-spawner-skills):
-  - AI Agents category (~30 skills)
-  - Integrations & APIs (~25 skills)
-  - Maker Tools (~11 skills)
-- Alphabetically sorted skill registry
-
-### Changed
-
-- Total skills count: **155**
-
----
-
-## [0.5.0] - 2026-01-18 - "Agent Manager"
-
-### Added
-
-- **Agent Manager Skill** - Multi-agent orchestration via tmux
-- Major repository expansion with community contributions
-
-### Changed
-
-- Total skills count: **131**
-
----
-
-## [0.4.0] - 2026-01-18 - "Security Fortress"
-
-### Added
-
-- **60+ Cybersecurity skills** from [zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide):
-  - Ethical Hacking Methodology
-  - Metasploit Framework
-  - Burp Suite Testing
-  - SQLMap, Active Directory, AWS Pentesting
-  - OWASP Top 100 Vulnerabilities
-  - Red Team Tools
-- `claude-code-guide` skill
-
-### Changed
-
-- Total skills count: ~90
-
----
-
-## [0.3.0] - 2026-01-17 - "First Stable Registry"
-
-### Added
-
-- Complete skill registry table in README
-- GitHub workflow automation
-- SEO optimizations
-
-### Changed
-
-- Total skills count: **71**
-
----
-
-## [0.2.0] - 2026-01-16 - "Official Skills"
-
-### Added
-
-- **Official Anthropic skills** integration
-- **Vercel Labs skills** integration
-- BlockRun: Agent Wallet for LLM Micropayments
-- 7 new skills from GitHub analysis
-
-### Changed
-
-- Total skills count: **~65**
-
----
-
-## [0.1.0] - 2026-01-15 - "Initial Release"
-
-### Added
-
-- **58 core skills** aggregated from community:
-  - [obra/superpowers](https://github.com/obra/superpowers) - Original Superpowers
-  - [guanyang/antigravity-skills](https://github.com/guanyang/antigravity-skills) - Core extensions
-  - [diet103/claude-code-infrastructure-showcase](https://github.com/diet103/claude-code-infrastructure-showcase) - Infrastructure skills
-  - [ChrisWiles/claude-code-showcase](https://github.com/ChrisWiles/claude-code-showcase) - React UI patterns
-  - [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) - Loki Mode
-  - [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills) - Senior Engineering
-- Universal **SKILL.md** format
-- Compatibility with Claude Code, Gemini CLI, Cursor, Copilot, Antigravity
-
----
-
-## Credits
-
-See [README.md](README.md#credits--sources) for full attribution.
-
-## License
-
-MIT License - See [LICENSE](LICENSE) for details.