@agentskillkit/agent-skills 1.0.1 → 3.2.1

package/.agent/skills/webapp-testing/SKILL.md

@@ -1,187 +0,0 @@
----
-name: webapp-testing
-description: Web application testing principles. E2E, Playwright, deep audit strategies.
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash
----
-
-# Web App Testing
-
-> Discover and test everything. Leave no route untested.
-
-## 🔧 Runtime Scripts
-
-**Execute these for automated browser testing:**
-
-| Script | Purpose | Usage |
-|--------|---------|-------|
-| `scripts/playwright_runner.py` | Basic browser test | `python scripts/playwright_runner.py https://example.com` |
-| | With screenshot | `python scripts/playwright_runner.py <url> --screenshot` |
-| | Accessibility check | `python scripts/playwright_runner.py <url> --a11y` |
-
-**Requires:** `pip install playwright && playwright install chromium`
-
----
-
-## 1. Deep Audit Approach
-
-### Discovery First
-
-| Target | How to Find |
-|--------|-------------|
-| Routes | Scan app/, pages/, router files |
-| API endpoints | Grep for HTTP methods |
-| Components | Find component directories |
-| Features | Read documentation |
-
-### Systematic Testing
-
-1. **Map** - List all routes/APIs
-2. **Scan** - Verify they respond
-3. **Test** - Cover critical paths
-
----
-
-## 2. Testing Pyramid for Web
-
-```
-        /\          E2E (Few)
-       /  \         Critical user flows
-      /----\
-     /      \       Integration (Some)
-    /--------\      API, data flow
-   /          \
-  /------------\    Component (Many)
-                    Individual UI pieces
-```
-
----
-
-## 3. E2E Test Principles
-
-### What to Test
-
-| Priority | Tests |
-|----------|-------|
-| 1 | Happy path user flows |
-| 2 | Authentication flows |
-| 3 | Critical business actions |
-| 4 | Error handling |
-
-### E2E Best Practices
-
-| Practice | Why |
-|----------|-----|
-| Use data-testid | Stable selectors |
-| Wait for elements | Avoid flaky tests |
-| Clean state | Independent tests |
-| Avoid implementation details | Test user behavior |
-
----
-
-## 4. Playwright Principles
-
-### Core Concepts
-
-| Concept | Use |
-|---------|-----|
-| Page Object Model | Encapsulate page logic |
-| Fixtures | Reusable test setup |
-| Assertions | Built-in auto-wait |
-| Trace Viewer | Debug failures |
-
-### Configuration
-
-| Setting | Recommendation |
-|---------|----------------|
-| Retries | 2 on CI |
-| Trace | on-first-retry |
-| Screenshots | on-failure |
-| Video | retain-on-failure |
-
----
-
-## 5. Visual Testing
-
-### When to Use
-
-| Scenario | Value |
-|----------|-------|
-| Design system | High |
-| Marketing pages | High |
-| Component library | Medium |
-| Dynamic content | Lower |
-
-### Strategy
-
-- Baseline screenshots
-- Compare on changes
-- Review visual diffs
-- Update intentional changes
-
----
-
-## 6. API Testing Principles
-
-### Coverage Areas
-
-| Area | Tests |
-|------|-------|
-| Status codes | 200, 400, 404, 500 |
-| Response shape | Matches schema |
-| Error messages | User-friendly |
-| Edge cases | Empty, large, special chars |
-
----
-
-## 7. Test Organization
-
-### File Structure
-
-```
-tests/
-├── e2e/           # Full user flows
-├── integration/   # API, data
-├── component/     # UI units
-└── fixtures/      # Shared data
-```
-
-### Naming Convention
-
-| Pattern | Example |
-|---------|---------|
-| Feature-based | `login.spec.ts` |
-| Descriptive | `user-can-checkout.spec.ts` |
-
----
-
-## 8. CI Integration
-
-### Pipeline Steps
-
-1. Install dependencies
-2. Install browsers
-3. Run tests
-4. Upload artifacts (traces, screenshots)
-
-### Parallelization
-
-| Strategy | Use |
-|----------|-----|
-| Per file | Playwright default |
-| Sharding | Large suites |
-| Workers | Multiple browsers |
-
----
-
-## 9. Anti-Patterns
-
-| ❌ Don't | ✅ Do |
-|----------|-------|
-| Test implementation | Test behavior |
-| Hardcode waits | Use auto-wait |
-| Skip cleanup | Isolate tests |
-| Ignore flaky tests | Fix root cause |
-
----
-
-> **Remember:** E2E tests are expensive. Use them for critical paths only.

