npm - @neyugn/agent-kits - Versions diffs - 0.1.0 - Mend

@neyugn/agent-kits 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (158) hide show

package/LICENSE +21 -0
package/README.md +514 -0
package/README.vi.md +410 -0
package/README.zh.md +410 -0
package/dist/cli.d.ts +1 -0
package/dist/cli.js +422 -0
package/kits/coder/ARCHITECTURE.md +289 -0
package/kits/coder/agents/ai-engineer.md +344 -0
package/kits/coder/agents/backend-specialist.md +270 -0
package/kits/coder/agents/cloud-architect.md +363 -0
package/kits/coder/agents/code-reviewer.md +284 -0
package/kits/coder/agents/data-engineer.md +401 -0
package/kits/coder/agents/database-specialist.md +251 -0
package/kits/coder/agents/debugger.md +209 -0
package/kits/coder/agents/devops-engineer.md +281 -0
package/kits/coder/agents/documentation-writer.md +296 -0
package/kits/coder/agents/frontend-specialist.md +298 -0
package/kits/coder/agents/i18n-specialist.md +348 -0
package/kits/coder/agents/integration-specialist.md +314 -0
package/kits/coder/agents/mobile-developer.md +271 -0
package/kits/coder/agents/multi-tenant-architect.md +281 -0
package/kits/coder/agents/orchestrator.md +263 -0
package/kits/coder/agents/performance-analyst.md +327 -0
package/kits/coder/agents/project-planner.md +277 -0
package/kits/coder/agents/queue-specialist.md +282 -0
package/kits/coder/agents/realtime-specialist.md +267 -0
package/kits/coder/agents/security-auditor.md +253 -0
package/kits/coder/agents/test-engineer.md +315 -0
package/kits/coder/agents/ux-researcher.md +388 -0
package/kits/coder/rules/.cursorrules +287 -0
package/kits/coder/rules/CLAUDE.md +287 -0
package/kits/coder/rules/CODEX.md +287 -0
package/kits/coder/rules/GEMINI.md +287 -0
package/kits/coder/scripts/checklist.py +318 -0
package/kits/coder/scripts/kit_status.py +292 -0
package/kits/coder/scripts/skills_manager.py +243 -0
package/kits/coder/scripts/verify_all.py +391 -0
package/kits/coder/skills/accessibility-patterns/SKILL.md +372 -0
package/kits/coder/skills/accessibility-patterns/scripts/a11y_checker.py +211 -0
package/kits/coder/skills/ai-rag-patterns/SKILL.md +444 -0
package/kits/coder/skills/api-patterns/SKILL.md +316 -0
package/kits/coder/skills/api-patterns/assets/.gitkeep +1 -0
package/kits/coder/skills/api-patterns/references/deep-dive.md +21 -0
package/kits/coder/skills/api-patterns/scripts/api_validator.py +253 -0
package/kits/coder/skills/api-patterns/scripts/validate.py +56 -0
package/kits/coder/skills/auth-patterns/SKILL.md +267 -0
package/kits/coder/skills/aws-patterns/SKILL.md +576 -0
package/kits/coder/skills/brainstorming/SKILL.md +370 -0
package/kits/coder/skills/brainstorming/assets/.gitkeep +1 -0
package/kits/coder/skills/brainstorming/references/deep-dive.md +21 -0
package/kits/coder/skills/brainstorming/scripts/validate.py +56 -0
package/kits/coder/skills/clean-code/SKILL.md +240 -0
package/kits/coder/skills/clean-code/assets/.gitkeep +1 -0
package/kits/coder/skills/clean-code/references/deep-dive.md +21 -0
package/kits/coder/skills/clean-code/scripts/lint_runner.py +186 -0
package/kits/coder/skills/clean-code/scripts/validate.py +56 -0
package/kits/coder/skills/database-design/SKILL.md +255 -0
package/kits/coder/skills/database-design/assets/.gitkeep +1 -0
package/kits/coder/skills/database-design/references/deep-dive.md +21 -0
package/kits/coder/skills/database-design/scripts/schema_validator.py +272 -0
package/kits/coder/skills/database-design/scripts/validate.py +56 -0
package/kits/coder/skills/docker-patterns/SKILL.md +240 -0
package/kits/coder/skills/documentation-templates/SKILL.md +441 -0
package/kits/coder/skills/e2e-testing/SKILL.md +457 -0
package/kits/coder/skills/flutter-patterns/SKILL.md +330 -0
package/kits/coder/skills/frontend-design/SKILL.md +127 -0
package/kits/coder/skills/github-actions/SKILL.md +349 -0
package/kits/coder/skills/gitlab-ci-patterns/SKILL.md +466 -0
package/kits/coder/skills/graphql-patterns/SKILL.md +558 -0
package/kits/coder/skills/i18n-localization/SKILL.md +345 -0
package/kits/coder/skills/i18n-localization/scripts/i18n_checker.py +267 -0
package/kits/coder/skills/kubernetes-patterns/SKILL.md +357 -0
package/kits/coder/skills/mermaid-diagrams/SKILL.md +351 -0
package/kits/coder/skills/mobile-design/SKILL.md +305 -0
package/kits/coder/skills/monitoring-observability/SKILL.md +458 -0
package/kits/coder/skills/multi-tenancy/SKILL.md +317 -0
package/kits/coder/skills/multi-tenancy/assets/.gitkeep +1 -0
package/kits/coder/skills/multi-tenancy/references/deep-dive.md +21 -0
package/kits/coder/skills/multi-tenancy/scripts/validate.py +56 -0
package/kits/coder/skills/nodejs-best-practices/SKILL.md +220 -0
package/kits/coder/skills/performance-profiling/SKILL.md +333 -0
package/kits/coder/skills/performance-profiling/assets/.gitkeep +1 -0
package/kits/coder/skills/performance-profiling/references/deep-dive.md +21 -0
package/kits/coder/skills/performance-profiling/scripts/validate.py +56 -0
package/kits/coder/skills/plan-writing/SKILL.md +360 -0
package/kits/coder/skills/plan-writing/assets/.gitkeep +1 -0
package/kits/coder/skills/plan-writing/references/deep-dive.md +21 -0
package/kits/coder/skills/plan-writing/scripts/validate.py +56 -0
package/kits/coder/skills/postgres-patterns/SKILL.md +361 -0
package/kits/coder/skills/prompt-engineering/SKILL.md +277 -0
package/kits/coder/skills/queue-patterns/SKILL.md +359 -0
package/kits/coder/skills/queue-patterns/assets/.gitkeep +1 -0
package/kits/coder/skills/queue-patterns/references/deep-dive.md +21 -0
package/kits/coder/skills/queue-patterns/scripts/validate.py +56 -0
package/kits/coder/skills/react-native-patterns/SKILL.md +393 -0
package/kits/coder/skills/react-patterns/SKILL.md +319 -0
package/kits/coder/skills/realtime-patterns/SKILL.md +506 -0
package/kits/coder/skills/realtime-patterns/assets/.gitkeep +1 -0
package/kits/coder/skills/realtime-patterns/references/deep-dive.md +21 -0
package/kits/coder/skills/realtime-patterns/scripts/validate.py +56 -0
package/kits/coder/skills/redis-patterns/SKILL.md +484 -0
package/kits/coder/skills/security-fundamentals/SKILL.md +363 -0
package/kits/coder/skills/security-fundamentals/assets/.gitkeep +1 -0
package/kits/coder/skills/security-fundamentals/references/deep-dive.md +21 -0
package/kits/coder/skills/security-fundamentals/scripts/security_scan.py +326 -0
package/kits/coder/skills/security-fundamentals/scripts/validate.py +56 -0
package/kits/coder/skills/seo-patterns/SKILL.md +262 -0
package/kits/coder/skills/seo-patterns/scripts/seo_checker.py +211 -0
package/kits/coder/skills/systematic-debugging/SKILL.md +478 -0
package/kits/coder/skills/systematic-debugging/assets/.gitkeep +1 -0
package/kits/coder/skills/systematic-debugging/references/deep-dive.md +21 -0
package/kits/coder/skills/systematic-debugging/scripts/validate.py +56 -0
package/kits/coder/skills/tailwind-patterns/SKILL.md +395 -0
package/kits/coder/skills/terraform-patterns/SKILL.md +470 -0
package/kits/coder/skills/testing-patterns/SKILL.md +285 -0
package/kits/coder/skills/testing-patterns/assets/.gitkeep +1 -0
package/kits/coder/skills/testing-patterns/references/deep-dive.md +21 -0
package/kits/coder/skills/testing-patterns/scripts/test_runner.py +219 -0
package/kits/coder/skills/testing-patterns/scripts/validate.py +56 -0
package/kits/coder/skills/typescript-patterns/SKILL.md +417 -0
package/kits/coder/skills/ui-ux-pro-max/SKILL.md +364 -0
package/kits/coder/skills/ui-ux-pro-max/data/charts.csv +26 -0
package/kits/coder/skills/ui-ux-pro-max/data/colors.csv +97 -0
package/kits/coder/skills/ui-ux-pro-max/data/icons.csv +101 -0
package/kits/coder/skills/ui-ux-pro-max/data/landing.csv +31 -0
package/kits/coder/skills/ui-ux-pro-max/data/products.csv +97 -0
package/kits/coder/skills/ui-ux-pro-max/data/prompts.csv +24 -0
package/kits/coder/skills/ui-ux-pro-max/data/react-performance.csv +45 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/react.csv +54 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
package/kits/coder/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -0
package/kits/coder/skills/ui-ux-pro-max/data/styles.csv +59 -0
package/kits/coder/skills/ui-ux-pro-max/data/typography.csv +58 -0
package/kits/coder/skills/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
package/kits/coder/skills/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
package/kits/coder/skills/ui-ux-pro-max/data/web-interface.csv +31 -0
package/kits/coder/skills/ui-ux-pro-max/scripts/__pycache__/core.cpython-314.pyc +0 -0
package/kits/coder/skills/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-314.pyc +0 -0
package/kits/coder/skills/ui-ux-pro-max/scripts/core.py +257 -0
package/kits/coder/skills/ui-ux-pro-max/scripts/design_system.py +488 -0
package/kits/coder/skills/ui-ux-pro-max/scripts/search.py +76 -0
package/kits/coder/workflows/.gitkeep +20 -0
package/kits/coder/workflows/create.md +152 -0
package/kits/coder/workflows/debug.md +223 -0
package/kits/coder/workflows/deploy.md +283 -0
package/kits/coder/workflows/orchestrate.md +243 -0
package/kits/coder/workflows/plan.md +134 -0
package/kits/coder/workflows/test.md +237 -0
package/kits/coder/workflows/ui-ux-pro-max.md +109 -0
package/package.json +49 -0

