thachvd-kit 1.0.28 → 1.0.30

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

@@ -1,173 +0,0 @@
-#!/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/skills/writing-skills/SKILL.md

@@ -1,170 +0,0 @@
----
-name: writing-skills
-description: Use when creating a new skill or improving an existing one — follows best practices for SKILL.md structure, Claude Search Optimization, token efficiency, anti-rationalization tables, and skill testing methodology
-allowed-tools: Read, Write, Edit
----
-
-# Writing Skills
-
-## What is a Skill?
-
-A skill is a reusable instruction set that activates when an AI detects a relevant context. It lives in a folder with a `SKILL.md` file and works across Codex, Antigravity, Claude, and Cursor.
-
-## Skill Types
-
-| Type | Purpose | Example | Anti-Rationalization Required? |
-|------|---------|---------|----|
-| **Technique** | How-to guide | `tdd-workflow` | Optional |
-| **Pattern** | Mental model | `clean-code` | Optional |
-| **Reference** | Documentation | `api-patterns` | No |
-| **Discipline** | Rules/enforcement | `verification-before-completion` | **Mandatory** |
-
-## Directory Structure
-
-```
-skill-name/
-├── SKILL.md          # Required: metadata + instructions
-├── scripts/          # Optional: runnable scripts
-└── references/       # Optional: templates, docs
-```
-
-## SKILL.md Structure
-
-```markdown
----
-name: skill-name
-description: [Trigger description — when to use this skill]
-allowed-tools: [Bash, Read, Edit, Write, ...]
----
-
-# Skill Title
-
-## Overview
-Brief summary + core principle
-
-## When to Use
-- Specific trigger scenarios
-
-## [Main Content]
-...
-
-## Anti-Rationalization  ← REQUIRED for Discipline/Technique skills
-| Excuse | Correct Response |
-|--------|-----------------|
-| "Just this once" | No exceptions. Apply the rule. |
-
-## Exit Criteria  ← REQUIRED for Technique/Discipline skills
-- [ ] Specific, verifiable condition 1
-- [ ] Specific, verifiable condition 2
-```
-
-## Claude Search Optimization (CSO)
-
-The `description` field is how the AI decides whether to load your skill. Make it trigger correctly:
-
-### 1. Rich Description
-
-```yaml
-# ❌ Vague
-description: For code review
-
-# ✅ Specific with triggers
-description: Use when completing tasks, implementing major features, or before merging — pre-review checklist, evidence-before-claims workflow
-```
-
-### 2. Keyword Coverage
-
-Include synonyms, trigger phrases, and common user requests in description.
-
-### 3. Token Efficiency (Critical)
-
-- Use tables instead of prose for comparisons
-- Use code blocks for commands
-- Use flowcharts/diagrams for processes
-- Avoid narrative explanations — use structured data
-
-### 4. Cross-Referencing
-
-Use `Pairs with:` and `Integration:` sections to link related skills.
-
-## Anti-Rationalization Tables (Key Concept)
-
-The most powerful feature of a discipline skill. A table that blocks the AI's most common excuses for skipping a rule.
-
-### Why They Matter
-
-AI agents (like humans) tend to rationalize shortcuts under pressure. An Anti-Rationalization table names each excuse explicitly and provides the correct response, making it impossible to skip without consciously overriding the rule.
-
-### Format
-
-```markdown
-## Anti-Rationalization
-
-| Excuse | Reality / Correct Response |
-|--------|---------------------------|
-| "It's a small change" | Size doesn't reduce the need. Apply the rule. |
-| "I'm confident it works" | Confidence ≠ evidence. Run verification. |
-| "Just this once" | No exceptions — "just this once" is how standards die. |
-| "The last run passed" | Stale results. Run fresh verification now. |
-```
-
-### What Makes a Good Entry
-
-- **Excuse column**: Real phrases AI uses to justify skipping. Be specific.
-- **Reality column**: The direct counter. Short, imperative, no hedging.
-- Cover at least 4–6 common excuses for discipline skills.
-
-## Exit Criteria
-
-Every Technique or Discipline skill must end with a verifiable checklist the AI can check off before declaring the task done.
-
-```markdown
-## Exit Criteria
-
-Before claiming this task is complete:
-- [ ] [Verifiable condition 1]
-- [ ] [Verifiable condition 2]
-- [ ] [Verifiable condition 3]
-```
-
-**Rules for Exit Criteria:**
-- Each item must be binary (done or not done) — no vague "looks good" items
-- Must be something that can be checked programmatically or by inspection
-- Failing any item = task is NOT complete
-
-## Anti-Patterns to Avoid
-
-| ❌ Anti-Pattern | ✅ Fix |
-|----------------|-------|
-| Narrative prose everywhere | Tables, bullet lists, code blocks |
-| Discipline skill with no Anti-Rationalization | Add the table — it's mandatory |
-| Technique skill with no Exit Criteria | Add verifiable checklist |
-| Vague description | Specific triggers and use cases |
-| Generic labels ("Step 1", "Step 2") | Descriptive labels ("Verify baseline", "Run tests") |
-| Code examples in flowchart labels | Flowcharts for flow, code blocks for code |
-
-## Skill Creation Checklist
-
-- [ ] Description field triggers correctly (test: "would AI load this for X?")
-- [ ] Core principle stated in Overview
-- [ ] Content uses tables/code blocks, not prose paragraphs
-- [ ] Token-efficient (no redundant explanations)
-- [ ] **Anti-Rationalization section included** (Discipline/Technique skills — mandatory)
-- [ ] **Exit Criteria section included** (Discipline/Technique skills — mandatory)
-- [ ] Integration section lists related skills
-- [ ] Tested: create a scenario where this skill should fire, verify it does
-
-## Testing Skills
-
-For **discipline skills** (rules): Create scenario where rule should fire, verify AI follows it AND rejects the rationalizations in the Anti-Rationalization table.
-For **technique skills** (how-to): Apply skill to a real task, verify output quality and that Exit Criteria are met.
-For **reference skills** (docs): Query for specific info, verify correct answer.
-
-## The Bottom Line
-
-A skill is good when:
-1. It fires when it should (good description/CSO)
-2. It improves output quality noticeably
-3. It's token-efficient (doesn't waste context)
-4. It has no ambiguous loopholes (Anti-Rationalization table closes them)
-5. It's verifiable (Exit Criteria defines "done")

