Dev

.claude-plugin/marketplace.json

@@ -82,7 +82,7 @@
     {
       "name": "engineering-skills",
       "source": "./engineering-team",
-      "description": "25 engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering, Playwright (9 sub-skills), self-improving agent, Stripe integration, TDD guide, tech stack evaluator, Google Workspace CLI.",
+      "description": "26 engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering, Playwright (9 sub-skills), self-improving agent, Stripe integration, TDD guide, tech stack evaluator, Google Workspace CLI, a11y audit (WCAG 2.2).",
       "version": "2.1.2",
       "author": {
         "name": "Alireza Rezvani"
@@ -441,6 +441,111 @@
         "optimization"
       ],
       "category": "development"
+    },
+    {
+      "name": "a11y-audit",
+      "source": "./engineering-team/a11y-audit",
+      "description": "WCAG 2.2 accessibility audit and fix for React, Next.js, Vue, Angular, Svelte, and HTML. Static scanner detecting 20+ violation types, contrast checker with suggest mode, framework-specific fix patterns, /a11y-audit slash command.",
+      "version": "2.1.2",
+      "author": {
+        "name": "Alireza Rezvani"
+      },
+      "keywords": [
+        "accessibility",
+        "a11y",
+        "wcag",
+        "aria",
+        "screen-reader",
+        "contrast",
+        "keyboard-navigation"
+      ],
+      "category": "development"
+    },
+    {
+      "name": "executive-mentor",
+      "source": "./c-level-advisor/executive-mentor",
+      "description": "Adversarial thinking partner for founders and executives. Stress-tests plans, prepares for board meetings, navigates hard calls, runs postmortems. 5 sub-skills with slash commands.",
+      "version": "2.1.2",
+      "author": {
+        "name": "Alireza Rezvani"
+      },
+      "keywords": [
+        "executive",
+        "mentor",
+        "stress-test",
+        "board-prep",
+        "founder",
+        "leadership"
+      ],
+      "category": "leadership"
+    },
+    {
+      "name": "docker-development",
+      "source": "./engineering/docker-development",
+      "description": "Docker and container development — Dockerfile optimization, docker-compose orchestration, multi-stage builds, security hardening, and CI/CD container pipelines.",
+      "version": "2.1.2",
+      "author": {
+        "name": "Alireza Rezvani"
+      },
+      "keywords": [
+        "docker",
+        "container",
+        "dockerfile",
+        "docker-compose",
+        "devops"
+      ],
+      "category": "development"
+    },
+    {
+      "name": "helm-chart-builder",
+      "source": "./engineering/helm-chart-builder",
+      "description": "Helm chart development — chart scaffolding, values design, template patterns, dependency management, and Kubernetes deployment strategies.",
+      "version": "2.1.2",
+      "author": {
+        "name": "Alireza Rezvani"
+      },
+      "keywords": [
+        "helm",
+        "kubernetes",
+        "k8s",
+        "chart",
+        "deployment"
+      ],
+      "category": "development"
+    },
+    {
+      "name": "terraform-patterns",
+      "source": "./engineering/terraform-patterns",
+      "description": "Terraform infrastructure-as-code — module design patterns, state management, provider configuration, CI/CD integration, and multi-environment strategies.",
+      "version": "2.1.2",
+      "author": {
+        "name": "Alireza Rezvani"
+      },
+      "keywords": [
+        "terraform",
+        "iac",
+        "infrastructure",
+        "devops",
+        "cloud"
+      ],
+      "category": "development"
+    },
+    {
+      "name": "research-summarizer",
+      "source": "./product-team/research-summarizer",
+      "description": "Structured research summarization — summarize academic papers, market research, user interviews, and competitive analysis into actionable insights.",
+      "version": "2.1.2",
+      "author": {
+        "name": "Alireza Rezvani"
+      },
+      "keywords": [
+        "research",
+        "summarization",
+        "analysis",
+        "insights",
+        "product"
+      ],
+      "category": "product"
     }
   ]
 }

.claude/commands/seo-auditor.md