package/kits/coder/skills/accessibility-patterns/SKILL.md ADDED Viewed

@@ -0,0 +1,372 @@
+---
+name: accessibility-patterns
+description: WCAG compliance, inclusive design, and assistive technology patterns. Use when auditing accessibility, implementing a11y features, or ensuring digital products are accessible to all users.
+allowed-tools: Read, Write, Edit, Bash
+version: 1.0
+priority: MEDIUM
+---
+# Accessibility Patterns - Inclusive Design Excellence
+> **Philosophy:** Accessibility is not a feature, it's a fundamental requirement. Design for everyone from the start.
+---
+## 🎯 Core Principles
+| Principle           | Rule                                          |
+| ------------------- | --------------------------------------------- |
+| **Perceivable**     | Information must be presentable to all senses |
+| **Operable**        | UI must be operable by all users              |
+| **Understandable**  | Information and UI must be understandable     |
+| **Robust**          | Content must work with assistive technologies |
+| **Inclusive First** | Build accessibility in, don't bolt it on      |
+```
+❌ WRONG: Build first, add accessibility later
+✅ CORRECT: Consider accessibility in every design decision
+```
+---
+## 📊 WCAG Compliance Levels
+| Level   | Description                     | Legal Requirement?      |
+| ------- | ------------------------------- | ----------------------- |
+| **A**   | Minimum accessibility           | Often required          |
+| **AA**  | Standard for most organizations | Most common requirement |
+| **AAA** | Highest accessibility standard  | Rarely fully achievable |
+> **Target AA for most projects.** It covers the most critical accessibility needs.
+---
+## 🎨 Visual Accessibility
+### Color Contrast
+| Element            | AA Ratio | AAA Ratio |
+| ------------------ | -------- | --------- |
+| Normal text        | 4.5:1    | 7:1       |
+| Large text (18px+) | 3:1      | 4.5:1     |
+| UI components      | 3:1      | 3:1       |
+| Focus indicators   | 3:1      | 3:1       |
+```css
+/* ✅ GOOD - Sufficient contrast */
+.text-primary {
+  color: #1a1a1a; /* Contrast: 16.1:1 on white */
+  background: #ffffff;
+}
+/* ❌ BAD - Insufficient contrast */
+.text-muted {
+  color: #999999; /* Contrast: 2.8:1 - FAILS */
+  background: #ffffff;
+}
+```
+### Color Independence
+```html
+<!-- ❌ BAD - Color only indicates error -->
+<input class="error-red" />
+<!-- ✅ GOOD - Multiple indicators -->
+<input class="error" aria-invalid="true" />
+<span class="error-icon">⚠️</span>
+<span class="error-message">Email is required</span>
+```
+---
+## ⌨️ Keyboard Accessibility
+### Focus Management
+| Rule                        | Implementation                    |
+| --------------------------- | --------------------------------- |
+| All interactive elements    | Must be focusable via Tab         |
+| Logical focus order         | Match visual reading order        |
+| Visible focus indicators    | Never `outline: none` without alt |
+| Focus trapping in modals    | Tab loops within modal            |
+| Return focus on modal close | Focus returns to trigger element  |
+### Focus Indicator Pattern
+```css
+/* ✅ GOOD - Visible, accessible focus */
+:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 2px;
+}
+/* Remove default only if custom focus exists */
+button:focus:not(:focus-visible) {
+  outline: none;
+}
+```
+### Skip Links
+```html
+<body>
+  <a href="#main-content" class="skip-link"> Skip to main content </a>
+  <!-- Navigation -->
+  <main id="main-content">
+    <!-- Content -->
+  </main>
+</body>
+```
+```css
+.skip-link {
+  position: absolute;
+  left: -9999px;
+}
+.skip-link:focus {
+  left: 10px;
+  top: 10px;
+  z-index: 9999;
+}
+```
+---
+## 🔊 Screen Reader Support
+### Semantic HTML
+| Use                 | Not                     |
+| ------------------- | ----------------------- |
+| `<button>`          | `<div onclick>`         |
+| `<a href>`          | `<span onclick>`        |
+| `<nav>`             | `<div class="nav">`     |
+| `<main>`            | `<div class="main">`    |
+| `<header>/<footer>` | `<div class="header">`  |
+| `<article>`         | `<div class="article">` |
+### ARIA Usage Guidelines
+```html
+<!-- Rule 1: Don't use ARIA if you can use HTML -->
+<!-- ❌ BAD -->
+<div role="button" tabindex="0">Click me</div>
+<!-- ✅ GOOD -->
+<button>Click me</button>
+<!-- Rule 2: Use ARIA to enhance, not replace -->
+<button aria-label="Close dialog" aria-describedby="dialog-desc">
+  <svg><!-- X icon --></svg>
+</button>
+<p id="dialog-desc">This will close the settings dialog</p>
+```
+### Live Regions
+```html
+<!-- Announce dynamic content changes -->
+<div role="status" aria-live="polite">3 search results found</div>
+<div role="alert" aria-live="assertive">Error: Unable to save changes</div>
+```
+| aria-live Value | Use Case                            |
+| --------------- | ----------------------------------- |
+| `polite`        | Non-urgent updates (search results) |
+| `assertive`     | Urgent (errors, alerts)             |
+| `off`           | Don't announce                      |
+---
+## 📝 Forms Accessibility
+### Labels and Descriptions
+```html
+<!-- ✅ GOOD - Properly labeled -->
+<label for="email">Email Address</label>
+<input
+  type="email"
+  id="email"
+  aria-describedby="email-hint email-error"
+  aria-invalid="false"
+  required
+/>
+<span id="email-hint">We'll never share your email</span>
+<span id="email-error" role="alert"></span>
+```
+### Error Handling
+```html
+<!-- Error state -->
+<label for="password">Password</label>
+<input
+  type="password"
+  id="password"
+  aria-invalid="true"
+  aria-describedby="password-error"
+/>
+<span id="password-error" role="alert">
+  Password must be at least 8 characters
+</span>
+```
+### Form Validation Pattern
+| When      | What                                    |
+| --------- | --------------------------------------- |
+| On submit | Announce error count, focus first error |
+| On blur   | Validate individual field               |
+| On fix    | Clear error, don't re-announce success  |
+---
+## 🖼️ Images and Media
+### Alt Text Guidelines
+| Image Type        | Alt Text                       |
+| ----------------- | ------------------------------ |
+| Informative       | Describe content and purpose   |
+| Decorative        | `alt=""` (empty)               |
+| Functional (link) | Describe destination/action    |
+| Complex (chart)   | Brief alt + longer description |
+```html
+<!-- Informative -->
+<img src="chart.png" alt="Sales grew 25% from Q1 to Q2" />
+<!-- Decorative -->
+<img src="decoration.png" alt="" role="presentation" />
+<!-- Complex -->
+<figure>
+  <img src="complex-chart.png" alt="Revenue breakdown by region" />
+  <figcaption>North America leads with 45%, Europe at 30%...</figcaption>
+</figure>
+```
+### Video Accessibility
+| Requirement     | Solution                     |
+| --------------- | ---------------------------- |
+| Deaf users      | Captions (synchronized text) |
+| Blind users     | Audio descriptions           |
+| Deafblind users | Transcript                   |
+| Seizure safety  | No flashing >3 times/second  |
+---
+## 📱 Touch and Mobile
+### Touch Target Size
+| Standard        | Minimum Size |
+| --------------- | ------------ |
+| WCAG 2.2 AA     | 24x24px      |
+| WCAG 2.2 AAA    | 44x44px      |
+| Apple HIG       | 44x44pt      |
+| Material Design | 48x48dp      |
+### Spacing Between Targets
+```css
+.button-group button {
+  min-width: 44px;
+  min-height: 44px;
+  margin: 8px; /* Prevent accidental taps */
+}
+```
+---
+## 🧪 Testing Tools
+### Automated Testing
+| Tool             | Use Case                            |
+| ---------------- | ----------------------------------- |
+| **axe DevTools** | Browser extension, CI integration   |
+| **Lighthouse**   | Chrome DevTools, performance + a11y |
+| **WAVE**         | Browser extension, visual feedback  |
+| **pa11y**        | CLI tool for CI/CD                  |
+| **jest-axe**     | Unit test accessibility assertions  |
+### Manual Testing
+| Test           | How                                  |
+| -------------- | ------------------------------------ |
+| Keyboard only  | Unplug mouse, navigate with Tab      |
+| Screen reader  | VoiceOver (Mac), NVDA/JAWS (Windows) |
+| Zoom 200%      | Browser zoom, check layout           |
+| Color contrast | Use contrast checker tools           |
+| Motion reduced | Test `prefers-reduced-motion`        |
+---
+## 🚨 Anti-Patterns
+| ❌ Don't                         | ✅ Do                               |
+| -------------------------------- | ----------------------------------- |
+| `outline: none` without alt      | Custom focus with adequate contrast |
+| Color-only indicators            | Multiple visual cues                |
+| Generic link text ("click here") | Descriptive link text               |
+| Auto-playing media               | User-controlled playback            |
+| Time limits without extension    | Allow time extension or removal     |
+| Mouse-only interactions          | Keyboard equivalent for all actions |
+| Missing form labels              | Associated labels or aria-label     |
+| Small touch targets              | Minimum 44x44 touch targets         |
+---
+## ✅ Accessibility Checklist
+### Perceivable
+- [ ] All images have appropriate alt text
+- [ ] Color contrast meets 4.5:1 for text
+- [ ] Color is not the only way to convey info
+- [ ] Captions for video content
+- [ ] Text can be resized to 200% without loss
+### Operable
+- [ ] All functionality available via keyboard
+- [ ] Visible focus indicators on all elements
+- [ ] Skip links for main content
+- [ ] No keyboard traps
+- [ ] Adequate time for timed content
+- [ ] Touch targets are 44x44 minimum
+### Understandable
+- [ ] Language attribute on `<html>`
+- [ ] Consistent navigation pattern
+- [ ] Form errors are clearly explained
+- [ ] Labels on all form fields
+- [ ] Instructions before complex forms
+### Robust
+- [ ] Valid HTML
+- [ ] Semantic elements used correctly
+- [ ] ARIA used only when necessary
+- [ ] Works with screen readers
+---
+## 🔗 Related Skills
+| Need               | Skill                   |
+| ------------------ | ----------------------- |
+| SEO implementation | `seo-patterns`          |
+| Frontend design    | `frontend-design`       |
+| UX research        | UX researcher agent     |
+| Performance        | `performance-profiling` |
+---
+> **Remember:** Every accessibility barrier you remove opens your product to more people. 15-20% of the global population has some form of disability.

