@agentskillkit/agent-skills 1.0.1

package/.agent/skills/webapp-testing/scripts/playwright_runner.py

@@ -0,0 +1,173 @@
+#!/usr/bin/env python3
+"""
+Skill: webapp-testing
+Script: playwright_runner.py
+Purpose: Run basic Playwright browser tests
+Usage: python playwright_runner.py <url> [--screenshot]
+Output: JSON with page info, health status, and optional screenshot path
+Note: Requires playwright (pip install playwright && playwright install chromium)
+Screenshots: Saved to system temp directory (auto-cleaned by OS)
+"""
+import sys
+import json
+import os
+import tempfile
+from datetime import datetime
+
+# Fix Windows console encoding for Unicode output
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except AttributeError:
+    pass  # Python < 3.7
+
+try:
+    from playwright.sync_api import sync_playwright
+    PLAYWRIGHT_AVAILABLE = True
+except ImportError:
+    PLAYWRIGHT_AVAILABLE = False
+
+
+def run_basic_test(url: str, take_screenshot: bool = False) -> dict:
+    """Run basic browser test on URL."""
+    if not PLAYWRIGHT_AVAILABLE:
+        return {
+            "error": "Playwright not installed",
+            "fix": "pip install playwright && playwright install chromium"
+        }
+    
+    result = {
+        "url": url,
+        "timestamp": datetime.now().isoformat(),
+        "status": "pending"
+    }
+    
+    try:
+        with sync_playwright() as p:
+            browser = p.chromium.launch(headless=True)
+            context = browser.new_context(
+                viewport={"width": 1280, "height": 720},
+                user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+            )
+            page = context.new_page()
+            
+            # Navigate
+            response = page.goto(url, wait_until="networkidle", timeout=30000)
+            
+            # Basic info
+            result["page"] = {
+                "title": page.title(),
+                "url": page.url,
+                "status_code": response.status if response else None
+            }
+            
+            # Health checks
+            result["health"] = {
+                "loaded": response.ok if response else False,
+                "has_title": bool(page.title()),
+                "has_h1": page.locator("h1").count() > 0,
+                "has_links": page.locator("a").count() > 0,
+                "has_images": page.locator("img").count() > 0
+            }
+            
+            # Console errors
+            console_errors = []
+            page.on("console", lambda msg: console_errors.append(msg.text) if msg.type == "error" else None)
+            
+            # Performance metrics
+            result["performance"] = {
+                "dom_content_loaded": page.evaluate("window.performance.timing.domContentLoadedEventEnd - window.performance.timing.navigationStart"),
+                "load_complete": page.evaluate("window.performance.timing.loadEventEnd - window.performance.timing.navigationStart")
+            }
+            
+            # Screenshot - uses system temp directory (cross-platform, auto-cleaned)
+            if take_screenshot:
+                # Cross-platform: Windows=%TEMP%, Linux/macOS=/tmp
+                screenshot_dir = os.path.join(tempfile.gettempdir(), "maestro_screenshots")
+                os.makedirs(screenshot_dir, exist_ok=True)
+                screenshot_path = os.path.join(screenshot_dir, f"screenshot_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png")
+                page.screenshot(path=screenshot_path, full_page=True)
+                result["screenshot"] = screenshot_path
+                result["screenshot_note"] = "Saved to temp directory (auto-cleaned by OS)"
+            
+            # Element counts
+            result["elements"] = {
+                "links": page.locator("a").count(),
+                "buttons": page.locator("button").count(),
+                "inputs": page.locator("input").count(),
+                "images": page.locator("img").count(),
+                "forms": page.locator("form").count()
+            }
+            
+            browser.close()
+            
+            result["status"] = "success" if result["health"]["loaded"] else "failed"
+            result["summary"] = "[OK] Page loaded successfully" if result["status"] == "success" else "[X] Page failed to load"
+            
+    except Exception as e:
+        result["status"] = "error"
+        result["error"] = str(e)
+        result["summary"] = f"[X] Error: {str(e)[:100]}"
+    
+    return result
+
+
+def run_accessibility_check(url: str) -> dict:
+    """Run basic accessibility check."""
+    if not PLAYWRIGHT_AVAILABLE:
+        return {"error": "Playwright not installed"}
+    
+    result = {"url": url, "accessibility": {}}
+    
+    try:
+        with sync_playwright() as p:
+            browser = p.chromium.launch(headless=True)
+            page = browser.new_page()
+            page.goto(url, wait_until="networkidle", timeout=30000)
+            
+            # Basic a11y checks
+            result["accessibility"] = {
+                "images_with_alt": page.locator("img[alt]").count(),
+                "images_without_alt": page.locator("img:not([alt])").count(),
+                "buttons_with_label": page.locator("button[aria-label], button:has-text('')").count(),
+                "links_with_text": page.locator("a:has-text('')").count(),
+                "form_labels": page.locator("label").count(),
+                "headings": {
+                    "h1": page.locator("h1").count(),
+                    "h2": page.locator("h2").count(),
+                    "h3": page.locator("h3").count()
+                }
+            }
+            
+            browser.close()
+            result["status"] = "success"
+            
+    except Exception as e:
+        result["status"] = "error"
+        result["error"] = str(e)
+    
+    return result
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print(json.dumps({
+            "error": "Usage: python playwright_runner.py <url> [--screenshot] [--a11y]",
+            "examples": [
+                "python playwright_runner.py https://example.com",
+                "python playwright_runner.py https://example.com --screenshot",
+                "python playwright_runner.py https://example.com --a11y"
+            ]
+        }, indent=2))
+        sys.exit(1)
+    
+    url = sys.argv[1]
+    take_screenshot = "--screenshot" in sys.argv
+    check_a11y = "--a11y" in sys.argv
+    
+    if check_a11y:
+        result = run_accessibility_check(url)
+    else:
+        result = run_basic_test(url, take_screenshot)
+    
+    print(json.dumps(result, indent=2))