package/.agent/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/.editorconfig

@@ -1,21 +0,0 @@
-# EditorConfig helps maintain consistent coding styles
-# https://editorconfig.org
-
-root = true
-
-[*]
-indent_style = space
-indent_size = 4
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.{json,yml,yaml}]
-indent_size = 2
-
-[*.md]
-trim_trailing_whitespace = false
-
-[Makefile]
-indent_style = tab

package/.github/workflows/release.yml

@@ -1,39 +0,0 @@
-name: Release and Publish
-
-on:
-  push:
-    tags:
-      - 'v*'
-
-permissions:
-  contents: write
-  id-token: write
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          generate_release_notes: true
-          draft: false
-          prerelease: ${{ contains(github.ref, 'alpha') || contains(github.ref, 'beta') || contains(github.ref, 'rc') }}
-
-  # publish:
-  #   runs-on: ubuntu-latest
-  #   needs: release
-  #   environment: Production
-  #   steps:
-  #     - uses: actions/checkout@v4
-      
-  #     - uses: actions/setup-node@v4
-  #       with:
-  #         node-version: '20.x'
-      
-  #     - run: npm ci
-      
-  #     - name: Publish to NPM
-  #       run: npm publish --provenance --access public

package/docs/PLAN-consolidation-final.md

@@ -1,14 +0,0 @@
-# Final Consolidation Plan
-
-## 1. Goal
-Complete the integration by updating the skill registry and ensuring all new skills are discoverable.
-
-## 2. Steps
-1. Run `generate-registry.js` to index `git-conventions` and `code-reviewer`.
-2. Inspect `registry.json` to confirm presence.
-3. Clean up the `agent-skills` and `.agent` (root) folders if user agrees (will ask via notify_user).
-
-## 3. Deliverables
-- Fully populated `agentskillskit/.agent/skills`.
-- Updated Registry.
-- Zero legacy folders.

package/docs/PLAN-integration.md

@@ -1,28 +0,0 @@
-# Skill Integration Plan
-
-## 1. Goal
-Integrate remaining valuable skills from CoinPika legacy folders into the new `agentskillskit` architecture.
-
-## 2. Skills to Migrate
-
-### A. `git-conventions` (from `coinpika-commit-formatter`)
-- **Structure**:
-  - `SKILL.md` -> Standardize
-  - `scripts/commit_msg.py` -> Move to `scripts/` (python) or rewrite in Node (optional, but Python is fine if user has it).
-  - **Purpose**: Enforce Conventional Commits.
-
-### B. `code-reviewer` (from `coinpika-pr-reviewer`)
-- **Structure**:
-  - `SKILL.md` -> Standardize
-  - `scripts/review.js` -> Move to `scripts/`.
-  - **Purpose**: Automated PR quality checks.
-
-## 3. Execution Steps
-1. Create `.agent/skills/git-conventions` and `.agent/skills/code-reviewer`.
-2. Copy source files.
-3. Refactor `SKILL.md` to remove "CoinPika" branding and match new standard.
-4. Ensure scripts are executable via `npx my-agent-skills` or directly.
-
-## 4. Verification
-- Verify `git-conventions` by simulating a bad commit message.
-- Verify `code-reviewer` by running it on the current codebase.

package/docs/PLAN-rebrand-agent-skills-kit.md