package/kits/coder/skills/accessibility-patterns/scripts/a11y_checker.py ADDED Viewed

@@ -0,0 +1,211 @@
+#!/usr/bin/env python3
+"""
+Accessibility Checker - WCAG compliance audit for AGT-Kit
+==========================================================
+Checks HTML/JSX for common accessibility issues.
+Usage:
+    python3 .agent/skills/accessibility-patterns/scripts/a11y_checker.py <project_path>
+Checks based on WCAG 2.2:
+    - Images with alt text
+    - Form labels
+    - Heading hierarchy
+    - Color contrast considerations
+    - ARIA attributes
+    - Keyboard navigation hints
+"""
+import sys
+import re
+import json
+from pathlib import Path
+from datetime import datetime
+from typing import Dict, List, Any
+# Fix console encoding
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except:
+    pass
+SKIP_DIRS = {'node_modules', '.git', 'dist', 'build', '__pycache__', '.next', 'venv'}
+def find_ui_files(project_path: Path) -> List[Path]:
+    """Find UI component files."""
+    patterns = ['**/*.tsx', '**/*.jsx', '**/*.html', '**/*.vue']
+    files = []
+    for pattern in patterns:
+        for f in project_path.glob(pattern):
+            if not any(skip in f.parts for skip in SKIP_DIRS):
+                # Skip test files
+                if not any(x in f.name.lower() for x in ['test', 'spec', 'mock']):
+                    files.append(f)
+    return files[:30]  # Limit
+def check_file(file_path: Path) -> Dict[str, Any]:
+    """Check a single file for accessibility issues."""
+    try:
+        content = file_path.read_text(encoding='utf-8', errors='ignore')
+    except:
+        return {'file': file_path.name, 'passed': [], 'issues': ['Read error']}
+    passed = []
+    issues = []
+    # 1. Images with alt text
+    img_tags = re.findall(r'<img[^>]*>', content, re.I)
+    img_without_alt = [img for img in img_tags if 'alt=' not in img.lower()]
+    if img_tags and not img_without_alt:
+        passed.append(f"All {len(img_tags)} images have alt text")
+    elif img_without_alt:
+        issues.append(f"{len(img_without_alt)} images missing alt text")
+    # 2. Form labels
+    inputs = re.findall(r'<input[^>]*>', content, re.I)
+    inputs_need_label = [i for i in inputs if 'type="hidden"' not in i.lower() and 'type="submit"' not in i.lower()]
+    has_labels = 'label' in content.lower() or 'aria-label' in content.lower()
+    if inputs_need_label and has_labels:
+        passed.append("Form labels/aria-labels found")
+    elif inputs_need_label and not has_labels:
+        issues.append("Form inputs may be missing labels")
+    # 3. Heading hierarchy
+    h1_count = len(re.findall(r'<h1[^>]*>', content, re.I))
+    h2_count = len(re.findall(r'<h2[^>]*>', content, re.I))
+    h3_count = len(re.findall(r'<h3[^>]*>', content, re.I))
+    if h1_count <= 1:
+        passed.append("Proper H1 usage (0-1)")
+    else:
+        issues.append(f"Multiple H1 tags ({h1_count}) - bad for a11y")
+    # Check for skipped heading levels (h1 -> h3 without h2)
+    if h3_count > 0 and h2_count == 0 and h1_count > 0:
+        issues.append("Skipped heading level (H1 -> H3)")
+    # 4. ARIA attributes
+    aria_patterns = ['aria-label', 'aria-labelledby', 'aria-describedby', 'role=']
+    has_aria = any(p in content for p in aria_patterns)
+    if has_aria:
+        passed.append("ARIA attributes used")
+    # 5. Focus indicators
+    focus_patterns = [':focus', 'onFocus', 'tabIndex', 'focus-visible']
+    has_focus = any(p in content for p in focus_patterns)
+    if has_focus:
+        passed.append("Focus handling present")
+    # 6. Buttons with text/aria-label
+    buttons = re.findall(r'<button[^>]*>([^<]*)</button>', content, re.I)
+    empty_buttons = [b for b in re.findall(r'<button[^>]*>', content, re.I)
+                     if 'aria-label' not in b.lower() and '>' in b and '</' in content[content.find(b):content.find(b)+100]]
+    # Check for icon-only buttons
+    icon_buttons = re.findall(r'<button[^>]*>\s*<[^>]+/>\s*</button>', content, re.I)
+    if icon_buttons:
+        issues.append(f"{len(icon_buttons)} icon-only buttons may need aria-label")
+    # 7. Links with meaningful text
+    links = re.findall(r'<a[^>]*>([^<]*)</a>', content, re.I)
+    bad_link_text = ['click here', 'read more', 'here', 'more']
+    problematic_links = [l for l in links if l.lower().strip() in bad_link_text]
+    if problematic_links:
+        issues.append(f"{len(problematic_links)} links with non-descriptive text")
+    elif links:
+        passed.append("Link text appears descriptive")
+    # 8. Color contrast (basic check)
+    if 'color:' in content.lower() or 'backgroundColor' in content:
+        if 'contrast' in content.lower() or '--' in content:  # CSS variables
+            passed.append("Color theming detected")
+    # 9. Skip links
+    if 'skip' in content.lower() and 'main' in content.lower():
+        passed.append("Skip link pattern detected")
+    return {'file': file_path.name, 'passed': passed, 'issues': issues}
+def main():
+    project_path = Path(sys.argv[1] if len(sys.argv) > 1 else ".").resolve()
+    print(f"\n{'='*60}")
+    print(f"[AGT-KIT A11Y CHECKER] Accessibility Audit (WCAG 2.2)")
+    print(f"{'='*60}")
+    print(f"Project: {project_path}")
+    print(f"Time: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+    print("-"*60)
+    files = find_ui_files(project_path)
+    if not files:
+        print("\nNo UI files found.")
+        output = {
+            "script": "a11y_checker",
+            "skill": "accessibility-patterns",
+            "project": str(project_path),
+            "files_checked": 0,
+            "passed": True
+        }
+        print(json.dumps(output, indent=2))
+        sys.exit(0)
+    print(f"Found {len(files)} UI files to analyze\n")
+    results = []
+    total_passed = 0
+    total_issues = 0
+    for file_path in files:
+        result = check_file(file_path)
+        if result['issues'] or result['passed']:
+            results.append(result)
+            total_passed += len(result['passed'])
+            total_issues += len(result['issues'])
+            if result['issues']:
+                print(f"⚠️  {result['file']}")
+                for issue in result['issues'][:2]:
+                    print(f"   - {issue}")
+    # Summary
+    print("\n" + "="*60)
+    print("SUMMARY")
+    print("="*60)
+    print(f"✅ {total_passed} accessibility patterns found")
+    print(f"⚠️  {total_issues} potential issues")
+    passed = total_issues < 10
+    if passed:
+        print("\n✅ Accessibility check passed")
+    else:
+        print("\n⚠️  Review accessibility issues")
+    output = {
+        "script": "a11y_checker",
+        "skill": "accessibility-patterns",
+        "project": str(project_path),
+        "files_checked": len(files),
+        "patterns_found": total_passed,
+        "issues_found": total_issues,
+        "passed": passed
+    }
+    print("\n" + json.dumps(output, indent=2))
+    sys.exit(0 if passed else 1)
+if __name__ == "__main__":
+    main()