@@ -0,0 +1,97 @@
+---
+description: Scan and optimize docs for SEO — meta tags, readability, keywords, broken links, sitemap.
+---
+
+Run the SEO auditor on documentation files. Target path: `$ARGUMENTS` (default: all docs/ and root README.md).
+
+If `$ARGUMENTS` is `--report-only`, scan without making changes.
+
+Execute all 7 phases. Auto-fix non-destructive issues. Never change URLs. Preserve content on high-ranking pages.
+
+## Phase 1: Discovery
+
+Find all target markdown files:
+- `docs/**/*.md` — all documentation pages
+- `README.md` files in domain root directories
+- If `$ARGUMENTS` specifies a path, scope to that path only
+
+For each file, extract current state: `title:` frontmatter, `description:` frontmatter, H1, H2s, word count, link count. Store as baseline for the report.
+
+Identify recently changed files: `git log --oneline -2 --name-only -- docs/ README.md`
+
+## Phase 2: Meta Tags
+
+For each file with YAML frontmatter:
+
+**Title** (`title:` field):
+- Must be 50-60 characters
+- Must contain a primary keyword
+- Must be unique across all pages
+- Auto-fix generic titles using domain context
+
+**Description** (`description:` field):
+- Must be 120-160 characters
+- Must contain primary keyword
+- Must be unique — no duplicates
+- Auto-fix from SKILL.md frontmatter or first paragraph
+
+Run SEO checker on built HTML pages:
+```bash
+python3 marketing-skill/seo-audit/scripts/seo_checker.py --file site/{path}/index.html
+```
+
+## Phase 3: Content Quality
+
+**Heading structure:** One H1 per page, no skipped levels, keywords in headings.
+
+**Readability:** Run content scorer:
+```bash
+python3 marketing-skill/content-production/scripts/content_scorer.py {file}
+```
+Target: readability ≥ 70, structure ≥ 60.
+
+**AI detection** (on non-generated files only):
+```bash
+python3 marketing-skill/content-humanizer/scripts/humanizer_scorer.py {file}
+```
+Flag pages < 50. Fix AI clichés: "delve", "leverage", "it's important to note", "comprehensive".
+
+**Do NOT rewrite** pages ranking well — only fix critical issues on those.
+
+## Phase 4: Keywords
+
+Check each page has its primary keyword in: title, description, H1, first paragraph, at least one H2.
+
+Keyword density: 1-2% for primary. Flag and reduce if > 3%.
+
+**Never change existing URLs.** Only optimize content and meta tags.
+
+## Phase 5: Links
+
+**Internal links:** Verify all `[text](url)` targets exist. Fix broken links.
+
+**Duplicate content:**
+```bash
+grep -rh '^description:' docs/**/*.md | sort | uniq -d
+```
+Make each duplicate unique.
+
+**Orphan pages:** Find pages not in `mkdocs.yml` nav. Add them.
+
+## Phase 6: Sitemap
+
+Rebuild the site to regenerate sitemap:
+```bash
+mkdocs build
+```
+
+Analyze the sitemap:
+```bash
+python3 marketing-skill/site-architecture/scripts/sitemap_analyzer.py site/sitemap.xml
+```
+
+Verify all pages appear, no duplicates, no broken URLs.
+
+## Phase 7: Report
+
+Present a summary showing: pages scanned, issues found, auto-fixes applied, manual review items, broken links fixed, orphans resolved, sitemap URL count. List preserved pages that were not modified.

.codex/skills-index.json

@@ -357,7 +357,7 @@
       "name": "agent-designer",
       "source": "../../engineering/agent-designer",
       "category": "engineering-advanced",
