Skip to content

Bhanunamikaze/Agentic-SEO-Skill

Deterministic LLM-first SEO audits for websites, blog posts, and GitHub repositories. Use this when the user asks to "perform SEO analysis", "run SEO audit", "analyze SEO", "check technical SEO", "review schema", "Core Web Vitals", "E-E-A-T", "hreflang", "GEO", "AEO", or GitHub repository SEO optimization. For full/page/repo audits, run bundled scripts for evidence and return prioritized, confidence-labeled fixes.

FileKindSize
SKILL.mdskill md19.4 KB
scripts/__init__.pyscript34 B
scripts/a11y_seo_checker.pyscript3.4 KB
scripts/ai_crawler_policy_matrix.pyscript2.2 KB
scripts/analyze_visual.pyexecutablescript6.5 KB
scripts/anchor_text_audit.pyscript7.7 KB
scripts/answer_block_scanner.pyscript3.9 KB
scripts/article_seo.pyscript27.1 KB
scripts/audit_runner.pyscript3.1 KB
scripts/broken_links.pyscript8.3 KB
scripts/cache_compression_checker.pyscript6.7 KB
scripts/canonical_checker.pyscript3.4 KB
scripts/capture_screenshot.pyexecutablescript4.4 KB
scripts/citation_readiness.pyscript5.1 KB
scripts/collection_page_checker.pyscript4.2 KB
scripts/competitor_gap.pyscript10.2 KB
scripts/content_decay_detector.pyscript6.2 KB
scripts/content_intent_matcher.pyscript5.4 KB
scripts/crawl_audit.pyscript7.2 KB
scripts/critical_request_chain.pyscript4.8 KB
scripts/duplicate_content.pyscript14.0 KB
scripts/eeat_signal_checker.pyscript5.5 KB
scripts/entity_checker.pyscript19.4 KB
scripts/env_loader.pyscript3.6 KB
scripts/external_link_quality.pyscript6.6 KB
scripts/faceted_nav_audit.pyscript3.3 KB
scripts/fetch_page.pyexecutablescript3.6 KB
scripts/finding_verifier.pyscript4.9 KB
scripts/font_audit.pyscript5.9 KB
scripts/freshness_checker.pyscript6.2 KB
scripts/generate_report.pyscript80.7 KB
scripts/github_api.pyscript12.8 KB
scripts/github_community_health.pyscript8.9 KB
scripts/github_competitor_research.pyscript17.2 KB
scripts/github_readme_lint.pyscript14.9 KB
scripts/github_repo_audit.pyscript21.0 KB
scripts/github_search_benchmark.pyscript7.7 KB
scripts/github_seo_report.pyscript32.0 KB
scripts/github_traffic_archiver.pyscript6.3 KB
scripts/github_weekly_scorecard.pyscript4.4 KB
scripts/gsc_checker.pyscript11.4 KB
scripts/hreflang_checker.pyscript24.2 KB
scripts/hreflang_sitemap_validator.pyscript6.4 KB
scripts/image_inventory.pyscript2.8 KB
scripts/image_weight_audit.pyscript4.8 KB
scripts/indexability_matrix.pyscript3.5 KB
scripts/indexnow_checker.pyscript9.4 KB
scripts/internal_links.pyscript10.5 KB
scripts/javascript_render_audit.pyscript2.9 KB
scripts/lcp_subparts.pyscript7.3 KB
scripts/lib/__init__.pyscript46 B
scripts/lib/safe_http.pyscript6.1 KB
scripts/lighthouse_runner.pyscript6.0 KB
scripts/link_profile.pyscript12.5 KB
scripts/llms_txt_checker.pyscript7.5 KB
scripts/llms_txt_generator.pyscript2.9 KB
scripts/local_seo_checker.pyscript3.7 KB
scripts/log_file_analyzer.pyscript6.0 KB
scripts/mobile_render_checker.pyscript6.9 KB
scripts/orphan_pages_from_sitemap.pyscript6.2 KB
scripts/pagespeed.pyscript12.9 KB
scripts/parse_html.pyexecutablescript12.2 KB
scripts/pre_commit_seo_check.shexecutablescript2.9 KB
scripts/product_schema_checker.pyscript4.9 KB
scripts/readability.pyscript14.5 KB
scripts/redirect_backlink_reclaim.pyscript5.7 KB
scripts/redirect_checker.pyscript6.2 KB
scripts/reference_freshness.pyexecutablescript2.9 KB
scripts/repo_docs_site_checker.pyscript5.7 KB
scripts/repo_file_inventory.pyscript3.6 KB
scripts/repo_release_seo.pyscript6.6 KB
scripts/repo_social_preview_checker.pyscript4.1 KB
scripts/repo_topic_suggester.pyscript6.3 KB
scripts/review_schema_checker.pyscript4.0 KB
scripts/rich_results_guard.pyscript3.4 KB
scripts/robots_checker.pyscript7.2 KB
scripts/robots_path_tester.pyscript1.8 KB
scripts/schema_diff.pyscript3.1 KB
scripts/schema_required_props.pyscript8.1 KB
scripts/schema_template_generator.pyscript5.4 KB
scripts/security_headers.pyscript6.8 KB
scripts/seo_common.pyscript14.1 KB
scripts/sitemap_checker.pyscript6.5 KB
scripts/sitemap_generator.pyscript3.4 KB
scripts/social_meta.pyscript8.7 KB
scripts/third_party_script_audit.pyscript4.7 KB
scripts/topical_cluster_mapper.pyscript6.4 KB
scripts/url_quality.pyscript2.5 KB
scripts/validate_schema.pyexecutablescript4.3 KB
scripts/validate_skill_inventory.pyexecutablescript4.8 KB
scripts/video_schema_checker.pyscript3.6 KB
scripts/visual_regression_snapshot.pyscript5.3 KB
scripts/x_robots_header_checker.pyscript2.0 KB