@@ -1,104 +0,0 @@
-# Plan: Rebrand to Agent Skills Kit (Private License)
-
-> **Goal:** Rename entire project to "Agent Skills Kit", update domain to `agentskillskit.com`, and enforce a strict proprietary license.
-
-## 📋 Overview
-
-The project is undergoing a major rebranding and licensing shift. All public branding (Antigravity Kit, My Agent Skills) will be replaced with **Agent Skills Kit**. The open-source MIT license will be replaced with a **Proprietary Commercial License** to position the product as a premium "Big Tech" solution.
-
-## 🏗️ Project Type
-
-**TYPE: CLI / BACKEND Tooling**
-- Primary Agent: `backend-specialist` (handling CLI logic and file updates)
-- Secondary: `product-owner` (branding enforcement)
-
-## ✅ Success Criteria
-
-1.  **Project Name**: All references to "Antigravity Kit" / "My Agent Skills" replaced with "**Agent Skills Kit**".
-2.  **Website**: All URLs point to `agentskillskit.com`.
-3.  **License**: `LICENSE.md` contains strict proprietary terms (No redistribution, commercial use only).
-4.  **Verification**: CLI output displays new branding.
-
-## 🛠️ Tech Stack
-
--   **Runtime**: Node.js (CLI), Python (Scripts)
--   **Package Manager**: npm/pnpm
--   **License Model**: Proprietary (Closed Source)
-
-## 📂 File Structure (Impacted Files)
-
-```plaintext
-agentskillskit/
-├── LICENSE              <-- [REPLACE] With Proprietary License
-├── package.json         <-- [UPDATE] Name, description, URL, license
-├── README.md            <-- [UPDATE] Branding, badges, links
-├── .agent/
-│   ├── ARCHITECTURE.md  <-- [UPDATE] Project name
-│   └── GEMINI.md        <-- [UPDATE] Project name
-└── packages/cli/        <-- [UPDATE] Internal strings
-```
-
-## 📝 Task Breakdown
-
-### Phase 1: Foundation (License & Meta)
-
-- [ ] **Create Proprietary License** `task_id: license_update`
-    -   **Agent**: `product-owner`
-    -   **Input**: "Big Tech" Private License text
-    -   **Output**: updated `LICENSE` file
-    -   **Verify**: Read file content matches proprietary terms.
-
-- [ ] **Update Package Metadata** `task_id: pkg_json_update`
-    -   **Agent**: `backend-specialist`
-    -   **File**: `package.json`, `packages/cli/package.json`
-    -   **Action**: Change name to `agent-skills-kit`, license to `UNLICENSED` (or private), homepage to `agentskillskit.com`.
-    -   **Verify**: `npm install` warns about private license (expected).
-
-### Phase 2: Branding Find & Replace
-
-- [ ] **Update Documentation Branding** `task_id: docs_rebrand`
-    -   **Agent**: `documentation-writer`
-    -   **Files**: `README.md`, `ARCHITECTURE.md`, `GEMINI.md`
-    -   **Action**: Replace "Antigravity Kit", "My Agent Skills" -> "Agent Skills Kit".
-    -   **Verify**: `grep` returns 0 matches for old names.
-
-- [ ] **Update Code Strings** `task_id: code_rebrand`
-    -   **Agent**: `backend-specialist`
-    -   **Files**: `packages/cli/bin/*.js`, `packages/cli/lib/*.js`
-    -   **Action**: Update CLI welcome messages and error/help text.
-    -   **Verify**: Run `ag-smart --help` shows "Agent Skills Kit".
-
-### Phase 3: Domain Update
-
-- [ ] **Update URLs** `task_id: url_update`
-    -   **Agent**: `backend-specialist`
-    -   **Action**: Replace `antigravity-kit.com` / `agentskillskit.com` (if any) -> `https://agentskillskit.com`.
-    -   **Verify**: Check links in `README.md` work (or point to new domain).
-
-## 🧪 Phase X: Verification
-
-### 1. Branding Check
-```bash
-# Must return NO results
-grep -r "Antigravity" .
-grep -r "My Agent Skills" .
-```
-
-### 2. License Check
-```bash
-# Must show Proprietary terms
-cat LICENSE
-# Must NOT show MIT
-```
-
-### 3. CLI Check
-```bash
-# Run the CLI
-node packages/cli/bin/ag-smart.js --version
-# Expect: "Agent Skills Kit v..."
-```
-
-## ✅ PHASE X COMPLETE
-- [ ] License is Private
-- [ ] Name is Agent Skills Kit
-- [ ] Domain is agentskillskit.com

package/docs/PLAN-refactor.md

