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

View on GitHub
#!/usr/bin/env python3
"""Generate JSON-LD templates from bundled schema templates."""

from __future__ import annotations

import argparse
import json
from copy import deepcopy
from pathlib import Path
from typing import Any

from schema_required_props import load_source_html
from seo_common import parse_html, print_json_or_text


TEMPLATE_PATH = Path(__file__).resolve().parents[1] / "resources" / "schema" / "templates.json"

FALLBACK_TEMPLATES: dict[str, dict[str, Any]] = {
    "Product": {
        "type": "Product",
        "description": "Standard ecommerce product page with Offer, product identifiers, images, and rating/review hooks.",
        "template": {
            "@context": "https://schema.org",
            "@type": "Product",
            "name": "[Product Name]",
            "description": "[Product Description]",
            "image": ["[Product Image URL]"],
            "sku": "[SKU]",
            "brand": {"@type": "Brand", "name": "[Brand Name]"},
            "offers": {
                "@type": "Offer",
                "url": "[Product URL]",
                "price": "[Price]",
                "priceCurrency": "USD",
                "availability": "https://schema.org/InStock",
            },
        },
    },
    "Review": {
        "type": "Review",
        "description": "Review markup for first-party or editorial reviews with rating and reviewed entity.",
        "template": {
            "@context": "https://schema.org",
            "@type": "Review",
            "itemReviewed": {"@type": "Thing", "name": "[Reviewed Item]"},
            "reviewRating": {"@type": "Rating", "ratingValue": "[1-5]", "bestRating": "5", "worstRating": "1"},
            "author": {"@type": "Person", "name": "[Reviewer Name]"},
            "reviewBody": "[Review text]",
            "datePublished": "[YYYY-MM-DD]",
        },
    },
}


def load_templates(path: Path = TEMPLATE_PATH) -> dict[str, dict[str, Any]]:
    with open(path, "r", encoding="utf-8") as fh:
        data = json.load(fh)
    templates = {item["type"]: item for item in data.get("templates", [])}
    templates.update({key: value for key, value in FALLBACK_TEMPLATES.items() if key not in templates})
    return templates


def detect_template_type(source: str, timeout: int = 15) -> str:
    html, final_url, _ = load_source_html(source, timeout=timeout)
    parsed = parse_html(html, final_url or source) if html else {}
    text = " ".join(
        [
            parsed.get("title") or "",
            parsed.get("meta_description") or "",
            " ".join(parsed.get("headings", {}).get("h1", [])),
        ]
    ).lower()
    schema_types = []
    for doc in parsed.get("schema", []):
        if isinstance(doc, dict):
            value = doc.get("@type")
            schema_types.extend(value if isinstance(value, list) else [value])
    for type_name in schema_types:
        if type_name in load_templates():
            return type_name
    if any(word in text for word in ("video", "webinar", "watch")):
        return "VideoObject"
    if any(word in text for word in ("product", "price", "buy", "cart")):
        return "ProductGroup"
    if any(word in text for word in ("near me", "hours", "location", "appointment")):
        return "LocalBusiness"
    if any(word in text for word in ("blog", "guide", "article")):
        return "BlogPosting"
    return "WebSite"


def get_template(schema_type: str, compact: bool = False) -> dict[str, Any]:
    templates = load_templates()
    if schema_type not in templates:
        available = ", ".join(sorted(templates))
        raise SystemExit(f"Unknown template type '{schema_type}'. Available: {available}")
    template = deepcopy(templates[schema_type]["template"])
    if compact:
        return template
    return {
        "type": schema_type,
        "description": templates[schema_type].get("description"),
        "json_ld": template,
    }


def main() -> None:
    parser = argparse.ArgumentParser(description="Generate a JSON-LD template from bundled schema templates")
    parser.add_argument("--type", dest="schema_type", help="Schema type to generate")
    parser.add_argument("--detect-from", help="URL or HTML file to infer a page/schema type")
    parser.add_argument("--list", action="store_true", help="List available template types")
    parser.add_argument("--compact", action="store_true", help="Print only the JSON-LD object")
    parser.add_argument("--timeout", type=int, default=15)
    parser.add_argument("--json", "-j", action="store_true", help="Output JSON instead of a script tag")
    args = parser.parse_args()

    templates = load_templates()
    if args.list:
        result = {"templates": [{"type": key, "description": value.get("description")} for key, value in sorted(templates.items())]}
        print_json_or_text(result, args.json, [item["type"] for item in result["templates"]])
        return
    schema_type = args.schema_type or (detect_template_type(args.detect_from, args.timeout) if args.detect_from else None)
    if not schema_type:
        raise SystemExit("Provide --type, --detect-from, or --list.")
    result = get_template(schema_type, compact=args.compact)
    payload = result if args.compact else result["json_ld"]
    if args.json:
        print(json.dumps(result, indent=2))
    else:
        print('<script type="application/ld+json">')
        print(json.dumps(payload, indent=2))
        print("</script>")


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