scripts/mobile_render_checker.py

View on GitHub
#!/usr/bin/env python3
"""Check mobile rendering risks with static HTML plus optional Playwright signals."""

from __future__ import annotations

import argparse
import json
import re
import sys

try:
    from seo_common import load_html, parse_html
except ImportError:
    from scripts.seo_common import load_html, parse_html

try:
    from playwright.sync_api import sync_playwright, TimeoutError as PlaywrightTimeout
except ImportError:  # pragma: no cover - optional dependency
    sync_playwright = None
    PlaywrightTimeout = TimeoutError


def _static_checks(source: str, timeout: int = 15) -> dict:
    html, final_url, fetched = load_html(source, timeout=timeout)
    parsed = parse_html(html, final_url)
    viewport = (parsed.get("meta") or {}).get("viewport", "")
    text = re.sub(r"\s+", " ", html or "")

    issues = []
    if "width=device-width" not in viewport.lower():
        issues.append({
            "severity": "critical",
            "finding": "Missing or incomplete viewport meta tag.",
            "fix": "Add `<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">`.",
        })

    fixed_width_hits = re.findall(r"(?:width|min-width)\s*:\s*(\d{3,})px", text, flags=re.I)
    wide_values = [int(value) for value in fixed_width_hits if int(value) > 390]
    if wide_values:
        issues.append({
            "severity": "warning",
            "finding": f"Found {len(wide_values)} fixed-width CSS declarations wider than common mobile viewports.",
            "fix": "Replace fixed widths with responsive max-width, min(), clamp(), grid, or flex constraints.",
        })

    sticky_hits = len(re.findall(r"position\s*:\s*(fixed|sticky)", text, flags=re.I))
    if sticky_hits:
        issues.append({
            "severity": "info",
            "finding": f"Found {sticky_hits} fixed/sticky positioning declaration(s).",
            "fix": "Verify sticky headers, banners, and chat widgets do not cover mobile content or CTAs.",
        })

    return {
        "source": source,
        "url": final_url or source,
        "fetch": fetched,
        "viewport_meta": viewport,
        "fixed_width_values": wide_values[:25],
        "sticky_position_count": sticky_hits,
        "rendered": None,
        "issues": issues,
    }


def _rendered_checks(url: str, timeout_ms: int) -> dict:
    if sync_playwright is None:
        return {"available": False, "error": "playwright is not installed"}

    try:
        with sync_playwright() as p:
            browser = p.chromium.launch(headless=True)
            page = browser.new_page(viewport={"width": 390, "height": 844}, device_scale_factor=2)
            page.goto(url, wait_until="networkidle", timeout=timeout_ms)
            metrics = page.evaluate(
                """() => {
                    const doc = document.documentElement;
                    const body = document.body;
                    const links = [...document.querySelectorAll('a,button,input,select,textarea')];
                    const smallTargets = links.map((el) => {
                        const r = el.getBoundingClientRect();
                        return {text: (el.innerText || el.value || el.ariaLabel || '').trim().slice(0, 80), width: r.width, height: r.height};
                    }).filter((r) => r.width > 0 && r.height > 0 && (r.width < 44 || r.height < 44)).slice(0, 20);
                    const clippedText = [...document.querySelectorAll('h1,h2,h3,p,a,button,li')]
                        .filter((el) => el.scrollWidth > el.clientWidth + 1 || el.scrollHeight > el.clientHeight + 1)
                        .map((el) => ({tag: el.tagName.toLowerCase(), text: el.innerText.trim().slice(0, 120)}))
                        .slice(0, 20);
                    return {
                        viewportWidth: window.innerWidth,
                        scrollWidth: doc.scrollWidth,
                        horizontalScroll: doc.scrollWidth > window.innerWidth + 1,
                        bodyHeight: body ? body.scrollHeight : 0,
                        smallTargets,
                        clippedText
                    };
                }"""
            )
            browser.close()
            return {"available": True, **metrics}
    except PlaywrightTimeout:
        return {"available": True, "error": f"render timed out after {timeout_ms}ms"}
    except Exception as exc:  # pragma: no cover - browser/runtime dependent
        return {"available": True, "error": str(exc)}


def check_mobile_render(source: str, render: bool = False, timeout: int = 15) -> dict:
    report = _static_checks(source, timeout=timeout)
    is_url = bool(re.match(r"^https?://", source, re.I))
    if render and is_url:
        rendered = _rendered_checks(source, timeout * 1000)
        report["rendered"] = rendered
        if rendered.get("horizontalScroll"):
            report["issues"].append({
                "severity": "critical",
                "finding": "Rendered mobile page has horizontal scroll.",
                "fix": "Identify overflowing containers at 390px width and constrain media, tables, nav, and code blocks.",
            })
        if rendered.get("smallTargets"):
            report["issues"].append({
                "severity": "warning",
                "finding": f"{len(rendered['smallTargets'])} tap target(s) are smaller than 44px.",
                "fix": "Increase touch target size and spacing for mobile navigation and controls.",
            })
        if rendered.get("clippedText"):
            report["issues"].append({
                "severity": "warning",
                "finding": f"{len(rendered['clippedText'])} text element(s) appear clipped or overflowing.",
                "fix": "Allow wrapping, adjust line-height, or reduce container constraints on mobile.",
            })
    elif render and not is_url:
        report["rendered"] = {"available": False, "error": "render mode requires a URL"}

    report["summary"] = {
        "issues": len(report["issues"]),
        "critical": sum(1 for issue in report["issues"] if issue["severity"] == "critical"),
        "warning": sum(1 for issue in report["issues"] if issue["severity"] == "warning"),
    }
    return report


def main() -> int:
    parser = argparse.ArgumentParser(description="Check mobile rendering risks")
    parser.add_argument("source", help="URL or local HTML file")
    parser.add_argument("--render", action="store_true", help="Use Playwright for rendered mobile checks when source is a URL")
    parser.add_argument("--timeout", type=int, default=15)
    parser.add_argument("--json", "-j", action="store_true")
    args = parser.parse_args()

    report = check_mobile_render(args.source, render=args.render, timeout=args.timeout)
    if args.json:
        print(json.dumps(report, indent=2))
    else:
        print(f"Mobile render issues: {report['summary']['issues']}")
        for issue in report["issues"]:
            print(f"- [{issue['severity']}] {issue['finding']}")
    return 0


if __name__ == "__main__":
    sys.exit(main())
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall