release: sync dev → main — a11y-audit, /seo-auditor, /plugin-audit, 28 plugins (#380)
* fix: add missing plugin.json files and restore trailing newlines - Add plugin.json for review-fix-a11y skill - Add plugin.json for free-llm-api skill - Restore POSIX-compliant trailing newlines in JSON index files * feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375) Adds review-fix-a11y (WCAG 2.2 a11y audit + fix) and free-llm-api skills. Includes: - review-fix-a11y: WCAG 2.2 audit workflow, a11y_audit.py scanner, contrast_checker.py - free-llm-api: ChatAnywhere, Groq, Cerebras, OpenRouter, llm-mux, One API setup - secret_scanner.py upgrade with secrets-patterns-db integration (1,600+ patterns) Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223-alt@users.noreply.github.com> * chore: sync codex skills symlinks [automated] * Revert "feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)" This reverts commit49c9f2109f. * chore: sync codex skills symlinks [automated] * Revert "feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)" This reverts commit49c9f2109f. * feat(engineering-team): add a11y-audit skill — WCAG 2.2 accessibility audit & fix (#376) Built from scratch (replaces reverted PR #375 contribution). Skill package: - SKILL.md: 1132 lines, 3-phase workflow (scan → fix → verify), per-framework fix patterns (React, Next.js, Vue, Angular, Svelte, HTML), CI/CD integration guide, 20+ issue type coverage - scripts/a11y_scanner.py: static scanner detecting 20+ violation types across HTML/JSX/TSX/Vue/Svelte/CSS — severity-ranked, CI-friendly exit codes - scripts/contrast_checker.py: WCAG contrast calculator with AA/AAA checks, --suggest mode, --batch CSS scanning, named color support - references/wcag-quick-ref.md: WCAG 2.2 Level A/AA criteria table - references/aria-patterns.md: ARIA roles, live regions, keyboard interaction - references/framework-a11y-patterns.md: React, Vue, Angular, Svelte fix patterns - assets/sample-component.tsx: sample file with intentional violations - expected_outputs/: scan report, contrast output, JSON output samples - /a11y-audit slash command, settings.json, plugin.json, README.md Validation: 97.6/100 (EXCELLENT), quality 73.9/100 (B-), scripts 2/2 PASS Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * chore: sync codex skills symlinks [automated] * docs: sync counts across all docs — 205 skills, 268 tools, 19 commands, 22 plugins Update CLAUDE.md, README.md, docs/index.md, docs/getting-started.md, mkdocs.yml, marketplace.json with consistent counts. Sync Gemini CLI index with new skills (code-to-prd, plugin-audit). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat(marketplace): add 6 missing standalone plugins — total 22→28 Added to marketplace: - a11y-audit (WCAG 2.2 accessibility audit) - executive-mentor (adversarial thinking partner) - docker-development (Dockerfile, compose, multi-stage) - helm-chart-builder (Helm chart scaffolding) - terraform-patterns (IaC module design) - research-summarizer (structured research synthesis) Also fixed version 1.0.0 → 2.1.2 on 4 plugin.json files (executive-mentor, docker-development, helm-chart-builder, research-summarizer) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat(commands): add /seo-auditor — 7-phase SEO audit pipeline for documentation - 7 phases: discovery → meta tags → content quality → keywords → links → sitemap → report - Integrates 8 marketing-skill scripts: seo_checker, content_scorer, humanizer_scorer, headline_scorer, seo_optimizer, sitemap_analyzer, schema_validator, topic_cluster_mapper - References 6 SEO knowledge bases for audit framework, AI search, content optimization, URL design, internal linking, AI detection - Auto-fixes: generic titles, missing descriptions, broken links, orphan pages - Preserves high-ranking pages — only fixes critical issues on those - Registered in both commands/ (distributable) and .claude/commands/ (local) Also: sync all doc counts — 28 plugins, 26 eng-core skills, 21 commands Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix(seo): fix multi-line YAML description parser, add 2 orphan pages to nav - generate-docs.py: extract_description_from_frontmatter() now handles multi-line YAML block scalars (|, >, indented continuation) — fixes 14 pages that had 56-65 char truncated descriptions - mkdocs.yml: add epic-design and research-summarizer to nav (orphan pages) - Regenerated 251 pages, rebuilt sitemap (278 URLs) - SEO audit: 0 broken links, 17→3 short descriptions, 278/278 pages have "Claude Code Skills" in <title> Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Leo <leo@openclaw.ai> Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223@gmail.com> Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223-alt@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Alireza Rezvani
GitHub
@@ -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"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
97
.claude/commands/seo-auditor.md
Normal file
97
.claude/commands/seo-auditor.md
Normal file
@@ -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.
|
||||
@@ -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": {
|
||||
|
||||
1
.gemini/skills/a11y-audit/SKILL.md
Symbolic link
1
.gemini/skills/a11y-audit/SKILL.md
Symbolic link
@@ -0,0 +1 @@
|
||||
../../../engineering-team/a11y-audit/SKILL.md
|
||||
1
.gemini/skills/cmd-a11y-audit/SKILL.md
Symbolic link
1
.gemini/skills/cmd-a11y-audit/SKILL.md
Symbolic link
@@ -0,0 +1 @@
|
||||
../../../commands/a11y-audit.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
|
||||
|
||||
@@ -149,7 +149,7 @@ See [integrations/](integrations/) for tool-specific documentation and pre-gener
|
||||
|
||||
| Domain | Skills | Highlights | Details |
|
||||
|--------|--------|------------|---------|
|
||||
| **🔧 Engineering — Core** | 25 | Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data, Playwright, self-improving agent, Google Workspace CLI | [engineering-team/](engineering-team/) |
|
||||
| **🔧 Engineering — Core** | 26 | Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data, Playwright, self-improving agent, Google Workspace CLI, a11y audit | [engineering-team/](engineering-team/) |
|
||||
| **🎭 Playwright Pro** | 9+3 | Test generation, flaky fix, Cypress/Selenium migration, TestRail, BrowserStack, 55 templates | [engineering-team/playwright-pro](engineering-team/playwright-pro/) |
|
||||
| **🧠 Self-Improving Agent** | 5+2 | Auto-memory curation, pattern promotion, skill extraction, memory health | [engineering-team/self-improving-agent](engineering-team/self-improving-agent/) |
|
||||
| **⚡ Engineering — POWERFUL** | 30 | Agent designer, RAG architect, database designer, CI/CD builder, security auditor, MCP builder, AgentHub, Helm charts, Terraform | [engineering/](engineering/) |
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
{
|
||||
"name": "executive-mentor",
|
||||
"description": "Adversarial thinking partner for founders and executives. Stress-tests plans, prepares for board meetings, navigates hard decisions, and forces honest post-mortems.",
|
||||
"version": "1.0.0",
|
||||
"version": "2.1.2",
|
||||
"author": {
|
||||
"name": "Alireza Rezvani"
|
||||
},
|
||||
"license": "MIT",
|
||||
"skills": "./"
|
||||
}
|
||||
}
|
||||
340
commands/seo-auditor.md
Normal file
340
commands/seo-auditor.md
Normal file
@@ -0,0 +1,340 @@
|
||||
---
|
||||
name: seo-auditor
|
||||
description: |
|
||||
Scan and optimize documentation files for SEO. Audits README.md files and docs/ pages for
|
||||
meta tags, headings, keywords, readability, duplicate content, and broken links. Applies
|
||||
fixes, updates sitemap.xml, and generates a report. Usage: /seo-auditor [path]
|
||||
---
|
||||
|
||||
# /seo-auditor
|
||||
|
||||
Systematically scan, audit, and optimize documentation files for SEO. Targets README.md files and docs/ pages — fixes issues in place, preserves rankings on high-performing pages, and generates a final report.
|
||||
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
/seo-auditor # Audit all docs/ and root README.md
|
||||
/seo-auditor docs/skills/ # Audit a specific docs subdirectory
|
||||
/seo-auditor --report-only # Scan without making changes
|
||||
```
|
||||
|
||||
## What It Does
|
||||
|
||||
Execute all 7 phases sequentially. Auto-fix non-destructive issues. Preserve existing high-ranking content. Report everything at the end.
|
||||
|
||||
---
|
||||
|
||||
## Phase 1: Discovery & Baseline
|
||||
|
||||
### 1a. Identify target files
|
||||
|
||||
Scan for documentation files that need SEO audit:
|
||||
|
||||
```bash
|
||||
# Find all markdown files in docs/ and root README files
|
||||
find docs/ -name '*.md' -type f | sort
|
||||
find . -maxdepth 2 -name 'README.md' -not -path './.codex/*' -not -path './.gemini/*' | sort
|
||||
```
|
||||
|
||||
Classify each file:
|
||||
- **New/recently modified** — files changed in the last 2 commits (check via `git log`)
|
||||
- **Index pages** — `index.md` files (high authority, handle with care)
|
||||
- **Skill pages** — `docs/skills/**/*.md` (generated by `generate-docs.py`)
|
||||
- **Static pages** — `docs/index.md`, `docs/getting-started.md`, `docs/integrations.md`, etc.
|
||||
- **README files** — root and domain-level README.md
|
||||
|
||||
### 1b. Capture baseline
|
||||
|
||||
For each target file, extract current SEO state:
|
||||
- `title:` frontmatter field → becomes `<title>` tag
|
||||
- `description:` frontmatter field → becomes `<meta name="description">`
|
||||
- First `# H1` heading
|
||||
- All `## H2` and `### H3` subheadings
|
||||
- Word count
|
||||
- Internal link count
|
||||
- External link count
|
||||
|
||||
Store baseline in memory for the report.
|
||||
|
||||
---
|
||||
|
||||
## Phase 2: Meta Tag Audit
|
||||
|
||||
For every file with YAML frontmatter, check and fix:
|
||||
|
||||
### Title Tag (`title:`)
|
||||
|
||||
**Rules:**
|
||||
- Must exist and be non-empty
|
||||
- Length: 50-60 characters ideal (Google truncates at ~60)
|
||||
- Must contain a primary keyword
|
||||
- Must NOT duplicate another page's title
|
||||
- For skill pages: should follow the pattern `{Skill Name} — {Differentiator} - {site_name}`
|
||||
- site_name from `mkdocs.yml` is appended automatically — don't duplicate it in the title
|
||||
|
||||
**Auto-fix:** If title is generic (e.g., just the skill name), enrich it with domain context using the DOMAIN_SEO_SUFFIX pattern from `scripts/generate-docs.py`.
|
||||
|
||||
### Meta Description (`description:`)
|
||||
|
||||
**Rules:**
|
||||
- Must exist and be non-empty
|
||||
- Length: 120-160 characters (Google truncates at ~160)
|
||||
- Must contain the primary keyword naturally
|
||||
- Must be unique across all pages — no two pages share the same description
|
||||
- Should include a call-to-action or value proposition
|
||||
- Must NOT start with "This page..." or "This document..."
|
||||
|
||||
**Auto-fix:** If description is missing or generic, generate one from the SKILL.md frontmatter description (if available) or from the first paragraph of content. Use the `extract_description_from_frontmatter()` function from `generate-docs.py` as reference.
|
||||
|
||||
### Validation Script
|
||||
|
||||
Run on each file that has HTML output in `site/`:
|
||||
|
||||
```bash
|
||||
python3 marketing-skill/seo-audit/scripts/seo_checker.py --file site/{path}/index.html
|
||||
```
|
||||
|
||||
Parse the score. Flag any page scoring below 60.
|
||||
|
||||
---
|
||||
|
||||
## Phase 3: Content Quality & Readability
|
||||
|
||||
For each target file, analyze and improve:
|
||||
|
||||
### Heading Structure
|
||||
|
||||
**Rules:**
|
||||
- Exactly one `# H1` per page
|
||||
- H2s follow H1, H3s follow H2 — no skipping levels
|
||||
- Headings should contain keywords naturally (not stuffed)
|
||||
- No duplicate headings on the same page
|
||||
|
||||
**Auto-fix:** If heading levels skip (H1 → H3), adjust to proper hierarchy.
|
||||
|
||||
### Readability
|
||||
|
||||
Run the content scorer on each file:
|
||||
|
||||
```bash
|
||||
python3 marketing-skill/content-production/scripts/content_scorer.py {file_path}
|
||||
```
|
||||
|
||||
Check scores for:
|
||||
- **Readability** — aim for score ≥ 70
|
||||
- **Structure** — aim for score ≥ 60
|
||||
- **Engagement** — aim for score ≥ 50
|
||||
|
||||
### Content Quality Rules
|
||||
|
||||
- **Paragraphs:** No single paragraph longer than 5 sentences
|
||||
- **Sentences:** Average sentence length 15-20 words
|
||||
- **Passive voice:** Less than 15% of sentences
|
||||
- **Transition words:** At least 30% of sentences use transitions
|
||||
- **Bullet lists:** Use lists for 3+ items instead of comma-separated inline lists
|
||||
|
||||
### AI Content Detection
|
||||
|
||||
Run the humanizer scorer on non-generated content (README.md files, static pages):
|
||||
|
||||
```bash
|
||||
python3 marketing-skill/content-humanizer/scripts/humanizer_scorer.py {file_path}
|
||||
```
|
||||
|
||||
Flag pages scoring below 50 (too AI-sounding). For these pages, apply voice techniques from `marketing-skill/content-humanizer/references/voice-techniques.md`:
|
||||
- Replace AI clichés ("delve into", "leverage", "it's important to note")
|
||||
- Vary sentence length
|
||||
- Add specific examples instead of generic statements
|
||||
- Use active voice
|
||||
|
||||
**Important:** Only modify content that was recently created or updated. Do NOT rewrite pages that are ranking well — preserve their content.
|
||||
|
||||
---
|
||||
|
||||
## Phase 4: Keyword Optimization
|
||||
|
||||
### 4a. Identify target keywords per page
|
||||
|
||||
Based on the page's purpose and domain:
|
||||
|
||||
| Page Type | Primary Keywords | Secondary Keywords |
|
||||
|-----------|-----------------|-------------------|
|
||||
| Homepage (docs/index.md) | "Claude Code Skills", "agent plugins" | "Codex skills", "Gemini CLI", "OpenClaw" |
|
||||
| Skill pages | Skill name + "Claude Code" | "agent skill", "Codex plugin", domain terms |
|
||||
| Agent pages | Agent name + "AI coding agent" | "Claude Code", "orchestrator" |
|
||||
| Command pages | Command name + "slash command" | "Claude Code", "AI coding" |
|
||||
| Getting started | "install Claude Code skills" | platform names |
|
||||
| Domain index | Domain + "skills" + "plugins" | "Claude Code", platform names |
|
||||
|
||||
### 4b. Keyword placement checks
|
||||
|
||||
For each page, verify the primary keyword appears in:
|
||||
- [ ] Title tag (frontmatter `title:`)
|
||||
- [ ] Meta description (frontmatter `description:`)
|
||||
- [ ] H1 heading
|
||||
- [ ] First paragraph (within first 100 words)
|
||||
- [ ] At least one H2 subheading
|
||||
- [ ] Image alt text (if images present)
|
||||
- [ ] URL slug (for new pages only — never change existing URLs)
|
||||
|
||||
### 4c. Keyword density
|
||||
|
||||
- Primary keyword: 1-2% of total word count
|
||||
- Secondary keywords: 0.5-1% each
|
||||
- No keyword stuffing — if density exceeds 3%, reduce it
|
||||
|
||||
**Important:** Never change URLs of existing pages. URL changes break incoming links and destroy rankings. Only optimize content and meta tags.
|
||||
|
||||
---
|
||||
|
||||
## Phase 5: Link Audit
|
||||
|
||||
### 5a. Internal links
|
||||
|
||||
For each target file, check all markdown links `[text](url)`:
|
||||
|
||||
- Verify the target exists (file path resolves)
|
||||
- Check for broken relative links (`../`, `./`)
|
||||
- Verify anchor links (`#section-name`) point to existing headings
|
||||
|
||||
**Auto-fix:** Use the `rewrite_skill_internal_links()` and `rewrite_relative_links()` functions from `generate-docs.py` as reference. Rewrite broken skill-internal links to GitHub source URLs.
|
||||
|
||||
### 5b. Duplicate content detection
|
||||
|
||||
Compare meta descriptions across all pages:
|
||||
|
||||
```bash
|
||||
grep -rh '^description:' docs/**/*.md | sort | uniq -d
|
||||
```
|
||||
|
||||
If duplicates found, make each description unique by adding page-specific context.
|
||||
|
||||
Compare H1 headings across all pages — no two pages should have the same H1.
|
||||
|
||||
### 5c. Orphan page detection
|
||||
|
||||
Check if every page in `docs/` is referenced in `mkdocs.yml` nav. Pages not in nav are orphans — they won't appear in navigation and may not be indexed.
|
||||
|
||||
```bash
|
||||
# Find doc pages not in mkdocs nav
|
||||
find docs -name '*.md' -not -name 'index.md' | while read f; do
|
||||
slug=$(echo "$f" | sed 's|docs/||')
|
||||
grep -q "$slug" mkdocs.yml || echo "ORPHAN: $f"
|
||||
done
|
||||
```
|
||||
|
||||
**Auto-fix:** Add orphan pages to the correct nav section in `mkdocs.yml`.
|
||||
|
||||
---
|
||||
|
||||
## Phase 6: Sitemap & Build
|
||||
|
||||
### 6a. Rebuild the site
|
||||
|
||||
```bash
|
||||
mkdocs build
|
||||
```
|
||||
|
||||
This regenerates `site/sitemap.xml` automatically (MkDocs Material generates it during build).
|
||||
|
||||
### 6b. Verify sitemap
|
||||
|
||||
Check the generated sitemap:
|
||||
|
||||
```bash
|
||||
python3 marketing-skill/site-architecture/scripts/sitemap_analyzer.py site/sitemap.xml
|
||||
```
|
||||
|
||||
Verify:
|
||||
- All documentation pages appear in the sitemap
|
||||
- No broken/404 URLs
|
||||
- URL count matches expected page count
|
||||
- Depth distribution is reasonable (no pages deeper than 4 levels)
|
||||
|
||||
### 6c. Check for sitemap issues
|
||||
|
||||
- **Missing pages:** Pages in `mkdocs.yml` nav that don't appear in sitemap
|
||||
- **Extra pages:** Pages in sitemap that aren't in nav (orphans)
|
||||
- **Duplicate URLs:** Same page accessible via multiple URLs
|
||||
|
||||
---
|
||||
|
||||
## Phase 7: Report
|
||||
|
||||
Generate a concise report for the user:
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ SEO AUDITOR REPORT ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ ║
|
||||
║ Pages scanned: {n} ║
|
||||
║ Issues found: {n} ║
|
||||
║ Auto-fixed: {n} ║
|
||||
║ Manual review needed: {n} ║
|
||||
║ ║
|
||||
║ META TAGS ║
|
||||
║ Titles optimized: {n} ║
|
||||
║ Descriptions fixed: {n} ║
|
||||
║ Duplicate titles: {n} → {n} (fixed) ║
|
||||
║ Duplicate descs: {n} → {n} (fixed) ║
|
||||
║ ║
|
||||
║ CONTENT ║
|
||||
║ Readability improved: {n} pages ║
|
||||
║ Heading fixes: {n} ║
|
||||
║ AI score improved: {n} pages ║
|
||||
║ ║
|
||||
║ KEYWORDS ║
|
||||
║ Pages missing primary keyword in title: {n} ║
|
||||
║ Pages missing keyword in description: {n} ║
|
||||
║ Pages with keyword stuffing: {n} ║
|
||||
║ ║
|
||||
║ LINKS ║
|
||||
║ Broken links found: {n} → {n} (fixed) ║
|
||||
║ Orphan pages: {n} → {n} (added to nav) ║
|
||||
║ Duplicate content: {n} → {n} (deduplicated) ║
|
||||
║ ║
|
||||
║ SITEMAP ║
|
||||
║ Total URLs: {n} ║
|
||||
║ Sitemap regenerated: ✅ ║
|
||||
║ ║
|
||||
║ PRESERVED (no changes — ranking well) ║
|
||||
║ {list of pages left untouched} ║
|
||||
║ ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
### Pages to preserve (do NOT modify)
|
||||
|
||||
These pages rank well for their target keywords. Only fix critical issues (broken links, missing meta). Do NOT rewrite content:
|
||||
|
||||
- `docs/index.md` — homepage, ranks for "Claude Code Skills"
|
||||
- `docs/getting-started.md` — installation guide
|
||||
- `docs/integrations.md` — multi-tool support
|
||||
- Any page the user explicitly marks as "preserve"
|
||||
|
||||
---
|
||||
|
||||
## Skill References
|
||||
|
||||
| Tool | Path | Use |
|
||||
|------|------|-----|
|
||||
| SEO Checker | `marketing-skill/seo-audit/scripts/seo_checker.py` | Score HTML pages 0-100 |
|
||||
| Content Scorer | `marketing-skill/content-production/scripts/content_scorer.py` | Score content readability/structure/engagement |
|
||||
| Humanizer Scorer | `marketing-skill/content-humanizer/scripts/humanizer_scorer.py` | Detect AI-sounding content |
|
||||
| Headline Scorer | `marketing-skill/copywriting/scripts/headline_scorer.py` | Score title quality |
|
||||
| SEO Optimizer | `marketing-skill/content-production/scripts/seo_optimizer.py` | Optimize content for target keyword |
|
||||
| Sitemap Analyzer | `marketing-skill/site-architecture/scripts/sitemap_analyzer.py` | Analyze sitemap structure |
|
||||
| Schema Validator | `marketing-skill/schema-markup/scripts/schema_validator.py` | Validate structured data |
|
||||
| Topic Cluster Mapper | `marketing-skill/content-strategy/scripts/topic_cluster_mapper.py` | Group pages into content clusters |
|
||||
|
||||
### Reference Docs
|
||||
|
||||
| Reference | Path | Use |
|
||||
|-----------|------|-----|
|
||||
| SEO Audit Framework | `marketing-skill/seo-audit/references/seo-audit-reference.md` | Priority order for SEO fixes |
|
||||
| AI Search Optimization | `marketing-skill/ai-seo/references/content-patterns.md` | Make content citable by AI |
|
||||
| Content Optimization | `marketing-skill/content-production/references/optimization-checklist.md` | Pre-publish checklist |
|
||||
| URL Design Guide | `marketing-skill/site-architecture/references/url-design-guide.md` | URL structure best practices |
|
||||
| Internal Linking | `marketing-skill/site-architecture/references/internal-linking-playbook.md` | Internal linking strategy |
|
||||
| AI Writing Detection | `marketing-skill/content-humanizer/references/ai-tells-checklist.md` | AI cliché removal |
|
||||
90
docs/commands/a11y-audit.md
Normal file
90
docs/commands/a11y-audit.md
Normal file
@@ -0,0 +1,90 @@
|
||||
---
|
||||
title: "/a11y-audit — Slash Command for AI Coding Agents"
|
||||
description: "Scan a frontend project for WCAG 2.2 accessibility violations and fix them. Usage: /a11y-audit [path]. Slash command for Claude Code, Codex CLI, Gemini CLI."
|
||||
---
|
||||
|
||||
# /a11y-audit
|
||||
|
||||
<div class="page-meta" markdown>
|
||||
<span class="meta-badge">:material-console: Slash Command</span>
|
||||
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/commands/a11y-audit.md">Source</a></span>
|
||||
</div>
|
||||
|
||||
|
||||
Scan a frontend project for WCAG 2.2 accessibility issues, show fixes, and optionally check color contrast.
|
||||
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
/a11y-audit # Scan current project
|
||||
/a11y-audit ./src # Scan specific directory
|
||||
/a11y-audit ./src --fix # Scan and auto-fix what's possible
|
||||
```
|
||||
|
||||
## What It Does
|
||||
|
||||
### Step 1: Scan
|
||||
|
||||
Run the a11y scanner on the target directory:
|
||||
|
||||
```bash
|
||||
python3 {skill_path}/scripts/a11y_scanner.py {path} --json
|
||||
```
|
||||
|
||||
Parse the JSON output. Group findings by severity (critical → serious → moderate → minor).
|
||||
|
||||
Display a summary:
|
||||
```
|
||||
A11y Audit: ./src
|
||||
Critical: 3 | Serious: 7 | Moderate: 12 | Minor: 5
|
||||
Files scanned: 42 | Files with issues: 15
|
||||
```
|
||||
|
||||
### Step 2: Fix
|
||||
|
||||
For each finding (starting with critical):
|
||||
|
||||
1. Read the affected file
|
||||
2. Show the violation with context (before)
|
||||
3. Apply the fix from `references/framework-a11y-patterns.md`
|
||||
4. Show the result (after)
|
||||
|
||||
**Auto-fixable issues** (apply without asking):
|
||||
- Missing `alt=""` on decorative images
|
||||
- Missing `lang` attribute on `<html>`
|
||||
- `tabindex` values > 0 → set to 0
|
||||
- Missing `type="button"` on non-submit buttons
|
||||
- Outline removal without replacement → add `:focus-visible` styles
|
||||
|
||||
**Issues requiring user input** (show fix, ask to apply):
|
||||
- Missing alt text (need description from user)
|
||||
- Missing form labels (need label text)
|
||||
- Heading restructuring (may affect layout)
|
||||
- ARIA role changes (may affect functionality)
|
||||
|
||||
### Step 3: Contrast Check
|
||||
|
||||
If CSS files are present, run the contrast checker:
|
||||
|
||||
```bash
|
||||
python3 {skill_path}/scripts/contrast_checker.py --batch {path}
|
||||
```
|
||||
|
||||
For each failing color pair, suggest accessible alternatives.
|
||||
|
||||
### Step 4: Report
|
||||
|
||||
Generate a markdown report at `a11y-report.md`:
|
||||
- Executive summary (pass/fail, issue counts)
|
||||
- Per-file findings with before/after diffs
|
||||
- Remaining manual review items
|
||||
- WCAG criteria coverage
|
||||
|
||||
## Skill Reference
|
||||
|
||||
- `engineering-team/a11y-audit/SKILL.md`
|
||||
- `engineering-team/a11y-audit/scripts/a11y_scanner.py`
|
||||
- `engineering-team/a11y-audit/scripts/contrast_checker.py`
|
||||
- `engineering-team/a11y-audit/references/wcag-quick-ref.md`
|
||||
- `engineering-team/a11y-audit/references/aria-patterns.md`
|
||||
- `engineering-team/a11y-audit/references/framework-a11y-patterns.md`
|
||||
@@ -1,18 +1,24 @@
|
||||
---
|
||||
title: "Slash Commands — AI Coding Agent Commands & Codex Shortcuts"
|
||||
description: "19 slash commands for Claude Code, Codex CLI, and Gemini CLI — sprint planning, tech debt analysis, PRDs, OKRs, and more."
|
||||
description: "21 slash commands for Claude Code, Codex CLI, and Gemini CLI — sprint planning, tech debt analysis, PRDs, OKRs, and more."
|
||||
---
|
||||
|
||||
<div class="domain-header" markdown>
|
||||
|
||||
# :material-console: Slash Commands
|
||||
|
||||
<p class="domain-count">19 commands for quick access to common operations</p>
|
||||
<p class="domain-count">21 commands for quick access to common operations</p>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="grid cards" markdown>
|
||||
|
||||
- :material-console:{ .lg .middle } **[`/a11y-audit`](a11y-audit.md)**
|
||||
|
||||
---
|
||||
|
||||
Scan a frontend project for WCAG 2.2 accessibility issues, show fixes, and optionally check color contrast.
|
||||
|
||||
- :material-console:{ .lg .middle } **[`/changelog`](changelog.md)**
|
||||
|
||||
---
|
||||
@@ -97,6 +103,12 @@ description: "19 slash commands for Claude Code, Codex CLI, and Gemini CLI — s
|
||||
|
||||
Calculate SaaS financial health metrics from raw business numbers, benchmark against industry standards, and project ...
|
||||
|
||||
- :material-console:{ .lg .middle } **[`/seo-auditor`](seo-auditor.md)**
|
||||
|
||||
---
|
||||
|
||||
Systematically scan, audit, and optimize documentation files for SEO. Targets README.md files and docs/ pages — fixes...
|
||||
|
||||
- :material-console:{ .lg .middle } **[`/sprint-health`](sprint-health.md)**
|
||||
|
||||
---
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "/plugin-audit — Slash Command for AI Coding Agents"
|
||||
description: "|. Slash command for Claude Code, Codex CLI, Gemini CLI."
|
||||
description: "Comprehensive audit pipeline for skills, plugins, agents, and commands. Validates structure, quality, security, marketplace compliance. Slash command for Claude Code, Codex CLI, Gemini CLI."
|
||||
---
|
||||
|
||||
# /plugin-audit
|
||||
|
||||
343
docs/commands/seo-auditor.md
Normal file
343
docs/commands/seo-auditor.md
Normal file
@@ -0,0 +1,343 @@
|
||||
---
|
||||
title: "/seo-auditor — Slash Command for AI Coding Agents"
|
||||
description: "Scan and optimize documentation files for SEO. Audits README.md files and docs/ pages for meta tags, headings, keywords, readability, duplicate. Slash command for Claude Code, Codex CLI, Gemini CLI."
|
||||
---
|
||||
|
||||
# /seo-auditor
|
||||
|
||||
<div class="page-meta" markdown>
|
||||
<span class="meta-badge">:material-console: Slash Command</span>
|
||||
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/commands/seo-auditor.md">Source</a></span>
|
||||
</div>
|
||||
|
||||
|
||||
Systematically scan, audit, and optimize documentation files for SEO. Targets README.md files and docs/ pages — fixes issues in place, preserves rankings on high-performing pages, and generates a final report.
|
||||
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
/seo-auditor # Audit all docs/ and root README.md
|
||||
/seo-auditor docs/skills/ # Audit a specific docs subdirectory
|
||||
/seo-auditor --report-only # Scan without making changes
|
||||
```
|
||||
|
||||
## What It Does
|
||||
|
||||
Execute all 7 phases sequentially. Auto-fix non-destructive issues. Preserve existing high-ranking content. Report everything at the end.
|
||||
|
||||
---
|
||||
|
||||
## Phase 1: Discovery & Baseline
|
||||
|
||||
### 1a. Identify target files
|
||||
|
||||
Scan for documentation files that need SEO audit:
|
||||
|
||||
```bash
|
||||
# Find all markdown files in docs/ and root README files
|
||||
find docs/ -name '*.md' -type f | sort
|
||||
find . -maxdepth 2 -name 'README.md' -not -path './.codex/*' -not -path './.gemini/*' | sort
|
||||
```
|
||||
|
||||
Classify each file:
|
||||
- **New/recently modified** — files changed in the last 2 commits (check via `git log`)
|
||||
- **Index pages** — `index.md` files (high authority, handle with care)
|
||||
- **Skill pages** — `docs/skills/**/*.md` (generated by `generate-docs.py`)
|
||||
- **Static pages** — `docs/index.md`, `docs/getting-started.md`, `docs/integrations.md`, etc.
|
||||
- **README files** — root and domain-level README.md
|
||||
|
||||
### 1b. Capture baseline
|
||||
|
||||
For each target file, extract current SEO state:
|
||||
- `title:` frontmatter field → becomes `<title>` tag
|
||||
- `description:` frontmatter field → becomes `<meta name="description">`
|
||||
- First `# H1` heading
|
||||
- All `## H2` and `### H3` subheadings
|
||||
- Word count
|
||||
- Internal link count
|
||||
- External link count
|
||||
|
||||
Store baseline in memory for the report.
|
||||
|
||||
---
|
||||
|
||||
## Phase 2: Meta Tag Audit
|
||||
|
||||
For every file with YAML frontmatter, check and fix:
|
||||
|
||||
### Title Tag (`title:`)
|
||||
|
||||
**Rules:**
|
||||
- Must exist and be non-empty
|
||||
- Length: 50-60 characters ideal (Google truncates at ~60)
|
||||
- Must contain a primary keyword
|
||||
- Must NOT duplicate another page's title
|
||||
- For skill pages: should follow the pattern `{Skill Name} — {Differentiator} - {site_name}`
|
||||
- site_name from `mkdocs.yml` is appended automatically — don't duplicate it in the title
|
||||
|
||||
**Auto-fix:** If title is generic (e.g., just the skill name), enrich it with domain context using the DOMAIN_SEO_SUFFIX pattern from `scripts/generate-docs.py`.
|
||||
|
||||
### Meta Description (`description:`)
|
||||
|
||||
**Rules:**
|
||||
- Must exist and be non-empty
|
||||
- Length: 120-160 characters (Google truncates at ~160)
|
||||
- Must contain the primary keyword naturally
|
||||
- Must be unique across all pages — no two pages share the same description
|
||||
- Should include a call-to-action or value proposition
|
||||
- Must NOT start with "This page..." or "This document..."
|
||||
|
||||
**Auto-fix:** If description is missing or generic, generate one from the SKILL.md frontmatter description (if available) or from the first paragraph of content. Use the `extract_description_from_frontmatter()` function from `generate-docs.py` as reference.
|
||||
|
||||
### Validation Script
|
||||
|
||||
Run on each file that has HTML output in `site/`:
|
||||
|
||||
```bash
|
||||
python3 marketing-skill/seo-audit/scripts/seo_checker.py --file site/{path}/index.html
|
||||
```
|
||||
|
||||
Parse the score. Flag any page scoring below 60.
|
||||
|
||||
---
|
||||
|
||||
## Phase 3: Content Quality & Readability
|
||||
|
||||
For each target file, analyze and improve:
|
||||
|
||||
### Heading Structure
|
||||
|
||||
**Rules:**
|
||||
- Exactly one `# H1` per page
|
||||
- H2s follow H1, H3s follow H2 — no skipping levels
|
||||
- Headings should contain keywords naturally (not stuffed)
|
||||
- No duplicate headings on the same page
|
||||
|
||||
**Auto-fix:** If heading levels skip (H1 → H3), adjust to proper hierarchy.
|
||||
|
||||
### Readability
|
||||
|
||||
Run the content scorer on each file:
|
||||
|
||||
```bash
|
||||
python3 marketing-skill/content-production/scripts/content_scorer.py {file_path}
|
||||
```
|
||||
|
||||
Check scores for:
|
||||
- **Readability** — aim for score ≥ 70
|
||||
- **Structure** — aim for score ≥ 60
|
||||
- **Engagement** — aim for score ≥ 50
|
||||
|
||||
### Content Quality Rules
|
||||
|
||||
- **Paragraphs:** No single paragraph longer than 5 sentences
|
||||
- **Sentences:** Average sentence length 15-20 words
|
||||
- **Passive voice:** Less than 15% of sentences
|
||||
- **Transition words:** At least 30% of sentences use transitions
|
||||
- **Bullet lists:** Use lists for 3+ items instead of comma-separated inline lists
|
||||
|
||||
### AI Content Detection
|
||||
|
||||
Run the humanizer scorer on non-generated content (README.md files, static pages):
|
||||
|
||||
```bash
|
||||
python3 marketing-skill/content-humanizer/scripts/humanizer_scorer.py {file_path}
|
||||
```
|
||||
|
||||
Flag pages scoring below 50 (too AI-sounding). For these pages, apply voice techniques from `marketing-skill/content-humanizer/references/voice-techniques.md`:
|
||||
- Replace AI clichés ("delve into", "leverage", "it's important to note")
|
||||
- Vary sentence length
|
||||
- Add specific examples instead of generic statements
|
||||
- Use active voice
|
||||
|
||||
**Important:** Only modify content that was recently created or updated. Do NOT rewrite pages that are ranking well — preserve their content.
|
||||
|
||||
---
|
||||
|
||||
## Phase 4: Keyword Optimization
|
||||
|
||||
### 4a. Identify target keywords per page
|
||||
|
||||
Based on the page's purpose and domain:
|
||||
|
||||
| Page Type | Primary Keywords | Secondary Keywords |
|
||||
|-----------|-----------------|-------------------|
|
||||
| Homepage (docs/index.md) | "Claude Code Skills", "agent plugins" | "Codex skills", "Gemini CLI", "OpenClaw" |
|
||||
| Skill pages | Skill name + "Claude Code" | "agent skill", "Codex plugin", domain terms |
|
||||
| Agent pages | Agent name + "AI coding agent" | "Claude Code", "orchestrator" |
|
||||
| Command pages | Command name + "slash command" | "Claude Code", "AI coding" |
|
||||
| Getting started | "install Claude Code skills" | platform names |
|
||||
| Domain index | Domain + "skills" + "plugins" | "Claude Code", platform names |
|
||||
|
||||
### 4b. Keyword placement checks
|
||||
|
||||
For each page, verify the primary keyword appears in:
|
||||
- [ ] Title tag (frontmatter `title:`)
|
||||
- [ ] Meta description (frontmatter `description:`)
|
||||
- [ ] H1 heading
|
||||
- [ ] First paragraph (within first 100 words)
|
||||
- [ ] At least one H2 subheading
|
||||
- [ ] Image alt text (if images present)
|
||||
- [ ] URL slug (for new pages only — never change existing URLs)
|
||||
|
||||
### 4c. Keyword density
|
||||
|
||||
- Primary keyword: 1-2% of total word count
|
||||
- Secondary keywords: 0.5-1% each
|
||||
- No keyword stuffing — if density exceeds 3%, reduce it
|
||||
|
||||
**Important:** Never change URLs of existing pages. URL changes break incoming links and destroy rankings. Only optimize content and meta tags.
|
||||
|
||||
---
|
||||
|
||||
## Phase 5: Link Audit
|
||||
|
||||
### 5a. Internal links
|
||||
|
||||
For each target file, check all markdown links `[text](url)`:
|
||||
|
||||
- Verify the target exists (file path resolves)
|
||||
- Check for broken relative links (`../`, `./`)
|
||||
- Verify anchor links (`#section-name`) point to existing headings
|
||||
|
||||
**Auto-fix:** Use the `rewrite_skill_internal_links()` and `rewrite_relative_links()` functions from `generate-docs.py` as reference. Rewrite broken skill-internal links to GitHub source URLs.
|
||||
|
||||
### 5b. Duplicate content detection
|
||||
|
||||
Compare meta descriptions across all pages:
|
||||
|
||||
```bash
|
||||
grep -rh '^description:' docs/**/*.md | sort | uniq -d
|
||||
```
|
||||
|
||||
If duplicates found, make each description unique by adding page-specific context.
|
||||
|
||||
Compare H1 headings across all pages — no two pages should have the same H1.
|
||||
|
||||
### 5c. Orphan page detection
|
||||
|
||||
Check if every page in `docs/` is referenced in `mkdocs.yml` nav. Pages not in nav are orphans — they won't appear in navigation and may not be indexed.
|
||||
|
||||
```bash
|
||||
# Find doc pages not in mkdocs nav
|
||||
find docs -name '*.md' -not -name 'index.md' | while read f; do
|
||||
slug=$(echo "$f" | sed 's|docs/||')
|
||||
grep -q "$slug" mkdocs.yml || echo "ORPHAN: $f"
|
||||
done
|
||||
```
|
||||
|
||||
**Auto-fix:** Add orphan pages to the correct nav section in `mkdocs.yml`.
|
||||
|
||||
---
|
||||
|
||||
## Phase 6: Sitemap & Build
|
||||
|
||||
### 6a. Rebuild the site
|
||||
|
||||
```bash
|
||||
mkdocs build
|
||||
```
|
||||
|
||||
This regenerates `site/sitemap.xml` automatically (MkDocs Material generates it during build).
|
||||
|
||||
### 6b. Verify sitemap
|
||||
|
||||
Check the generated sitemap:
|
||||
|
||||
```bash
|
||||
python3 marketing-skill/site-architecture/scripts/sitemap_analyzer.py site/sitemap.xml
|
||||
```
|
||||
|
||||
Verify:
|
||||
- All documentation pages appear in the sitemap
|
||||
- No broken/404 URLs
|
||||
- URL count matches expected page count
|
||||
- Depth distribution is reasonable (no pages deeper than 4 levels)
|
||||
|
||||
### 6c. Check for sitemap issues
|
||||
|
||||
- **Missing pages:** Pages in `mkdocs.yml` nav that don't appear in sitemap
|
||||
- **Extra pages:** Pages in sitemap that aren't in nav (orphans)
|
||||
- **Duplicate URLs:** Same page accessible via multiple URLs
|
||||
|
||||
---
|
||||
|
||||
## Phase 7: Report
|
||||
|
||||
Generate a concise report for the user:
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ SEO AUDITOR REPORT ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ ║
|
||||
║ Pages scanned: {n} ║
|
||||
║ Issues found: {n} ║
|
||||
║ Auto-fixed: {n} ║
|
||||
║ Manual review needed: {n} ║
|
||||
║ ║
|
||||
║ META TAGS ║
|
||||
║ Titles optimized: {n} ║
|
||||
║ Descriptions fixed: {n} ║
|
||||
║ Duplicate titles: {n} → {n} (fixed) ║
|
||||
║ Duplicate descs: {n} → {n} (fixed) ║
|
||||
║ ║
|
||||
║ CONTENT ║
|
||||
║ Readability improved: {n} pages ║
|
||||
║ Heading fixes: {n} ║
|
||||
║ AI score improved: {n} pages ║
|
||||
║ ║
|
||||
║ KEYWORDS ║
|
||||
║ Pages missing primary keyword in title: {n} ║
|
||||
║ Pages missing keyword in description: {n} ║
|
||||
║ Pages with keyword stuffing: {n} ║
|
||||
║ ║
|
||||
║ LINKS ║
|
||||
║ Broken links found: {n} → {n} (fixed) ║
|
||||
║ Orphan pages: {n} → {n} (added to nav) ║
|
||||
║ Duplicate content: {n} → {n} (deduplicated) ║
|
||||
║ ║
|
||||
║ SITEMAP ║
|
||||
║ Total URLs: {n} ║
|
||||
║ Sitemap regenerated: ✅ ║
|
||||
║ ║
|
||||
║ PRESERVED (no changes — ranking well) ║
|
||||
║ {list of pages left untouched} ║
|
||||
║ ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
### Pages to preserve (do NOT modify)
|
||||
|
||||
These pages rank well for their target keywords. Only fix critical issues (broken links, missing meta). Do NOT rewrite content:
|
||||
|
||||
- `docs/index.md` — homepage, ranks for "Claude Code Skills"
|
||||
- `docs/getting-started.md` — installation guide
|
||||
- `docs/integrations.md` — multi-tool support
|
||||
- Any page the user explicitly marks as "preserve"
|
||||
|
||||
---
|
||||
|
||||
## Skill References
|
||||
|
||||
| Tool | Path | Use |
|
||||
|------|------|-----|
|
||||
| SEO Checker | `marketing-skill/seo-audit/scripts/seo_checker.py` | Score HTML pages 0-100 |
|
||||
| Content Scorer | `marketing-skill/content-production/scripts/content_scorer.py` | Score content readability/structure/engagement |
|
||||
| Humanizer Scorer | `marketing-skill/content-humanizer/scripts/humanizer_scorer.py` | Detect AI-sounding content |
|
||||
| Headline Scorer | `marketing-skill/copywriting/scripts/headline_scorer.py` | Score title quality |
|
||||
| SEO Optimizer | `marketing-skill/content-production/scripts/seo_optimizer.py` | Optimize content for target keyword |
|
||||
| Sitemap Analyzer | `marketing-skill/site-architecture/scripts/sitemap_analyzer.py` | Analyze sitemap structure |
|
||||
| Schema Validator | `marketing-skill/schema-markup/scripts/schema_validator.py` | Validate structured data |
|
||||
| Topic Cluster Mapper | `marketing-skill/content-strategy/scripts/topic_cluster_mapper.py` | Group pages into content clusters |
|
||||
|
||||
### Reference Docs
|
||||
|
||||
| Reference | Path | Use |
|
||||
|-----------|------|-----|
|
||||
| SEO Audit Framework | `marketing-skill/seo-audit/references/seo-audit-reference.md` | Priority order for SEO fixes |
|
||||
| AI Search Optimization | `marketing-skill/ai-seo/references/content-patterns.md` | Make content citable by AI |
|
||||
| Content Optimization | `marketing-skill/content-production/references/optimization-checklist.md` | Pre-publish checklist |
|
||||
| URL Design Guide | `marketing-skill/site-architecture/references/url-design-guide.md` | URL structure best practices |
|
||||
| Internal Linking | `marketing-skill/site-architecture/references/internal-linking-playbook.md` | Internal linking strategy |
|
||||
| AI Writing Detection | `marketing-skill/content-humanizer/references/ai-tells-checklist.md` | AI cliché removal |
|
||||
@@ -140,7 +140,7 @@ Choose your platform and follow the steps:
|
||||
|
||||
| Bundle | Install Command | Skills |
|
||||
|--------|----------------|--------|
|
||||
| **Engineering Core** | `/plugin install engineering-skills@claude-code-skills` | 25 |
|
||||
| **Engineering Core** | `/plugin install engineering-skills@claude-code-skills` | 26 |
|
||||
| **Engineering POWERFUL** | `/plugin install engineering-advanced-skills@claude-code-skills` | 30 |
|
||||
| **Product** | `/plugin install product-skills@claude-code-skills` | 14 |
|
||||
| **Marketing** | `/plugin install marketing-skills@claude-code-skills` | 43 |
|
||||
|
||||
@@ -89,7 +89,7 @@ hide:
|
||||
|
||||
[:octicons-arrow-right-24: Getting started](getting-started.md)
|
||||
|
||||
- :material-puzzle-outline:{ .lg .middle } **22 Plugins**
|
||||
- :material-puzzle-outline:{ .lg .middle } **28 Plugins**
|
||||
|
||||
---
|
||||
|
||||
@@ -135,7 +135,7 @@ hide:
|
||||
|
||||
Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data engineering, Playwright testing, self-improving agent
|
||||
|
||||
[:octicons-arrow-right-24: 25 skills](skills/engineering-team/)
|
||||
[:octicons-arrow-right-24: 26 skills](skills/engineering-team/)
|
||||
|
||||
- :material-lightning-bolt:{ .lg .middle } **Engineering — Advanced**
|
||||
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
title: "Agent Plugin Marketplace — Codex & OpenClaw Plugins"
|
||||
description: "21 installable agent plugins for Claude Code, Codex CLI, Gemini CLI, and OpenClaw. One-command install for engineering, marketing, product, compliance, and finance skill bundles."
|
||||
description: "28 installable agent plugins for Claude Code, Codex CLI, Gemini CLI, and OpenClaw. One-command install for engineering, marketing, product, compliance, and finance skill bundles."
|
||||
---
|
||||
|
||||
<div class="skills-hero" markdown>
|
||||
|
||||
# Plugins & Marketplace
|
||||
|
||||
**19 installable plugins** — domain bundles and standalone packages distributed via Claude Code plugin registry and ClawHub.
|
||||
**28 installable plugins** — domain bundles and standalone packages distributed via Claude Code plugin registry and ClawHub.
|
||||
|
||||
<p class="skills-hero-sub">Install entire skill domains or individual tools with a single command. Compatible with Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw.</p>
|
||||
|
||||
@@ -19,7 +19,7 @@ description: "21 installable agent plugins for Claude Code, Codex CLI, Gemini CL
|
||||
|
||||
<div class="grid cards" markdown>
|
||||
|
||||
- :material-puzzle-outline:{ .lg .middle } **19 Plugins**
|
||||
- :material-puzzle-outline:{ .lg .middle } **28 Plugins**
|
||||
|
||||
---
|
||||
|
||||
@@ -90,7 +90,7 @@ description: "21 installable agent plugins for Claude Code, Codex CLI, Gemini CL
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph Registry["Plugin Registry"]
|
||||
MP["marketplace.json<br/>19 plugins"]
|
||||
MP["marketplace.json<br/>28 plugins"]
|
||||
end
|
||||
|
||||
subgraph Bundles["Domain Bundles (9)"]
|
||||
|
||||
1373
docs/skills/engineering-team/a11y-audit.md
Normal file
1373
docs/skills/engineering-team/a11y-audit.md
Normal file
File diff suppressed because it is too large
Load Diff
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Epic Design Skill — Agent Skill & Codex Plugin"
|
||||
description: ">. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Build immersive, cinematic 2.5D interactive websites using scroll storytelling, parallax depth, text animations, and premium scroll effects — no. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Epic Design Skill
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
title: "Engineering - Core Skills — Agent Skills & Codex Plugins"
|
||||
description: "40 engineering - core skills — engineering agent skill and Claude Code plugin for code generation, DevOps, architecture, and testing. Works with Claude Code, Codex CLI, Gemini CLI, and OpenClaw."
|
||||
description: "41 engineering - core skills — engineering agent skill and Claude Code plugin for code generation, DevOps, architecture, and testing. Works with Claude Code, Codex CLI, Gemini CLI, and OpenClaw."
|
||||
---
|
||||
|
||||
<div class="domain-header" markdown>
|
||||
|
||||
# :material-code-braces: Engineering - Core
|
||||
|
||||
<p class="domain-count">40 skills in this domain</p>
|
||||
<p class="domain-count">41 skills in this domain</p>
|
||||
|
||||
</div>
|
||||
|
||||
@@ -17,6 +17,12 @@ description: "40 engineering - core skills — engineering agent skill and Claud
|
||||
|
||||
<div class="grid cards" markdown>
|
||||
|
||||
- **[Accessibility Audit](a11y-audit.md)**
|
||||
|
||||
---
|
||||
|
||||
---
|
||||
|
||||
- **[AWS Solution Architect](aws-solution-architect.md)**
|
||||
|
||||
---
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "BrowserStack Integration — Agent Skill & Codex Plugin"
|
||||
description: ">-. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Run tests on BrowserStack. Use when user mentions 'browserstack', 'cross-browser', 'cloud testing', 'browser matrix', 'test on safari', 'test on. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# BrowserStack Integration
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Analyze Test Coverage Gaps — Agent Skill & Codex Plugin"
|
||||
description: ">-. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Analyze test coverage gaps. Use when user says 'test coverage', 'what's not tested', 'coverage gaps', 'missing tests', 'coverage report', or 'what. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Analyze Test Coverage Gaps
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Fix Failing or Flaky Tests — Agent Skill & Codex Plugin"
|
||||
description: ">-. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Fix failing or flaky Playwright tests. Use when user says 'fix test', 'flaky test', 'test failing', 'debug test', 'test broken', 'test passes. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Fix Failing or Flaky Tests
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Generate Playwright Tests — Agent Skill & Codex Plugin"
|
||||
description: ">-. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Generate Playwright tests. Use when user says 'write tests', 'generate tests', 'add tests for', 'test this component', 'e2e test', 'create test for'. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Generate Playwright Tests
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Initialize Playwright Project — Agent Skill & Codex Plugin"
|
||||
description: ">-. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Set up Playwright in a project. Use when user says 'set up playwright', 'add e2e tests', 'configure playwright', 'testing setup', 'init playwright'. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Initialize Playwright Project
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Migrate to Playwright — Agent Skill & Codex Plugin"
|
||||
description: ">-. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Migrate from Cypress or Selenium to Playwright. Use when user mentions 'cypress', 'selenium', 'migrate tests', 'convert tests', 'switch to. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Migrate to Playwright
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Smart Test Reporting — Agent Skill & Codex Plugin"
|
||||
description: ">-. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Generate test report. Use when user says 'test report', 'results summary', 'test status', 'show results', 'test dashboard', or 'how did tests go'. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Smart Test Reporting
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Review Playwright Tests — Agent Skill & Codex Plugin"
|
||||
description: ">-. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Review Playwright tests for quality. Use when user says 'review tests', 'check test quality', 'audit tests', 'improve tests', 'test code review', or. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Review Playwright Tests
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "TestRail Integration — Agent Skill & Codex Plugin"
|
||||
description: ">-. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Sync tests with TestRail. Use when user mentions 'testrail', 'test management', 'test cases', 'test run', 'sync test cases', 'push results to. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# TestRail Integration
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Skill Security Auditor — Agent Skill for Codex & OpenClaw"
|
||||
description: ">. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Security audit and vulnerability scanner for AI agent skills before installation. Use when: (1) evaluating a skill from an untrusted source, (2)."
|
||||
---
|
||||
|
||||
# Skill Security Auditor
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Content Strategy — Agent Skill for Marketing"
|
||||
description: "When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions \. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Content Strategy
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "Code → PRD: Reverse-Engineer Any Codebase into Product Requirements — Agent Skill for Product Teams"
|
||||
description: "|. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
description: "Reverse-engineer any codebase into a complete Product Requirements Document (PRD). Analyzes routes, components, state management, API integrations. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw."
|
||||
---
|
||||
|
||||
# Code → PRD: Reverse-Engineer Any Codebase into Product Requirements
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "engineering-skills",
|
||||
"description": "24 production-ready engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering, Playwright (9 sub-skills), self-improving agent, Stripe integration, TDD guide, Google Workspace CLI, and more. Agent skill and plugin for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw.",
|
||||
"description": "26 production-ready engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering, Playwright (9 sub-skills), self-improving agent, Stripe integration, TDD guide, Google Workspace CLI, a11y audit (WCAG 2.2), and more. Agent skill and plugin for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw.",
|
||||
"version": "2.1.2",
|
||||
"author": {
|
||||
"name": "Alireza Rezvani",
|
||||
|
||||
@@ -1,20 +1,21 @@
|
||||
# Engineering Team Skills - Claude Code Guidance
|
||||
|
||||
This guide covers the 24 production-ready engineering skills and their Python automation tools.
|
||||
This guide covers the 26 production-ready engineering skills and their Python automation tools.
|
||||
|
||||
## Engineering Skills Overview
|
||||
|
||||
**Core Engineering (14 skills):**
|
||||
**Core Engineering (16 skills):**
|
||||
- senior-architect, senior-frontend, senior-backend, senior-fullstack
|
||||
- senior-qa, senior-devops, senior-secops
|
||||
- code-reviewer, senior-security
|
||||
- aws-solution-architect, ms365-tenant-manager, google-workspace-cli, tdd-guide, tech-stack-evaluator, epic-design
|
||||
- **a11y-audit** — WCAG 2.2 accessibility audit and fix (a11y_scanner.py, contrast_checker.py)
|
||||
|
||||
**AI/ML/Data (5 skills):**
|
||||
- senior-data-scientist, senior-data-engineer, senior-ml-engineer
|
||||
- senior-prompt-engineer, senior-computer-vision
|
||||
|
||||
**Total Tools:** 32+ Python automation tools
|
||||
**Total Tools:** 34+ Python automation tools
|
||||
|
||||
## Core Engineering Tools
|
||||
|
||||
@@ -287,9 +288,9 @@ services:
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** March 13, 2026
|
||||
**Skills Deployed:** 25 engineering skills production-ready
|
||||
**Total Tools:** 37+ Python automation tools across core + AI/ML/Data + epic-design
|
||||
**Last Updated:** March 18, 2026
|
||||
**Skills Deployed:** 26 engineering skills production-ready
|
||||
**Total Tools:** 39+ Python automation tools across core + AI/ML/Data + epic-design + a11y
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "docker-development",
|
||||
"description": "Docker and container development agent skill and plugin for Dockerfile optimization, docker-compose orchestration, multi-stage builds, and container security hardening. Covers build performance, layer caching, and production-ready container patterns.",
|
||||
"version": "1.0.0",
|
||||
"version": "2.1.2",
|
||||
"author": {
|
||||
"name": "Alireza Rezvani",
|
||||
"url": "https://alirezarezvani.com"
|
||||
@@ -10,4 +10,4 @@
|
||||
"repository": "https://github.com/alirezarezvani/claude-skills",
|
||||
"license": "MIT",
|
||||
"skills": "./"
|
||||
}
|
||||
}
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "helm-chart-builder",
|
||||
"description": "Helm chart development agent skill and plugin for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw — chart scaffolding, values design, template patterns, dependency management, security hardening, and chart testing.",
|
||||
"version": "1.0.0",
|
||||
"description": "Helm chart development agent skill and plugin for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw \u2014 chart scaffolding, values design, template patterns, dependency management, security hardening, and chart testing.",
|
||||
"version": "2.1.2",
|
||||
"author": {
|
||||
"name": "Alireza Rezvani",
|
||||
"url": "https://alirezarezvani.com"
|
||||
@@ -10,4 +10,4 @@
|
||||
"repository": "https://github.com/alirezarezvani/claude-skills",
|
||||
"license": "MIT",
|
||||
"skills": "./"
|
||||
}
|
||||
}
|
||||
@@ -120,6 +120,7 @@ nav:
|
||||
- Overview: skills/index.md
|
||||
- Engineering - Core:
|
||||
- Overview: skills/engineering-team/index.md
|
||||
- "A11y Audit": skills/engineering-team/a11y-audit.md
|
||||
- "AWS Solution Architect": skills/engineering-team/aws-solution-architect.md
|
||||
- "Code Reviewer": skills/engineering-team/code-reviewer.md
|
||||
- "Email Template Builder": skills/engineering-team/email-template-builder.md
|
||||
@@ -160,6 +161,7 @@ nav:
|
||||
- "Stripe Integration Expert": skills/engineering-team/stripe-integration-expert.md
|
||||
- "TDD Guide": skills/engineering-team/tdd-guide.md
|
||||
- "Tech Stack Evaluator": skills/engineering-team/tech-stack-evaluator.md
|
||||
- "Epic Design": skills/engineering-team/epic-design.md
|
||||
- Engineering - POWERFUL:
|
||||
- Overview: skills/engineering/index.md
|
||||
- "Autoresearch Agent": skills/engineering/autoresearch-agent.md
|
||||
@@ -216,6 +218,7 @@ nav:
|
||||
- "Product Discovery": skills/product-team/product-discovery.md
|
||||
- "Product Manager Toolkit": skills/product-team/product-manager-toolkit.md
|
||||
- "Product Strategist": skills/product-team/product-strategist.md
|
||||
- "Research Summarizer": skills/product-team/research-summarizer.md
|
||||
- "Roadmap Communicator": skills/product-team/roadmap-communicator.md
|
||||
- "SaaS Scaffolder": skills/product-team/saas-scaffolder.md
|
||||
- "UI Design System": skills/product-team/ui-design-system.md
|
||||
@@ -364,6 +367,7 @@ nav:
|
||||
- "CS UX Researcher": agents/cs-ux-researcher.md
|
||||
- Commands:
|
||||
- Overview: commands/index.md
|
||||
- "/a11y-audit": commands/a11y-audit.md
|
||||
- "/changelog": commands/changelog.md
|
||||
- "/code-to-prd": commands/code-to-prd.md
|
||||
- "/competitive-matrix": commands/competitive-matrix.md
|
||||
@@ -376,6 +380,7 @@ nav:
|
||||
- "/project-health": commands/project-health.md
|
||||
- "/retro": commands/retro.md
|
||||
- "/rice": commands/rice.md
|
||||
- "/seo-auditor": commands/seo-auditor.md
|
||||
- "/saas-health": commands/saas-health.md
|
||||
- "/sprint-health": commands/sprint-health.md
|
||||
- "/sprint-plan": commands/sprint-plan.md
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "research-summarizer",
|
||||
"description": "Structured research summarization agent skill and plugin for Claude Code, Codex, and Gemini CLI. Summarize academic papers, compare web articles, extract citations, and produce actionable research briefs.",
|
||||
"version": "1.0.0",
|
||||
"version": "2.1.2",
|
||||
"author": {
|
||||
"name": "Alireza Rezvani",
|
||||
"url": "https://alirezarezvani.com"
|
||||
@@ -10,4 +10,4 @@
|
||||
"repository": "https://github.com/alirezarezvani/claude-skills",
|
||||
"license": "MIT",
|
||||
"skills": "./"
|
||||
}
|
||||
}
|
||||
@@ -105,16 +105,37 @@ def extract_subtitle(filepath):
|
||||
|
||||
|
||||
def extract_description_from_frontmatter(filepath):
|
||||
"""Extract the description field from YAML frontmatter."""
|
||||
"""Extract the description field from YAML frontmatter.
|
||||
|
||||
Handles single-line, quoted, and multi-line (| or >) YAML descriptions.
|
||||
"""
|
||||
try:
|
||||
with open(filepath, "r", encoding="utf-8") as f:
|
||||
content = f.read()
|
||||
match = re.match(r"^---\n(.*?)---\n", content, re.DOTALL)
|
||||
if match:
|
||||
fm = match.group(1)
|
||||
desc_match = re.search(r'description:\s*["\']?(.*?)["\']?\s*$', fm, re.MULTILINE)
|
||||
if desc_match:
|
||||
return desc_match.group(1).strip()
|
||||
if not match:
|
||||
return None
|
||||
fm = match.group(1)
|
||||
|
||||
# Try quoted single-line: description: "text" or description: 'text'
|
||||
m = re.search(r'description:\s*"([^"]+)"', fm)
|
||||
if m:
|
||||
return m.group(1).strip()
|
||||
m = re.search(r"description:\s*'([^']+)'", fm)
|
||||
if m:
|
||||
return m.group(1).strip()
|
||||
|
||||
# Try multi-line block scalar: description: | or description: >
|
||||
m = re.search(r"description:\s*[|>]-?\s*\n((?:[ \t]+.+\n?)+)", fm)
|
||||
if m:
|
||||
lines = m.group(1).strip().splitlines()
|
||||
text = " ".join(line.strip() for line in lines)
|
||||
return text
|
||||
|
||||
# Try unquoted single-line: description: text
|
||||
m = re.search(r"description:\s+([^\n\"'][^\n]+)", fm)
|
||||
if m:
|
||||
return m.group(1).strip()
|
||||
except Exception:
|
||||
pass
|
||||
return None
|
||||
|
||||
Reference in New Issue
Block a user