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/repo_docs_site_checker.py

View on GitHub
#!/usr/bin/env python3
"""Check repository homepage/docs URLs and install CTA paths."""

from __future__ import annotations

import argparse
import os
import re
from urllib.parse import urlparse

from github_api import auth_context, fetch_json, get_token, resolve_repo
from seo_common import fetch_url, print_json_or_text


URL_RE = re.compile(r"https?://[^\s)\]\"'>]+")


def _readme_urls(path: str) -> list[str]:
    readme = os.path.join(path, "README.md")
    if not os.path.exists(readme):
        return []
    text = open(readme, "r", encoding="utf-8", errors="replace").read()
    return sorted(set(URL_RE.findall(text)))


def _readme_install_cta(path: str) -> dict:
    readme = os.path.join(path, "README.md")
    if not os.path.exists(readme):
        return {"present": False, "install_mentions": 0, "quickstart_mentions": 0, "code_blocks": 0}
    text = open(readme, "r", encoding="utf-8", errors="replace").read()
    lower = text.lower()
    return {
        "present": True,
        "install_mentions": lower.count("install"),
        "quickstart_mentions": lower.count("quickstart"),
        "code_blocks": text.count("```"),
    }


def _check_url(url: str, timeout: int) -> dict:
    fetched = fetch_url(url, timeout=timeout, max_bytes=1_000_000)
    return {
        "url": url,
        "status": fetched.get("status"),
        "final_url": fetched.get("url"),
        "redirect_chain": fetched.get("redirect_chain", []),
        "error": fetched.get("error"),
        "title_present": "<title" in (fetched.get("text") or "").lower(),
        "meta_description_present": 'name="description"' in (fetched.get("text") or "").lower() or "name='description'" in (fetched.get("text") or "").lower(),
    }


def check_docs_site(repo: str | None = None, path: str = ".", token: str = "", provider: str = "auto", homepage: str | None = None, timeout: int = 15, max_urls: int = 10) -> dict:
    ctx = auth_context(token=token)
    limitations = []
    metadata = {}
    resolved_repo = ""
    try:
        resolved_repo = resolve_repo(repo, cwd=path)
        payload = fetch_json(f"/repos/{resolved_repo}", token=token, provider=provider)
        metadata = payload.get("data") or {}
    except Exception as exc:
        limitations.append(f"GitHub metadata unavailable: {exc}")

    candidate_urls = []
    if homepage:
        candidate_urls.append(homepage)
    if metadata.get("homepage"):
        candidate_urls.append(metadata["homepage"])
    if resolved_repo:
        owner, name = resolved_repo.split("/", 1)
        candidate_urls.extend([f"https://{owner}.github.io/{name}/", f"https://github.com/{resolved_repo}#readme"])
    for url in _readme_urls(path):
        host = urlparse(url).netloc.lower()
        if any(token in host for token in ("github.io", "readthedocs.io", "docs.", "pages.dev", "vercel.app", "netlify.app")):
            candidate_urls.append(url)

    deduped = []
    seen = set()
    for url in candidate_urls:
        cleaned = url.rstrip(".,")
        if cleaned and cleaned not in seen:
            seen.add(cleaned)
            deduped.append(cleaned)

    checks = [_check_url(url, timeout=timeout) for url in deduped[:max_urls]]
    readme_cta = _readme_install_cta(path)
    issues = []
    live_docs = [row for row in checks if row.get("status") and row["status"] < 400]
    if not checks:
        issues.append({"severity": "warning", "type": "no_docs_url", "message": "No homepage/docs URL was discovered"})
    elif not live_docs:
        issues.append({"severity": "warning", "type": "docs_unavailable", "message": "No checked docs/homepage URL returned a live status"})
    if readme_cta["present"] and readme_cta["install_mentions"] == 0:
        issues.append({"severity": "warning", "type": "missing_install_cta", "message": "README does not clearly mention installation"})
    if any(row.get("status") and row["status"] >= 400 for row in checks):
        issues.append({"severity": "warning", "type": "broken_docs_url", "message": "At least one docs/homepage URL returned 4xx/5xx"})

    score = 100 - 20 * len([i for i in issues if i["severity"] == "warning"])
    return {
        "repo": resolved_repo or repo or "",
        "auth_context": ctx,
        "metadata": {"homepage": metadata.get("homepage"), "description": metadata.get("description")},
        "summary": {"score": max(0, score), "urls_checked": len(checks), "live_urls": len(live_docs)},
        "readme_install_cta": readme_cta,
        "url_checks": checks,
        "issues": issues,
        "limitations": limitations,
    }


def main() -> None:
    parser = argparse.ArgumentParser(description="Check repository docs/homepage URLs and install CTA")
    parser.add_argument("--repo", help="Repository slug or URL (defaults to local git origin)")
    parser.add_argument("--path", default=".", help="Local repository path")
    parser.add_argument("--homepage", help="Explicit homepage/docs URL")
    parser.add_argument("--token", help="GitHub token override")
    parser.add_argument("--provider", choices=["auto", "api", "gh"], default="auto")
    parser.add_argument("--timeout", type=int, default=15)
    parser.add_argument("--json", "-j", action="store_true", help="Output JSON")
    args = parser.parse_args()

    result = check_docs_site(args.repo, path=args.path, token=get_token(args.token), provider=args.provider, homepage=args.homepage, timeout=args.timeout)
    lines = [
        f"Docs site check for {result['repo'] or args.path}",
        f"Score: {result['summary']['score']}  URLs checked: {result['summary']['urls_checked']}  Live: {result['summary']['live_urls']}",
    ]
    lines.extend(f"[{issue['severity']}] {issue['message']}" for issue in result["issues"])
    lines.extend(f"Limitation: {item}" for item in result["limitations"])
    print_json_or_text(result, args.json, lines)


if __name__ == "__main__":
    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