package/workflows/brainstorm.md

@@ -1,113 +0,0 @@
----
-description: Structured brainstorming for projects and features. Explores multiple options before implementation.
----
-
-# /brainstorm - Structured Idea Exploration
-
-$ARGUMENTS
-
----
-
-## Purpose
-
-This command activates BRAINSTORM mode for structured idea exploration. Use when you need to explore options before committing to an implementation.
-
----
-
-## Behavior
-
-When `/brainstorm` is triggered:
-
-1. **Understand the goal**
-   - What problem are we solving?
-   - Who is the user?
-   - What constraints exist?
-
-2. **Generate options**
-   - Provide at least 3 different approaches
-   - Each with pros and cons
-   - Consider unconventional solutions
-
-3. **Compare and recommend**
-   - Summarize tradeoffs
-   - Give a recommendation with reasoning
-
----
-
-## Output Format
-
-```markdown
-## 🧠 Brainstorm: [Topic]
-
-### Context
-[Brief problem statement]
-
----
-
-### Option A: [Name]
-[Description]
-
-✅ **Pros:**
-- [benefit 1]
-- [benefit 2]
-
-❌ **Cons:**
-- [drawback 1]
-
-📊 **Effort:** Low | Medium | High
-
----
-
-### Option B: [Name]
-[Description]
-
-✅ **Pros:**
-- [benefit 1]
-
-❌ **Cons:**
-- [drawback 1]
-- [drawback 2]
-
-📊 **Effort:** Low | Medium | High
-
----
-
-### Option C: [Name]
-[Description]
-
-✅ **Pros:**
-- [benefit 1]
-
-❌ **Cons:**
-- [drawback 1]
-
-📊 **Effort:** Low | Medium | High
-
----
-
-## 💡 Recommendation
-
-**Option [X]** because [reasoning].
-
-What direction would you like to explore?
-```
-
----
-
-## Examples
-
-```
-/brainstorm authentication system
-/brainstorm state management for complex form
-/brainstorm database schema for social app
-/brainstorm caching strategy
-```
-
----
-
-## Key Principles
-
-- **No code** - this is about ideas, not implementation
-- **Visual when helpful** - use diagrams for architecture
-- **Honest tradeoffs** - don't hide complexity
-- **Defer to user** - present options, let them decide

