@agentskillkit/agent-skills 1.0.1

package/.agent/.shared/ui-ux-pro-max/scripts/search.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/.agent/ARCHITECTURE.md

@@ -0,0 +1,292 @@
+# Agent Skills Kit Architecture
+
+> Comprehensive AI Agent Capability Expansion Toolkit
+
+---
+
+## 📋 Overview
+
+Antigravity Kit is a modular system consisting of:
+
+- **20 Specialist Agents** - Role-based AI personas
+- **48 Skills** - Domain-specific knowledge modules
+- **14 Workflows** - Slash command procedures
+
+---
+
+## 🏗️ Directory Structure
+
+```plaintext
+.agent/
+├── ARCHITECTURE.md          # This file
+├── agents/                  # 20 Specialist Agents
+├── skills/                  # 48 Skills
+├── workflows/               # 14 Slash Commands
+├── rules/                   # Global Rules
+└── scripts/                 # Master Validation Scripts
+```
+
+---
+
+## 🤖 Agents (20)
+
+Specialist AI personas for different domains.
+
+| Agent | Focus | Skills Used |
+| ----- | ----- | ----------- |
+| `orchestrator` | Multi-agent coordination | parallel-agents, behavioral-modes |
+| `project-planner` | Discovery, task planning | brainstorming, plan-writing, architecture |
+| `frontend-specialist` | Web UI/UX | frontend-design, react-patterns, tailwind-patterns |
+| `backend-specialist` | API, business logic | api-patterns, nodejs-best-practices, database-design |
+| `database-architect` | Schema, SQL | database-design, prisma-expert |
+| `mobile-developer` | iOS, Android, RN | mobile-design |
+| `game-developer` | Game logic, mechanics | game-development |
+| `devops-engineer` | CI/CD, Docker | deployment-procedures, docker-expert |
+| `security-auditor` | Security compliance | vulnerability-scanner, red-team-tactics |
+| `penetration-tester` | Offensive security | red-team-tactics |
+| `test-engineer` | Testing strategies | testing-patterns, tdd-workflow, webapp-testing |
+| `debugger` | Root cause analysis | systematic-debugging |
+| `performance-optimizer` | Speed, Web Vitals | performance-profiling |
+| `seo-specialist` | Ranking, visibility | seo-fundamentals, geo-fundamentals |
+| `documentation-writer` | Manuals, docs | documentation-templates |
+| `product-manager` | Requirements, user stories | plan-writing, brainstorming |
+| `product-owner` | Strategy, backlog, MVP | plan-writing, brainstorming |
+| `qa-automation-engineer` | E2E testing, CI pipelines | webapp-testing, testing-patterns |
+| `code-archaeologist` | Legacy code, refactoring | clean-code, code-review-checklist |
+| `explorer-agent` | Codebase analysis | - |
+
+---
+
+## 🧩 Skills (36)
+
+Modular knowledge domains that agents can load on-demand. based on task context.
+
+### Frontend & UI
+
+| Skill | Description |
+| ----- | ----------- |
+| `react-patterns` | React hooks, state, performance |
+| `nextjs-best-practices` | App Router, Server Components |
+| `tailwind-patterns` | Tailwind CSS v4 utilities |
+| `frontend-design` | UI/UX patterns, design systems |
+| `ui-ux-pro-max` | 50 styles, 21 palettes, 50 fonts |
+
+### Backend & API
+
+| Skill | Description |
+| ----- | ----------- |
+| `api-patterns` | REST, GraphQL, tRPC |
+| `nestjs-expert` | NestJS modules, DI, decorators |
+| `nodejs-best-practices` | Node.js async, modules |
+| `python-patterns` | Python standards, FastAPI |
+
+### Database
+
+| Skill | Description |
+| ----- | ----------- |
+| `database-design` | Schema design, optimization |
+| `prisma-expert` | Prisma ORM, migrations |
+
+### TypeScript/JavaScript
+
+| Skill | Description |
+| ----- | ----------- |
+| `typescript-expert` | Type-level programming, performance |
+
+### Cloud & Infrastructure
+
+| Skill | Description |
+| ----- | ----------- |
+| `docker-expert` | Containerization, Compose |
+| `deployment-procedures` | CI/CD, deploy workflows |
+| `server-management` | Infrastructure management |
+
+### Testing & Quality
+
+| Skill | Description |
+| ----- | ----------- |
+| `testing-patterns` | Jest, Vitest, strategies |
+| `webapp-testing` | E2E, Playwright |
+| `tdd-workflow` | Test-driven development |
+| `code-review-checklist` | Code review standards |
+| `lint-and-validate` | Linting, validation |
+
+### Security
+
+| Skill | Description |
+| ----- | ----------- |
+| `vulnerability-scanner` | Security auditing, OWASP |
+| `red-team-tactics` | Offensive security |
+
+### Architecture & Planning
+
+| Skill | Description |
+| ----- | ----------- |
+| `app-builder` | Full-stack app scaffolding |
+| `architecture` | System design patterns |
+| `plan-writing` | Task planning, breakdown |
+| `brainstorming` | Socratic questioning |
+
+### Mobile
+
+| Skill | Description |
+| ----- | ----------- |
+| `mobile-design` | Mobile UI/UX patterns |
+
+### Game Development
+
+| Skill | Description |
+| ----- | ----------- |
+| `game-development` | Game logic, mechanics |
+
+### SEO & Growth
+
+| Skill | Description |
+| ----- | ----------- |
+| `seo-fundamentals` | SEO, E-E-A-T, Core Web Vitals |
+| `geo-fundamentals` | GenAI optimization |
+
+### Shell/CLI
+
+| Skill | Description |
+| ----- | ----------- |
+| `bash-linux` | Linux commands, scripting |
+| `powershell-windows` | Windows PowerShell |
+
+### Other
+
+| Skill | Description |
+| ----- | ----------- |
+| `clean-code` | Coding standards (Global) |
+| `behavioral-modes` | Agent personas |
+| `parallel-agents` | Multi-agent patterns |
+| `mcp-builder` | Model Context Protocol |
+| `documentation-templates` | Doc formats |
+| `i18n-localization` | Internationalization |
+| `performance-profiling` | Web Vitals, optimization |
+| `systematic-debugging` | Troubleshooting |
+
+---
+
+## 🔄 Workflows (14)
+
+Slash command procedures. Invoke with `/command`.
+
+| Command | Description |
+| ------- | ----------- |
+| `/think` | Structured brainstorming |
+| `/build` | Create new features/apps |
+| `/diagnose` | Debug issues systematically |
+| `/launch` | Deploy to production |
+| `/chronicle` | Generate documentation |
+| `/boost` | Improve existing code |
+| `/autopilot` | Multi-agent coordination |
+| `/architect` | Task breakdown & planning |
+| `/stage` | Preview/staging server |
+| `/inspect` | Code review verification |
+| `/forge` | Create/package skills |
+| `/pulse` | Check project status |
+| `/validate` | Run tests |
+| `/studio` | Design with 50+ styles |
+
+---
+
+## 🎯 Skill Loading Protocol
+
+```plaintext
+User Request → Skill Description Match → Load SKILL.md
+                                            ↓
+                                    Read references/
+                                            ↓
+                                    Read scripts/
+```
+
+### Skill Structure
+
+```plaintext
+skill-name/
+├── SKILL.md           # (Required) Metadata & instructions
+├── scripts/           # (Optional) Python/Bash scripts
+├── references/        # (Optional) Templates, docs
+└── assets/            # (Optional) Images, logos
+```
+
+### Enhanced Skills (with scripts/references)
+
+| Skill | Files | Coverage |
+| ----- | ----- | -------- |
+| `typescript-expert` | 5 | Utility types, tsconfig, cheatsheet |
+| `ui-ux-pro-max` | 27 | 50 styles, 21 palettes, 50 fonts |
+| `app-builder` | 20 | Full-stack scaffolding |
+
+---
+
+## 📜 Scripts (2)
+
+Master validation scripts that orchestrate skill-level scripts.
+
+### Master Scripts
+
+| Script | Purpose | When to Use |
+| ------ | ------- | ----------- |
+| `checklist.py` | Priority-based validation (Core checks) | Development, pre-commit |
+| `verify_all.py` | Comprehensive verification (All checks) | Pre-deployment, releases |
+
+### Usage
+
+```bash
+# Quick validation during development
+python .agent/scripts/checklist.py .
+
+# Full verification before deployment
+python .agent/scripts/verify_all.py . --url http://localhost:3000
+```
+
+### What They Check
+
+**checklist.py** (Core checks):
+
+- Security (vulnerabilities, secrets)
+- Code Quality (lint, types)
+- Schema Validation
+- Test Suite
+- UX Audit
+- SEO Check
+
+**verify_all.py** (Full suite):
+
+- Everything in checklist.py PLUS:
+- Lighthouse (Core Web Vitals)
+- Playwright E2E
+- Bundle Analysis
+- Mobile Audit
+- i18n Check
+
+For details, see [scripts/README.md](scripts/README.md)
+
+---
+
+## 📊 Statistics
+
+| Metric | Value |
+| ------ | ----- |
+| **Total Agents** | 20 |
+| **Total Skills** | 48 |
+| **Total Workflows** | 14 |
+| **Total Scripts** | 4 (master) + 18 (skill-level) |
+| **Coverage** | ~95% web/mobile development |
+
+---
+
+## 🔗 Quick Reference
+
+| Need | Agent | Skills |
+| ---- | ----- | ------ |
+| Web App | `frontend-specialist` | react-patterns, nextjs-best-practices |
+| API | `backend-specialist` | api-patterns, nodejs-best-practices |
+| Mobile | `mobile-developer` | mobile-design |
+| Database | `database-architect` | database-design, prisma-expert |
+| Security | `security-auditor` | vulnerability-scanner |
+| Testing | `test-engineer` | testing-patterns, webapp-testing |
+| Debug | `debugger` | systematic-debugging |
+| Plan | `project-planner` | brainstorming, plan-writing |