@techwavedev/agi-agent-kit 1.1.5 → 1.2.1

package/templates/skills/knowledge/SKILLS_CATALOG.md

@@ -0,0 +1,1066 @@
+# Skills Catalog
+
+> **Auto-generated Documentation** — Last updated: 2026-02-09 13:07
+>
+> This catalog is automatically maintained. Update it by running:
+> ```bash
+> python skill-creator/scripts/update_catalog.py --skills-dir skills/
+> ```
+
+This document provides comprehensive documentation on available skills, how to use them, and when each skill should be triggered.
+
+---
+
+## Table of Contents
+
+- [What Are Skills?](#what-are-skills)
+- [Available Skills](#available-skills)
+  - [Api Patterns](#api-patterns)
+  - [App Builder](#app-builder)
+  - [Architecture](#architecture)
+  - [AWS (Hub)](#aws-hub)
+  - [Aws Terraform](#aws-terraform)
+  - [Bash Linux](#bash-linux)
+  - [Behavioral Modes](#behavioral-modes)
+  - [Brainstorming](#brainstorming)
+  - [Clean Code](#clean-code)
+  - [Code Review Checklist](#code-review-checklist)
+  - [Confluent Kafka](#confluent-kafka)
+  - [Consul](#consul)
+  - [Database Design](#database-design)
+  - [Deployment Procedures](#deployment-procedures)
+  - [Design Md](#design-md)
+  - [Documentation](#documentation)
+  - [Documentation Templates](#documentation-templates)
+  - [Frontend Design](#frontend-design)
+  - [Game Development](#game-development)
+  - [Geo Fundamentals](#geo-fundamentals)
+  - [Gitlab](#gitlab)
+  - [I18N Localization](#i18n-localization)
+  - [Intelligent Routing](#intelligent-routing)
+  - [Jira](#jira)
+  - [Karpenter](#karpenter)
+  - [Lint And Validate](#lint-and-validate)
+  - [Mcp Builder](#mcp-builder)
+  - [Mobile Design](#mobile-design)
+  - [Nextjs Best Practices](#nextjs-best-practices)
+  - [Nodejs Best Practices](#nodejs-best-practices)
+  - [Notebooklm Mcp](#notebooklm-mcp)
+  - [Notebooklm Rag](#notebooklm-rag)
+  - [Opensearch](#opensearch)
+  - [Parallel Agents](#parallel-agents)
+  - [Pdf Reader](#pdf-reader)
+  - [Performance Profiling](#performance-profiling)
+  - [Plan Writing](#plan-writing)
+  - [Plugin Discovery](#plugin-discovery)
+  - [Powershell Windows](#powershell-windows)
+  - [Python Patterns](#python-patterns)
+  - [Qdrant Memory](#qdrant-memory)
+  - [React:Components](#react:components)
+  - [React Patterns](#react-patterns)
+  - [Red Team Tactics](#red-team-tactics)
+  - [Self Update](#self-update)
+  - [Seo Fundamentals](#seo-fundamentals)
+  - [Server Management](#server-management)
+  - [Stitch Loop](#stitch-loop)
+  - [Systematic Debugging](#systematic-debugging)
+  - [Tailwind Patterns](#tailwind-patterns)
+  - [Tdd Workflow](#tdd-workflow)
+  - [Testing Patterns](#testing-patterns)
+  - [Victoriametrics](#victoriametrics)
+  - [Vulnerability Scanner](#vulnerability-scanner)
+  - [Webapp Testing](#webapp-testing)
+  - [Webcrawler](#webcrawler)
+- [Using Skills](#using-skills)
+- [Creating New Skills](#creating-new-skills)
+- [Maintenance](#maintenance)
+
+---
+
+## What Are Skills?
+
+**Skills** are modular, self-contained packages that extend the AI agent's capabilities with specialized knowledge, workflows, and tools.
+
+### Skill Structure
+
+```
+skill-name/
+├── SKILL.md           # (required) Main instruction file
+├── scripts/           # (optional) Executable scripts
+├── references/        # (optional) Documentation
+└── assets/            # (optional) Templates, images, etc.
+```
+
+---
+
+## Available Skills
+
+### AWS (Hub)
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `aws` |
+| **Location** | `skills/aws/` |
+| **Type** | Router / Hub |
+
+**Description:** Comprehensive AWS MCP skill covering ALL AWS services. Use for any AWS-related task - infrastructure, databases, AI/ML, observability, networking, serverless, and more. This single skill provides access to 60+ AWS MCP servers organized by category.
+
+**References:**
+- `references/common_patterns.md`
+- `references/mcp_servers.md`
+
+---
+
+### Confluent Kafka
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `confluent-kafka` |
+| **Location** | `skills/confluent-kafka/` |
+| **Parent** | [Aws](#aws) |
+
+**Description:** Confluent Kafka specialist for tarball/Ansible custom installations. Expert in updating, maintaining, checking health, troubleshooting, documenting, analyzing metrics, and upgrading Confluent Kafka deployments from 7.x to 8.x versions. Covers KRaft mode (ZooKeeper-less), broker configuration, Schema Registry, Connect, ksqlDB, Control Center, and production-grade operations. Use when working with Confluent Platform installations, migrations to KRaft, performance tuning, health monitoring, and infrastructure-as-code with Ansible.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/kafka_health_check.py` | *[See script for details]* |
+| `scripts/upgrade_preflight.py` | *[See script for details]* |
+| `scripts/validate_config.py` | *[See script for details]* |
+
+**References:**
+- `references/ansible_playbooks.md`
+- `references/ec_deployment.md`
+- `references/kraft_migration.md`
+- `references/troubleshooting.md`
+- `references/upgrade_7x_to_8x.md`
+
+---
+
+### Consul
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `consul` |
+| **Location** | `skills/consul/` |
+| **Parent** | [Aws](#aws) |
+
+**Description:** HashiCorp Consul specialist for EKS clusters. Use for Consul service mesh installation, configuration, HA setup, maintenance, updates, upgrades, troubleshooting, and optimization. Covers Consul Connect, intentions, health checks, ACLs, gossip encryption, TLS configuration, federation, and Kubernetes integration via consul-k8s Helm chart. Requires kubectl and helm access to target EKS cluster.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/consul_health_report.py` | *[See script for details]* |
+| `scripts/consul_status.py` | *[See script for details]* |
+| `scripts/generate_values.py` | *[See script for details]* |
+
+**References:**
+- `references/acl_setup.md`
+- `references/ha_config.md`
+- `references/troubleshooting.md`
+- `references/upgrades.md`
+
+---
+
+### Gitlab
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `gitlab` |
+| **Location** | `skills/gitlab/` |
+| **Parent** | [Aws](#aws) |
+
+**Description:** GitLab specialist for Kubernetes agent management on EKS clusters. Use for GitLab agent (agentk) installation, configuration, upgrades, GitOps with Flux, CI/CD pipeline integration, project management via API, token management, and troubleshooting connectivity issues. Covers agent registration, Helm deployments, KAS configuration (self-managed on-prem), impersonation, and multi-cluster setups. Requires kubectl/helm access to target EKS cluster and GitLab API token.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/generate_agent_values.py` | *[See script for details]* |
+| `scripts/gitlab_agent_status.py` | *[See script for details]* |
+
+**References:**
+- `references/agent_installation.md`
+- `references/api_reference.md`
+- `references/gitops_flux.md`
+- `references/troubleshooting.md`
+
+---
+
+### Karpenter
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `karpenter` |
+| **Location** | `skills/karpenter/` |
+| **Parent** | [Aws](#aws) |
+
+**Description:** Karpenter Kubernetes autoscaler specialist for EKS clusters. Use for troubleshooting, documenting, managing, creating, updating, upgrading Karpenter deployments, and obtaining live cluster information. Covers NodePool/EC2NodeClass configuration, cost optimization, node consolidation, drift detection, Spot interruption handling, and migration from Cluster Autoscaler. Requires kubectl access to target EKS cluster.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/generate_ec2nodeclass.py` | *[See script for details]* |
+| `scripts/generate_nodepool.py` | *[See script for details]* |
+| `scripts/karpenter_status.py` | *[See script for details]* |
+
+**References:**
+- `references/ec2nodeclasses.md`
+- `references/migration.md`
+- `references/nodepools.md`
+- `references/troubleshooting.md`
+
+---
+
+### Api Patterns
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `api-patterns` |
+| **Location** | `skills/api-patterns/` |
+| **Type** | Standalone |
+
+**Description:** API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/api_validator.py` | *[See script for details]* |
+
+---
+
+### App Builder
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `app-builder` |
+| **Location** | `skills/app-builder/` |
+| **Type** | Standalone |
+
+**Description:** Main application building orchestrator. Creates full-stack applications from natural language requests. Determines project type, selects tech stack, coordinates agents.
+
+---
+
+### Architecture
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `architecture` |
+| **Location** | `skills/architecture/` |
+| **Type** | Standalone |
+
+**Description:** Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.
+
+---
+
+### Aws Terraform
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `aws-terraform` |
+| **Location** | `skills/aws-terraform/` |
+| **Type** | Standalone |
+
+**Description:** AWS infrastructure deployments using Terraform and Terragrunt. Use for any task involving: (1) Writing, validating, or deploying Terraform/HCL code for AWS, (2) Security scanning with Checkov, (3) AWS provider documentation lookup, (4) Terraform Registry module analysis, (5) Terragrunt multi-environment orchestration, (6) Infrastructure as Code best practices for AWS. Parent skill: aws.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/configure_mcp.py` | *[See script for details]* |
+
+**References:**
+- `references/best_practices.md`
+- `references/checkov_reference.md`
+
+---
+
+### Bash Linux
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `bash-linux` |
+| **Location** | `skills/bash-linux/` |
+| **Type** | Standalone |
+
+**Description:** Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems.
+
+---
+
+### Behavioral Modes
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `behavioral-modes` |
+| **Location** | `skills/behavioral-modes/` |
+| **Type** | Standalone |
+
+**Description:** AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate). Use to adapt behavior based on task type.
+
+---
+
+### Brainstorming
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `brainstorming` |
+| **Location** | `skills/brainstorming/` |
+| **Type** | Standalone |
+
+**Description:** Socratic questioning protocol + user communication. MANDATORY for complex requests, new features, or unclear requirements. Includes progress reporting and error handling.
+
+---
+
+### Clean Code
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `clean-code` |
+| **Location** | `skills/clean-code/` |
+| **Type** | Standalone |
+
+**Description:** Pragmatic coding standards - concise, direct, no over-engineering, no unnecessary comments
+
+---
+
+### Code Review Checklist
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `code-review-checklist` |
+| **Location** | `skills/code-review-checklist/` |
+| **Type** | Standalone |
+
+**Description:** Code review guidelines covering code quality, security, and best practices.
+
+---
+
+### Database Design
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `database-design` |
+| **Location** | `skills/database-design/` |
+| **Type** | Standalone |
+
+**Description:** Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/schema_validator.py` | *[See script for details]* |
+
+---
+
+### Deployment Procedures
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `deployment-procedures` |
+| **Location** | `skills/deployment-procedures/` |
+| **Type** | Standalone |
+
+**Description:** Production deployment principles and decision-making. Safe deployment workflows, rollback strategies, and verification. Teaches thinking, not scripts.
+
+---
+
+### Design Md
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `design-md` |
+| **Location** | `skills/design-md/` |
+| **Type** | Standalone |
+
+**Description:** Analyze Stitch projects and synthesize a semantic design system into DESIGN.md files
+
+---
+
+### Documentation
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `documentation` |
+| **Location** | `skills/documentation/` |
+| **Type** | Standalone |
+
+**Description:** "Automated documentation maintenance and generation skill. Triggers when: (1) Code is added, changed, updated, or deleted in any skill, (2) New scripts or references are created, (3) SKILL.md files are modified, (4) User requests documentation updates, (5) Skills catalog needs regeneration, (6) README or AGENTS.md need updates reflecting code changes. Use for generating technical documentation, updating docs after code changes, producing changelogs, ensuring documentation stays synchronized with the codebase, and maintaining the skills catalog."
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/analyze_code.py` | *[See script for details]* |
+| `scripts/detect_changes.py` | *[See script for details]* |
+| `scripts/generate_changelog.py` | *[See script for details]* |
+| `scripts/sync_docs.py` | *[See script for details]* |
+| `scripts/update_skill_docs.py` | *[See script for details]* |
+
+**References:**
+- `references/best_practices.md`
+
+---
+
+### Documentation Templates
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `documentation-templates` |
+| **Location** | `skills/documentation-templates/` |
+| **Type** | Standalone |
+
+**Description:** Documentation templates and structure guidelines. README, API docs, code comments, and AI-friendly documentation.
+
+---
+
+### Frontend Design
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `frontend-design` |
+| **Location** | `skills/frontend-design/` |
+| **Type** | Standalone |
+
+**Description:** Design thinking and decision-making for web UI. Use when designing components, layouts, color schemes, typography, or creating aesthetic interfaces. Teaches principles, not fixed values.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/accessibility_checker.py` | *[See script for details]* |
+| `scripts/ux_audit.py` | *[See script for details]* |
+
+---
+
+### Game Development
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `game-development` |
+| **Location** | `skills/game-development/` |
+| **Type** | Standalone |
+
+**Description:** Game development orchestrator. Routes to platform-specific skills based on project needs.
+
+---
+
+### Geo Fundamentals
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `geo-fundamentals` |
+| **Location** | `skills/geo-fundamentals/` |
+| **Type** | Standalone |
+
+**Description:** Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/geo_checker.py` | *[See script for details]* |
+
+---
+
+### I18N Localization
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `i18n-localization` |
+| **Location** | `skills/i18n-localization/` |
+| **Type** | Standalone |
+
+**Description:** Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/i18n_checker.py` | *[See script for details]* |
+
+---
+
+### Intelligent Routing
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `intelligent-routing` |
+| **Location** | `skills/intelligent-routing/` |
+| **Type** | Standalone |
+
+**Description:** Automatic agent selection, intelligent task routing, and platform-adaptive orchestration. Analyzes user requests and automatically selects the best specialist agent(s). Detects the runtime platform (Claude Code, Gemini, Opencode) and proactively recommends enabling platform-specific features like Agent Teams and Plugins.
+
+---
+
+### Jira
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `jira` |
+| **Location** | `skills/jira/` |
+| **Type** | Standalone |
+
+**Description:** "Jira ticket management skill for creating, updating, and managing issues. Use for: (1) Creating new tickets/issues with custom fields, (2) Updating existing tickets (status, assignee, priority, labels), (3) Adding and updating comments, (4) Logging work time and time tracking, (5) Searching issues with JQL, (6) Managing transitions and workflows, (7) Bulk operations on multiple tickets, (8) Sprint and board management. Supports both MCP server integration and direct REST API calls. Requires JIRA_API_TOKEN and JIRA_URL environment variables."
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/add_comment.py` | *[See script for details]* |
+| `scripts/bulk_log_work.py` | *[See script for details]* |
+| `scripts/create_ticket.py` | *[See script for details]* |
+| `scripts/get_ticket.py` | *[See script for details]* |
+| `scripts/jira_client.py` | *[See script for details]* |
+| `scripts/log_work.py` | *[See script for details]* |
+| `scripts/search_tickets.py` | *[See script for details]* |
+| `scripts/update_comment.py` | *[See script for details]* |
+| `scripts/update_ticket.py` | *[See script for details]* |
+
+**References:**
+- `references/jql_reference.md`
+
+---
+
+### Lint And Validate
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `lint-and-validate` |
+| **Location** | `skills/lint-and-validate/` |
+| **Type** | Standalone |
+
+**Description:** Automatic quality control, linting, and static analysis procedures. Use after every code modification to ensure syntax correctness and project standards. Triggers onKeywords: lint, format, check, validate, types, static analysis.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/lint_runner.py` | *[See script for details]* |
+| `scripts/type_coverage.py` | *[See script for details]* |
+
+---
+
+### Mcp Builder
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `mcp-builder` |
+| **Location** | `skills/mcp-builder/` |
+| **Type** | Standalone |
+
+**Description:** MCP (Model Context Protocol) server building principles. Tool design, resource patterns, best practices.
+
+---
+
+### Mobile Design
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `mobile-design` |
+| **Location** | `skills/mobile-design/` |
+| **Type** | Standalone |
+
+**Description:** Mobile-first design thinking and decision-making for iOS and Android apps. Touch interaction, performance patterns, platform conventions. Teaches principles, not fixed values. Use when building React Native, Flutter, or native mobile apps.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/mobile_audit.py` | *[See script for details]* |
+
+---
+
+### Nextjs Best Practices
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `nextjs-best-practices` |
+| **Location** | `skills/nextjs-best-practices/` |
+| **Type** | Standalone |
+
+**Description:** Next.js App Router principles. Server Components, data fetching, routing patterns.
+
+---
+
+### Nodejs Best Practices
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `nodejs-best-practices` |
+| **Location** | `skills/nodejs-best-practices/` |
+| **Type** | Standalone |
+
+**Description:** Node.js development principles and decision-making. Framework selection, async patterns, security, and architecture. Teaches thinking, not copying.
+
+---
+
+### Notebooklm Mcp
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `notebooklm-mcp` |
+| **Location** | `skills/notebooklm-mcp/` |
+| **Type** | Standalone |
+
+**Description:** "Connects to Google NotebookLM via MCP using PleasePrompto/notebooklm-mcp. Browser-automated auth, zero-hallucination research, smart library management. Triggers when user asks to research docs, query NotebookLM, or manage notebook libraries."
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/auth_helper.py` | *[See script for details]* |
+| `scripts/list_notebooks_cli.py` | *[See script for details]* |
+
+**References:**
+- `references/api_reference.md`
+
+---
+
+### Notebooklm Rag
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `notebooklm-rag` |
+| **Location** | `skills/notebooklm-rag/` |
+| **Type** | Standalone |
+
+**Description:** "Deep-search RAG knowledge layer powered by Google NotebookLM + Gemini 2.5. Use when explicitly asked to research, investigate, plan with docs, or query knowledge bases. Complement to qdrant-memory (token saver). Triggers on: '@notebooklm', 'research my docs', 'check my notebooks', 'deep search', 'investigate with docs'."
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/preflight_check.py` | *[See script for details]* |
+| `scripts/research_query.py` | *[See script for details]* |
+| `scripts/research_report.py` | *[See script for details]* |
+
+**References:**
+- `references/research_patterns.md`
+
+---
+
+### Opensearch
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `opensearch` |
+| **Location** | `skills/opensearch/` |
+| **Type** | Standalone |
+
+**Description:** OpenSearch specialist covering querying (Query DSL, SQL), performance optimization, cluster management, monitoring, OpenSearch Dashboards, ML/AI (neural search, embeddings, ML Commons), data ingestion (Logstash, Fluent Bit, Data Prepper), OpenSearch Operator for Kubernetes, and MCP integration. Use for any task involving: (1) Writing or optimizing OpenSearch queries, (2) Index design and mapping, (3) Cluster health and performance tuning, (4) OpenSearch Dashboards visualization, (5) Neural/semantic search with vectors, (6) Log and data ingestion pipelines, (7) Kubernetes deployments with OpenSearch Operator.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/configure_mcp.py` | *[See script for details]* |
+
+**References:**
+- `references/ml_neural_search.md`
+- `references/operator.md`
+- `references/query_dsl.md`
+
+---
+
+### Parallel Agents
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `parallel-agents` |
+| **Location** | `skills/parallel-agents/` |
+| **Type** | Standalone |
+
+**Description:** Platform-adaptive multi-agent orchestration. Uses Claude Code Agent Teams when available, subagents as fallback, and sequential persona switching on other platforms. Use when multiple independent tasks can run with different domain expertise or when comprehensive analysis requires multiple perspectives.
+
+---
+
+### Pdf Reader
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `pdf-reader` |
+| **Location** | `skills/pdf-reader/` |
+| **Type** | Standalone |
+
+**Description:** Extract text from PDF files for manipulation, search, and reference. Use when needing to read PDF content, extract text from documents, search within PDFs, or convert PDF to text for further processing. Supports multiple extraction methods (pdfplumber, PyMuPDF, pdfminer) with automatic fallback.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/extract_text.py` | *[See script for details]* |
+
+**References:**
+- `references/pdf_libraries.md`
+
+---
+
+### Performance Profiling
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `performance-profiling` |
+| **Location** | `skills/performance-profiling/` |
+| **Type** | Standalone |
+
+**Description:** Performance profiling principles. Measurement, analysis, and optimization techniques.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/lighthouse_audit.py` | *[See script for details]* |
+
+---
+
+### Plan Writing
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `plan-writing` |
+| **Location** | `skills/plan-writing/` |
+| **Type** | Standalone |
+
+**Description:** Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing features, refactoring, or any multi-step work.
+
+---
+
+### Plugin Discovery
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `plugin-discovery` |
+| **Location** | `skills/plugin-discovery/` |
+| **Type** | Standalone |
+
+**Description:** Platform-adaptive plugin and extension auto-discovery. Detects the runtime environment (Claude Code, Gemini, Opencode, Kiro) and recommends or installs relevant plugins, extensions, MCP servers, and marketplace integrations. Use when setting up a project, onboarding, or when the user asks about available tools/plugins.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/platform_setup.py` | *[See script for details]* |
+
+---
+
+### Powershell Windows
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `powershell-windows` |
+| **Location** | `skills/powershell-windows/` |
+| **Type** | Standalone |
+
+**Description:** PowerShell Windows patterns. Critical pitfalls, operator syntax, error handling.
+
+---
+
+### Python Patterns
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `python-patterns` |
+| **Location** | `skills/python-patterns/` |
+| **Type** | Standalone |
+
+**Description:** Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.
+
+---
+
+### Qdrant Memory
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `qdrant-memory` |
+| **Location** | `skills/qdrant-memory/` |
+| **Type** | Standalone |
+
+**Description:** "Intelligent token optimization through Qdrant-powered semantic caching and long-term memory. Use for (1) Semantic Cache - avoid LLM calls entirely for semantically similar queries with 100% token savings, (2) Long-Term Memory - retrieve only relevant context chunks instead of full conversation history with 80-95% context reduction, (3) Hybrid Search - combine vector similarity with keyword filtering for technical queries, (4) Memory Management - store and retrieve conversation memories, decisions, and code patterns with metadata filtering. Triggers when needing to cache responses, remember past interactions, optimize context windows, or implement RAG patterns."
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/benchmark_token_savings.py` | *[See script for details]* |
+| `scripts/embedding_utils.py` | *[See script for details]* |
+| `scripts/hybrid_search.py` | *[See script for details]* |
+| `scripts/init_collection.py` | *[See script for details]* |
+| `scripts/memory_retrieval.py` | *[See script for details]* |
+| `scripts/semantic_cache.py` | *[See script for details]* |
+| `scripts/test_skill.py` | *[See script for details]* |
+
+**References:**
+- `references/advanced_patterns.md`
+- `references/collection_schemas.md`
+- `references/complete_guide.md`
+- `references/embedding_models.md`
+
+---
+
+### React Patterns
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `react-patterns` |
+| **Location** | `skills/react-patterns/` |
+| **Type** | Standalone |
+
+**Description:** Modern React patterns and principles. Hooks, composition, performance, TypeScript best practices.
+
+---
+
+### React:Components
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `react:components` |
+| **Location** | `skills/react-components/` |
+| **Type** | Standalone |
+
+**Description:** Converts Stitch designs into modular Vite and React components using system-level networking and AST-based validation.
+
+---
+
+### Red Team Tactics
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `red-team-tactics` |
+| **Location** | `skills/red-team-tactics/` |
+| **Type** | Standalone |
+
+**Description:** Red team tactics principles based on MITRE ATT&CK. Attack phases, detection evasion, reporting.
+
+---
+
+### Self Update
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `self-update` |
+| **Location** | `skills/self-update/` |
+| **Type** | Standalone |
+
+**Description:** Update the AGI Agent Kit to the latest version from NPM
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/update_kit.py` | *[See script for details]* |
+
+---
+
+### Seo Fundamentals
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `seo-fundamentals` |
+| **Location** | `skills/seo-fundamentals/` |
+| **Type** | Standalone |
+
+**Description:** SEO fundamentals, E-E-A-T, Core Web Vitals, and Google algorithm principles.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/seo_checker.py` | *[See script for details]* |
+
+---
+
+### Server Management
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `server-management` |
+| **Location** | `skills/server-management/` |
+| **Type** | Standalone |
+
+**Description:** Server management principles and decision-making. Process management, monitoring strategy, and scaling decisions. Teaches thinking, not commands.
+
+---
+
+### Stitch Loop
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `stitch-loop` |
+| **Location** | `skills/stitch-loop/` |
+| **Type** | Standalone |
+
+**Description:** Teaches agents to iteratively build websites using Stitch with an autonomous baton-passing loop pattern
+
+---
+
+### Systematic Debugging
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `systematic-debugging` |
+| **Location** | `skills/systematic-debugging/` |
+| **Type** | Standalone |
+
+**Description:** 4-phase systematic debugging methodology with root cause analysis and evidence-based verification. Use when debugging complex issues.
+
+---
+
+### Tailwind Patterns
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `tailwind-patterns` |
+| **Location** | `skills/tailwind-patterns/` |
+| **Type** | Standalone |
+
+**Description:** Tailwind CSS v4 principles. CSS-first configuration, container queries, modern patterns, design token architecture.
+
+---
+
+### Tdd Workflow
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `tdd-workflow` |
+| **Location** | `skills/tdd-workflow/` |
+| **Type** | Standalone |
+
+**Description:** Test-Driven Development workflow principles. RED-GREEN-REFACTOR cycle.
+
+---
+
+### Testing Patterns
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `testing-patterns` |
+| **Location** | `skills/testing-patterns/` |
+| **Type** | Standalone |
+
+**Description:** Testing patterns and principles. Unit, integration, mocking strategies.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/test_runner.py` | *[See script for details]* |
+
+---
+
+### Victoriametrics
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `victoriametrics` |
+| **Location** | `skills/victoriametrics/` |
+| **Type** | Standalone |
+
+**Description:** VictoriaMetrics time-series database specialist covering deployment (bare metal, Docker, EKS/Kubernetes), cluster architecture (vminsert/vmselect/vmstorage), vmagent configuration, performance optimization, capacity planning, troubleshooting, monitoring, and Prometheus migration/compatibility. Use for any task involving: (1) Installing or upgrading VictoriaMetrics (single-node or cluster), (2) vmagent scraping and remote write configuration, (3) Capacity planning and resource optimization, (4) Prometheus to VictoriaMetrics migration with vmctl, (5) High availability and replication setup, (6) Kubernetes/EKS deployments with Helm or Operator, (7) MetricsQL queries and optimization, (8) Troubleshooting performance issues.
+
+**References:**
+- `references/kubernetes.md`
+- `references/prometheus_migration.md`
+- `references/troubleshooting.md`
+
+---
+
+### Vulnerability Scanner
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `vulnerability-scanner` |
+| **Location** | `skills/vulnerability-scanner/` |
+| **Type** | Standalone |
+
+**Description:** Advanced vulnerability analysis principles. OWASP 2025, Supply Chain Security, attack surface mapping, risk prioritization.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/security_scan.py` | *[See script for details]* |
+
+---
+
+### Webapp Testing
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `webapp-testing` |
+| **Location** | `skills/webapp-testing/` |
+| **Type** | Standalone |
+
+**Description:** Web application testing principles. E2E, Playwright, deep audit strategies.
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/playwright_runner.py` | *[See script for details]* |
+
+---
+
+### Webcrawler
+
+| Property | Value |
+| -------- | ----- |
+| **Name** | `webcrawler` |
+| **Location** | `skills/webcrawler/` |
+| **Type** | Standalone |
+
+**Description:** "Documentation harvesting agent for crawling and extracting content from documentation websites. Use for crawling documentation sites and extracting all pages about a subject, building offline knowledge bases from online docs, harvesting API references, tutorials, or guides from documentation portals, creating structured markdown exports from multi-page documentation, and downloading and organizing technical docs for embedding or RAG pipelines. Supports recursive crawling with depth control, content filtering, and structured output."
+
+**Scripts:**
+
+| Script | Purpose |
+| ------ | ------- |
+| `scripts/crawl_docs.py` | *[See script for details]* |
+| `scripts/extract_page.py` | *[See script for details]* |
+| `scripts/filter_docs.py` | *[See script for details]* |
+
+**References:**
+- `references/advanced_crawling.md`
+
+---
+## Using Skills
+
+Skills are automatically triggered based on the user's request matching the skill description. You can also explicitly invoke a skill:
+
+```
+"Use the <skill-name> skill to <task>"
+```
+
+---
+
+## Creating New Skills
+
+```bash
+# Initialize a new skill
+python skill-creator/scripts/init_skill.py my-new-skill --path skills/
+
+# Package the skill
+python skill-creator/scripts/package_skill.py skills/my-new-skill
+```
+
+For detailed guidance, see: `skill-creator/SKILL_skillcreator.md`
+
+---
+
+## Maintenance
+
+### Updating This Catalog
+
+**IMPORTANT:** This catalog must be updated whenever skills are created, modified, or deleted.
+
+```bash
+python skill-creator/scripts/update_catalog.py --skills-dir skills/
+```
+
+---
+
+*This catalog is part of the [3-Layer Architecture](../AGENTS.md) for reliable AI agent operations.*