package/.agent/workflows/architect.md

@@ -0,0 +1,200 @@
+---
+description: Blueprint generator. Task breakdown, tech stack selection, and PLAN.md creation (no code).
+---
+
+# /architect - Project Blueprint
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Create comprehensive project plans with task breakdown, architecture decisions, and agent assignments. **NO CODE - only planning artifacts.**
+
+---
+
+## 🔴 MANDATORY: 4-Phase Planning
+
+### Phase 1: Requirements Discovery
+Ask these if not provided:
+```
+1. What is the GOAL? (one sentence)
+2. Who are the USERS? (persona)
+3. What are MUST-HAVE features? (3-5 items)
+4. What are NICE-TO-HAVE? (optional)
+5. What is the TIMELINE? (deadline)
+6. What are CONSTRAINTS? (budget, tech, team)
+```
+
+### Phase 2: Architecture Decision
+| Decision | Options | Recommendation |
+|----------|---------|----------------|
+| Frontend | Next.js / Vite / SPA | [Choice + Why] |
+| Backend | Hono / Express / FastAPI | [Choice + Why] |
+| Database | PostgreSQL / MongoDB / Supabase | [Choice + Why] |
+| Auth | Clerk / NextAuth / Custom | [Choice + Why] |
+| Hosting | Vercel / Railway / AWS | [Choice + Why] |
+
+### Phase 3: Task Breakdown
+```
+Level 1: Epics (major features)
+Level 2: Stories (user-facing items)
+Level 3: Tasks (technical work)
+Level 4: Subtasks (atomic units)
+```
+
+### Phase 4: Agent Assignment
+| Task | Agent | Dependency | Estimate |
+|------|-------|------------|----------|
+| Schema design | database-architect | None | 30m |
+| API routes | backend-specialist | Schema | 2h |
+| UI components | frontend-specialist | API | 3h |
+| Tests | test-engineer | All | 1h |
+
+---
+
+## Output: PLAN.md
+
+Generated file: `docs/PLAN-{slug}.md`
+
+```markdown
+# Project Plan: [Name]
+
+## Overview
+| Aspect | Value |
+|--------|-------|
+| Goal | [One sentence] |
+| Timeline | [X days/weeks] |
+| Complexity | Low/Medium/High |
+| Team | [Agents involved] |
+
+## Stack Decision
+
+| Layer | Choice | Rationale |
+|-------|--------|-----------|
+| Frontend | Next.js 15 | SSR, Vercel integration |
+| Styling | Tailwind + shadcn/ui | Rapid development |
+| Backend | Hono on Edge | Type-safe, fast |
+| Database | PostgreSQL (Supabase) | Free tier, realtime |
+| Auth | Clerk | Social login, fast setup |
+
+## Architecture
+
+```mermaid
+graph TD
+    A[Client] --> B[Next.js App]
+    B --> C[API Routes]
+    C --> D[Database]
+    C --> E[External APIs]
+```
+
+## Task Breakdown
+
+### Epic 1: [Feature Name]
+- [ ] Story 1.1: [Description]
+  - [ ] Task 1.1.1: [Technical work]
+  - [ ] Task 1.1.2: [Technical work]
+- [ ] Story 1.2: [Description]
+
+### Epic 2: [Feature Name]
+- [ ] Story 2.1: [Description]
+
+## Agent Execution Plan
+
+| Phase | Agent | Task | Duration |
+|-------|-------|------|----------|
+| 1 | database-architect | Schema + migrations | 30m |
+| 2 | backend-specialist | API endpoints | 2h |
+| 3 | frontend-specialist | UI components | 3h |
+| 4 | test-engineer | E2E tests | 1h |
+
+## Verification Checklist
+
+- [ ] All features implemented
+- [ ] Tests passing
+- [ ] Security scan clean
+- [ ] Performance acceptable
+- [ ] Documentation complete
+
+## Next Steps
+
+After plan approval:
+1. Run `/build` to start implementation
+2. Or modify this plan as needed
+```
+
+---
+
+## Naming Convention
+
+| Request | Generated File |
+|---------|----------------|
+| `/architect e-commerce app` | `docs/PLAN-ecommerce-app.md` |
+| `/architect user dashboard` | `docs/PLAN-user-dashboard.md` |
+| `/architect mobile API` | `docs/PLAN-mobile-api.md` |
+
+Rules:
+- Lowercase
+- Hyphen-separated
+- Max 30 characters
+- No special characters
+
+---
+
+## Examples
+
+```
+/architect SaaS analytics dashboard
+/architect e-commerce with payments
+/architect mobile app backend
+/architect real-time chat system
+/architect portfolio website
+```
+
+---
+
+## Key Principles
+
+1. **No code** - plan only, build later
+2. **User approval** - get sign-off before building
+3. **Realistic estimates** - include buffer time
+4. **Clear dependencies** - order tasks correctly
+5. **Verifiable** - each task has completion criteria
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/think"] --> B["/architect"]
+    B --> C["/build"]
+    C --> D["/validate"]
+    style B fill:#10b981
+```
+
+### After Planning
+
+```markdown
+✅ Plan created: docs/PLAN-{slug}.md
+
+Next steps:
+- Review the architecture decisions
+- Adjust task breakdown if needed
+- Run `/build` to start implementation
+```
+
+| After /architect | Run | Purpose |
+|------------------|-----|---------|
+| Plan approved | `/build` | Start implementation |
+| Need changes | Edit PLAN.md | Modify plan |
+| Complex project | `/autopilot` | Full orchestration |
+
+**Handoff to /build:**
+```markdown
+Plan approved. Run /build with context:
+- PLAN: docs/PLAN-{slug}.md
+- Stack: [selected stack]
+- Priority: [first epic]
+```

package/.agent/workflows/autopilot.md

@@ -0,0 +1,254 @@
+---
+description: Autonomous multi-agent coordination. 3+ specialists working in parallel with verification.
+---
+
+# /autopilot - Multi-Agent Command Center
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Coordinate 3+ specialist agents for complex tasks. **Like having a senior engineering team working in parallel with automated verification.**
+
+---
+
+## 🔴 CRITICAL: Minimum 3 Agents
+
+> **AUTOPILOT = MINIMUM 3 DIFFERENT SPECIALISTS**
+> 
+> If fewer than 3 agents → NOT autopilot, just delegation.
+> Single agent work → Use direct command instead.
+
+---
+
+## Pre-Flight: Mode Check
+
+| Current Mode | Task Type | Action |
+|--------------|-----------|--------|
+| **plan** | Any | ✅ Proceed with planning-first approach |
+| **edit** | Simple | ✅ Proceed directly |
+| **edit** | Complex | ⚠️ Ask: "This requires planning. Switch to plan mode?" |
+| **ask** | Any | ⚠️ Ask: "Ready to orchestrate. Switch to edit or plan mode?" |
+
+---
+
+## Domain Analysis Checklist
+
+Before selecting agents, identify ALL domains:
+
+```
+□ Security     → security-auditor
+□ Backend/API  → backend-specialist
+□ Frontend/UI  → frontend-specialist
+□ Database     → database-architect
+□ Testing      → test-engineer
+□ DevOps       → devops-engineer
+□ Mobile       → mobile-developer
+□ Performance  → performance-optimizer
+□ SEO          → seo-specialist
+□ Planning     → project-planner
+□ Debug        → debugger
+```
+
+---
+
+## Agent Selection Matrix
+
+| Task Type | Required Agents | Verification |
+|-----------|-----------------|--------------| 
+| **Web App** | frontend, backend, test | lint + security |
+| **API** | backend, security, test | security scan |
+| **UI/Design** | frontend, seo, performance | lighthouse |
+| **Database** | database, backend, security | schema check |
+| **Full Stack** | planner, frontend, backend, devops | all |
+| **Debug** | debugger, explorer, test | reproduction test |
+| **Security** | security-auditor, penetration-tester, devops | all scans |
+
+---
+
+## Available Agents (17 total)
+
+| Agent | Domain | Use When |
+|-------|--------|----------|
+| `project-planner` | Planning | Task breakdown, PLAN.md |
+| `explorer-agent` | Discovery | Codebase mapping |
+| `frontend-specialist` | UI/UX | React, Vue, CSS, HTML |
+| `backend-specialist` | Server | API, Node.js, Python |
+| `database-architect` | Data | SQL, NoSQL, Schema |
+| `security-auditor` | Security | Vulnerabilities, Auth |
+| `test-engineer` | Testing | Unit, E2E, Coverage |
+| `devops-engineer` | Ops | CI/CD, Docker, Deploy |
+| `mobile-developer` | Mobile | React Native, Flutter |
+| `performance-optimizer` | Speed | Lighthouse, Profiling |
+| `seo-specialist` | SEO | Meta, Schema, Rankings |
+| `documentation-writer` | Docs | README, API docs |
+| `debugger` | Debug | Error analysis |
+
+---
+
+## Execution Phases
+
+### Phase 1: Architecture (Sequential)
+
+| Step | Agent | Action |
+|------|-------|--------|
+| 1 | `project-planner` | Create PLAN.md |
+| 2 | `explorer-agent` | Codebase discovery (optional) |
+
+> 🔴 **NO OTHER AGENTS during planning!**
+
+**⛔ CHECKPOINT: User approval required before Phase 2**
+
+### Phase 2: Parallel Execution
+
+```mermaid
+graph TD
+    A[Approved Plan] --> B[Foundation]
+    B --> B1[database-architect]
+    B --> B2[security-auditor]
+    B1 --> C[Core]
+    B2 --> C
+    C --> C1[backend-specialist]
+    C --> C2[frontend-specialist]
+    C1 --> D[Polish]
+    C2 --> D
+    D --> D1[test-engineer]
+    D --> D2[devops-engineer]
+    D1 --> E[Verification]
+    D2 --> E
+```
+
+| Parallel Group | Agents |
+|----------------|--------|
+| Foundation | database-architect, security-auditor |
+| Core | backend-specialist, frontend-specialist |
+| Polish | test-engineer, devops-engineer |
+
+### Phase 3: Verification
+// turbo
+```bash
+python .agent/skills/vulnerability-scanner/scripts/security_scan.py .
+python .agent/skills/lint-and-validate/scripts/lint_runner.py .
+```
+
+---
+
+## Context Passing (MANDATORY)
+
+When invoking ANY sub-agent, include:
+
+```markdown
+**CONTEXT:**
+- Original Request: [Full user request]
+- Decisions Made: [All user answers]
+- Previous Agent Work: [Summary of completed work]
+- Current Plan: [Link to PLAN.md if exists]
+
+**TASK:** [Specific task for this agent]
+```
+
+> ⚠️ **VIOLATION:** Invoking agent without context = wrong assumptions!
+
+---
+
+## Output Format
+
+```markdown
+## 🎼 Autopilot Report
+
+### Mission
+[Original task summary]
+
+### Agent Coordination
+
+| Agent | Task | Duration | Status |
+|-------|------|----------|--------|
+| `project-planner` | Task breakdown | 2m | ✅ Complete |
+| `database-architect` | Schema design | 3m | ✅ Complete |
+| `backend-specialist` | API routes | 5m | ✅ Complete |
+| `frontend-specialist` | UI components | 7m | ✅ Complete |
+| `test-engineer` | E2E tests | 4m | ✅ Complete |
+
+### Verification Results
+
+| Script | Result |
+|--------|--------|
+| security_scan.py | ✅ No vulnerabilities |
+| lint_runner.py | ✅ No errors |
+| Tests | ✅ 28/28 passed |
+
+### Deliverables
+
+- [x] PLAN.md created
+- [x] Database schema
+- [x] API endpoints (12 routes)
+- [x] UI components (8 pages)
+- [x] Tests (28 cases)
+- [x] Preview running
+
+### Summary
+Built complete [app type] with [X] files across [Y] agents.
+Total execution time: [Z] minutes.
+
+---
+
+### Preview
+🌐 http://localhost:3000
+
+### Next Steps
+- [ ] Review the code
+- [ ] Test user flows
+- [ ] `/launch` when ready
+```
+
+---
+
+## Examples
+
+```
+/autopilot build a SaaS dashboard with analytics
+/autopilot create REST API with auth and rate limiting
+/autopilot refactor monolith to microservices
+/autopilot add real-time features to existing app
+/autopilot security audit + fix + test
+```
+
+---
+
+## Exit Gate
+
+Before completing, verify:
+
+- [ ] **Agent Count:** invoked_agents >= 3
+- [ ] **Scripts Executed:** At least security_scan.py ran
+- [ ] **Report Generated:** All agents listed with status
+- [ ] **Deliverables:** All planned items completed
+
+> If any check fails → DO NOT mark complete. Invoke more agents or run scripts.
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/autopilot"] --> B["/architect"]
+    A --> C["/build"]
+    A --> D["/validate"]
+    A --> E["/launch"]
+    style A fill:#3b82f6
+```
+
+| /autopilot integrates | Purpose |
+|-----------------------|---------|
+| `/architect` | Planning phase |
+| `/build` | Building phase |
+| `/validate` | Testing phase |
+| `/launch` | Deployment phase |
+
+**Handoff:**
+```markdown
+Autopilot complete. All agents finished. Preview running.
+```