-      "description": "Agent Designer - Multi-Agent System Architecture"
+      "description": "Use when the user asks to design multi-agent systems, create agent architectures, define agent communication patterns, or build autonomous agent workflows."
     },
     {
       "name": "agent-workflow-designer",
@@ -381,7 +381,7 @@
       "name": "api-test-suite-builder",
       "source": "../../engineering/api-test-suite-builder",
       "category": "engineering-advanced",
-      "description": "API Test Suite Builder"
+      "description": "Use when the user asks to generate API tests, create integration test suites, test REST endpoints, or build contract tests."
     },
     {
       "name": "autoresearch-agent",
@@ -411,13 +411,13 @@
       "name": "database-designer",
       "source": "../../engineering/database-designer",
       "category": "engineering-advanced",
-      "description": "Database Designer - POWERFUL Tier Skill"
+      "description": "Use when the user asks to design database schemas, plan data migrations, optimize queries, choose between SQL and NoSQL, or model data relationships."
     },
     {
       "name": "database-schema-designer",
       "source": "../../engineering/database-schema-designer",
       "category": "engineering-advanced",
-      "description": "Database Schema Designer"
+      "description": "Use when the user asks to create ERD diagrams, normalize database schemas, design table relationships, or plan schema migrations."
     },
     {
       "name": "dependency-auditor",
@@ -489,19 +489,19 @@
       "name": "pr-review-expert",
       "source": "../../engineering/pr-review-expert",
       "category": "engineering-advanced",
-      "description": "PR Review Expert"
+      "description": "Use when the user asks to review pull requests, analyze code changes, check for security issues in PRs, or assess code quality of diffs."
     },
     {
       "name": "rag-architect",
       "source": "../../engineering/rag-architect",
       "category": "engineering-advanced",
-      "description": "RAG Architect - POWERFUL"
+      "description": "Use when the user asks to design RAG pipelines, optimize retrieval strategies, choose embedding models, implement vector search, or build knowledge retrieval systems."
     },
     {
       "name": "release-manager",
       "source": "../../engineering/release-manager",
       "category": "engineering-advanced",
-      "description": "Release Manager"
+      "description": "Use when the user asks to plan releases, manage changelogs, coordinate deployments, create release branches, or automate versioning."
     },
     {
       "name": "runbook-generator",

.gemini/skills-index.json

@@ -1,7 +1,7 @@
 {
   "version": "1.0.0",
   "name": "gemini-cli-skills",
-  "total_skills": 249,
+  "total_skills": 251,
   "skills": [
     {
       "name": "README",
@@ -328,6 +328,11 @@
       "category": "command",
       "description": "Generate changelogs from git history and validate conventional commits. Usage: /changelog <generate|lint> [options]"
     },
+    {
+      "name": "cmd-a11y-audit",
+      "category": "command",
+      "description": "Scan a frontend project for WCAG 2.2 accessibility violations and fix them. Usage: /a11y-audit [path]"
+    },
     {
       "name": "cmd-code-to-prd",
       "category": "command",
@@ -418,6 +423,11 @@
       "category": "command",
       "description": "Generate user stories with acceptance criteria and sprint planning. Usage: /user-story <generate|sprint> [options]"
     },
+    {
+      "name": "a11y-audit",
+      "category": "engineering",
+      "description": "Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines."
+    },
     {
       "name": "aws-solution-architect",
       "category": "engineering",
@@ -1263,11 +1273,11 @@
       "description": "C-level resources"
     },
     "command": {
-      "count": 19,
+      "count": 20,
       "description": "Command resources"
     },
     "engineering": {
-      "count": 40,
+      "count": 41,
       "description": "Engineering resources"
     },
     "engineering-advanced": {

.gemini/skills/a11y-audit/SKILL.md

@@ -0,0 +1 @@
+../../../engineering-team/a11y-audit/SKILL.md

.gemini/skills/cmd-a11y-audit/SKILL.md

@@ -0,0 +1 @@
+../../../commands/a11y-audit.md

CLAUDE.md

@@ -38,7 +38,7 @@ claude-code-skills/
 ├── .claude-plugin/            # Plugin registry (marketplace.json)
 ├── agents/                    # 16 cs-* prefixed agents across all domains
 ├── commands/                  # 19 slash commands (changelog, tdd, saas-health, prd, code-to-prd, plugin-audit, sprint-plan, etc.)
-├── engineering-team/          # 25 core engineering skills + Playwright Pro + Self-Improving Agent
+├── engineering-team/          # 26 core engineering skills + Playwright Pro + Self-Improving Agent + A11y Audit
 ├── engineering/               # 30 POWERFUL-tier advanced skills (incl. AgentHub)
 ├── product-team/              # 13 product skills + Python tools
 ├── marketing-skill/           # 43 marketing skills (7 pods) + Python tools
@@ -149,7 +149,7 @@ See [standards/git/git-workflow-standards.md](standards/git/git-workflow-standar
 ## Roadmap
 
 **Phase 1-2 Complete:** 204 production-ready skills deployed across 9 domains
-- Engineering Core (25), Engineering POWERFUL (30), Product (14), Marketing (43), PM (6), C-Level (28), RA/QM (12), Business & Growth (4), Finance (2)
+- Engineering Core (26), Engineering POWERFUL (30), Product (14), Marketing (43), PM (6), C-Level (28), RA/QM (12), Business & Growth (4), Finance (2)
 - 268 Python automation tools, 384 reference guides, 16 agents, 19 commands
 - Complete enterprise coverage from engineering through regulatory compliance, sales, customer success, and finance
 - MkDocs Material docs site with 210+ indexed pages for SEO
@@ -203,4 +203,4 @@ This repository publishes skills to **ClawHub** (clawhub.com) as the distributio
 
 **Last Updated:** March 11, 2026
 **Version:** v2.1.2
-**Status:** 205 skills deployed across 9 domains, 22 marketplace plugins, docs site live
+**Status:** 205 skills deployed across 9 domains, 28 marketplace plugins, docs site live