package/workflows/create.md

@@ -1,59 +0,0 @@
----
-description: Create new application command. Triggers App Builder skill and starts interactive dialogue with user.
----
-
-# /create - Create Application
-
-$ARGUMENTS
-
----
-
-## Task
-
-This command starts a new application creation process.
-
-### Steps:
-
-1. **Request Analysis**
-   - Understand what the user wants
-   - If information is missing, use `conversation-manager` skill to ask
-
-2. **Project Planning**
-   - Use `project-planner` agent for task breakdown
-   - Determine tech stack
-   - Plan file structure
-   - Create plan file and proceed to building
-
-3. **Application Building (After Approval)**
-   - Orchestrate with `app-builder` skill
-   - Coordinate expert agents:
-     - `database-architect` → Schema
-     - `backend-specialist` → API
-     - `frontend-specialist` → UI
-
-4. **Preview**
-   - Start with `auto_preview.py` when complete
-   - Present URL to user
-
----
-
-## Usage Examples
-
-```
-/create blog site
-/create e-commerce app with product listing and cart
-/create todo app
-/create Instagram clone
-/create crm system with customer management
-```
-
----
-
-## Before Starting
-
-If request is unclear, ask these questions:
-- What type of application?
-- What are the basic features?
-- Who will use it?
-
-Use defaults, add details later.

package/workflows/debug.md

@@ -1,103 +0,0 @@
----
-description: Debugging command. Activates DEBUG mode for systematic problem investigation.
----
-
-# /debug - Systematic Problem Investigation
-
-$ARGUMENTS
-
----
-
-## Purpose
-
-This command activates DEBUG mode for systematic investigation of issues, errors, or unexpected behavior.
-
----
-
-## Behavior
-
-When `/debug` is triggered:
-
-1. **Gather information**
-   - Error message
-   - Reproduction steps
-   - Expected vs actual behavior
-   - Recent changes
-
-2. **Form hypotheses**
-   - List possible causes
-   - Order by likelihood
-
-3. **Investigate systematically**
-   - Test each hypothesis
-   - Check logs, data flow
-   - Use elimination method
-
-4. **Fix and prevent**
-   - Apply fix
-   - Explain root cause
-   - Add prevention measures
-
----
-
-## Output Format
-
-```markdown
-## 🔍 Debug: [Issue]
-
-### 1. Symptom
-[What's happening]
-
-### 2. Information Gathered
-- Error: `[error message]`
-- File: `[filepath]`
-- Line: [line number]
-
-### 3. Hypotheses
-1. ❓ [Most likely cause]
-2. ❓ [Second possibility]
-3. ❓ [Less likely cause]
-
-### 4. Investigation
-
-**Testing hypothesis 1:**
-[What I checked] → [Result]
-
-**Testing hypothesis 2:**
-[What I checked] → [Result]
-
-### 5. Root Cause
-🎯 **[Explanation of why this happened]**
-
-### 6. Fix
-```[language]
-// Before
-[broken code]
-
-// After
-[fixed code]
-```
-
-### 7. Prevention
-🛡️ [How to prevent this in the future]
-```
-
----
-
-## Examples
-
-```
-/debug login not working
-/debug API returns 500
-/debug form doesn't submit
-/debug data not saving
-```
-
----
-
-## Key Principles
-
-- **Ask before assuming** - get full error context
-- **Test hypotheses** - don't guess randomly
-- **Explain why** - not just what to fix
-- **Prevent recurrence** - add tests, validation