@@ -1,48 +0,0 @@
-# Refactoring Plan: My Agent Skills (Standardization & Maintainability)
-
-## 1. Goal
-Biến `agentskillskit` từ một tập hợp "lai tạp" (Antigravity + Vercel + CoinPika) thành một hệ thống **Nhất quán (Consistent)**, **Module hóa (Modular)** và **Dễ mở rộng (Extensible)**.
-
-## 2. Current State (The Problem)
-- **Inconsistent Structure**:
-  - `governance`: Dùng `constitution/`, `doctrines/`.
-  - `frontend` (new): Dùng `rules/*.md` (Styles Vercel).
-  - `frontend-design` (old): Dùng single `SKILL.md`.
-  - `api-patterns`: Dùng python scripts.
-- **Scattered Logic**: Script nằm rải rác (`.agent/scripts`, skill scripts).
-- **Hard to Upgrade**: Nếu muốn thêm rule mới cho `frontend-design`, phải sửa file markdown lớn thay vì thêm 1 file nhỏ.
-
-## 3. The New Standard Structure (Proposal)
-Mỗi skill PHẢI tuân thủ cấu trúc chuẩn sau:
-
-```
-skill-name/
-├── SKILL.md            # Entry point (Router & Metadata)
-├── rules/              # [OPTIONAL] Atomic knowledge (Markdown)
-│   ├── rule-001.md
-│   └── rule-002.md
-├── scripts/            # [OPTIONAL] Executable logic (Node/Python)
-│   ├── audit.js
-│   └── fix.js
-└── tests/              # [OPTIONAL] Validation for the skill itself
-```
-
-## 4. Execution Phases
-
-### Phase 1: Core System Refactor (CLI & Shared)
-- **Action**: Move `ag-smart.js` and `.agent/scripts` into a proper `packages/cli` structure (giống Vercel repo gốc) hoặc folder `core/`.
-- **Benfit**: Tách biệt "Engine" (CLI) khỏi "Data" (Skills).
-
-### Phase 2: Unification (Skill Standardization)
-- **Action**: Convert các skill cũ (dạng Single File MD) sang dạng **Atomic Rules**.
-  - Ví dụ: Xé nhỏ `frontend-design/SKILL.md` thành `frontend-design/rules/colors.md`, `frontend-design/rules/typography.md`.
-- **Action**: Xóa bỏ các file rác hoặc legacy artifacts (ví dụ template code thừa).
-
-### Phase 3: Metadata & Indexing
-- **Action**: Tạo `registry.json` hoặc cơ chế auto-discovery để CLI biết có bao nhiêu skill và rule đang tồn tại mà không cần hardcode.
-
-## 5. Next Step
-Chúng ta sẽ bắt đầu với **Phase 1: Core System Refactor**.
-1. Tạo thư mục `core/cli`.
-2. Di chuyển `ag-smart.js` và `scripts/*.js` vào đó.
-3. Cập nhật `package.json` để trỏ đúng bin.

package/docs/PYTHON_SCRIPTS.md

@@ -1,55 +0,0 @@
-# Python Scripts Requirements
-
-This document lists the Python dependencies required for running the validation scripts in `.agent/skills/*/scripts/`.
-
-## Required Python Version
-
-- **Python 3.8+** recommended
-
-## Installation
-
-Most scripts use only Python standard library. However, some may require additional packages:
-
-```bash
-# Install common dependencies
-pip install pyyaml requests
-```
-
-## Available Scripts
-
-| Script | Location | Description |
-|--------|----------|-------------|
-| `security_scan.py` | vulnerability-scanner | OWASP security audit |
-| `lint_runner.py` | lint-and-validate | Run linting tools |
-| `schema_validator.py` | database-design | Validate DB schemas |
-| `ux_audit.py` | frontend-design | UX accessibility check |
-| `seo_checker.py` | seo-fundamentals | SEO validation |
-| `lighthouse_audit.py` | performance-profiling | Web performance audit |
-| `playwright_runner.py` | webapp-testing | E2E test runner |
-| `mobile_audit.py` | mobile-design | Mobile UI validation |
-| `i18n_checker.py` | i18n-localization | Translation check |
-| `geo_checker.py` | geo-fundamentals | GenAI optimization |
-| `api_validator.py` | api-patterns | API contract validation |
-| `test_runner.py` | testing-patterns | Test suite runner |
-| `type_coverage.py` | lint-and-validate | TypeScript coverage |
-| `accessibility_checker.py` | frontend-design | A11y audit |
-
-## Running Scripts
-
-```bash
-# Run from project root
-python .agent/skills/vulnerability-scanner/scripts/security_scan.py .
-
-# Or use npm scripts
-npm run scan:security
-npm run lint
-npm run checklist
-```
-
-## Troubleshooting
-
-If a script fails with import errors, ensure you have the required dependencies:
-
-```bash
-pip install -r requirements.txt  # If available in script directory
-```