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_topic_suggester.py

View on GitHub
#!/usr/bin/env python3
"""Suggest GitHub topics from repository metadata, README, and competitors."""

from __future__ import annotations

import argparse
import os
import re
from collections import Counter

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


STOP_WORDS = {
    "the", "and", "for", "with", "from", "into", "this", "that", "your", "you", "are", "was", "were",
    "will", "would", "should", "could", "about", "using", "use", "used", "all", "any", "not", "can",
    "how", "why", "what", "when", "where", "which", "than", "then", "them", "they", "our", "their",
}

CANONICAL_TOPICS = {
    "search-engine-optimization": ["seo", "search engine optimization"],
    "technical-seo": ["technical seo", "crawlability", "indexability"],
    "github-seo": ["github seo", "repository seo", "repo seo"],
    "llm": ["llm", "large language model"],
    "generative-ai": ["generative ai", "ai search"],
    "python": ["python"],
    "cli": ["cli", "command line"],
    "automation": ["automation", "workflow"],
    "audit": ["audit", "auditing"],
    "schema-org": ["schema", "json-ld", "structured data"],
}


def _local_text(path: str) -> str:
    parts = []
    for rel in ("README.md", "pyproject.toml", "package.json"):
        fpath = os.path.join(path, rel)
        if os.path.exists(fpath):
            parts.append(open(fpath, "r", encoding="utf-8", errors="replace").read())
    return "\n".join(parts)


def _topicify(token: str) -> str:
    return re.sub(r"[^a-z0-9-]+", "-", token.lower()).strip("-")[:50]


def suggest_topics(repo: str | None = None, path: str = ".", token: str = "", provider: str = "auto", competitors: list[str] | None = None, intent_terms: list[str] | None = None, limit: int = 20) -> dict:
    competitors = competitors or []
    intent_terms = intent_terms or []
    ctx = auth_context(token=token)
    limitations = []
    resolved_repo = ""
    metadata = {}
    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}")

    current_topics = set(metadata.get("topics") or [])
    text = "\n".join([metadata.get("name") or "", metadata.get("description") or "", _local_text(path), " ".join(intent_terms)])
    lower = text.lower()
    candidates = Counter()
    evidence = {}

    for topic, phrases in CANONICAL_TOPICS.items():
        matched = [phrase for phrase in phrases if phrase in lower]
        if matched:
            score = 0
            for phrase in matched:
                phrase_hits = lower.count(phrase)
                phrase_words = len(phrase.split())
                score += phrase_hits * (20 + max(0, phrase_words - 1) * 12)
            candidates[topic] += score
            evidence.setdefault(topic, []).extend(matched)

    words = re.findall(r"[a-z][a-z0-9-]{2,}", lower)
    for word in words:
        if word in STOP_WORDS or len(word) > 35:
            continue
        candidates[_topicify(word)] += 1

    competitor_topics = Counter()
    for competitor in competitors:
        try:
            slug = resolve_repo(competitor)
            payload = fetch_json(f"/repos/{slug}", token=token, provider=provider)
            for topic in payload.get("data", {}).get("topics") or []:
                competitor_topics[topic] += 1
        except Exception as exc:
            limitations.append(f"Competitor topics unavailable for {competitor}: {exc}")
    for topic, count in competitor_topics.items():
        candidates[topic] += count * 5
        evidence.setdefault(topic, []).append("competitor topic")

    suggestions = []
    for topic, score in candidates.most_common():
        if topic in current_topics or topic in STOP_WORDS or len(topic) < 3:
            continue
        suggestions.append({"topic": topic, "score": score, "evidence": sorted(set(evidence.get(topic, [])))})
        if len(suggestions) >= limit:
            break

    issues = []
    if len(current_topics) < 3:
        issues.append({"severity": "warning", "type": "few_current_topics", "message": "Repository has fewer than three current topics"})
    if not suggestions:
        issues.append({"severity": "info", "type": "no_suggestions", "message": "No new topic suggestions were produced from available evidence"})

    return {
        "repo": resolved_repo or repo or "",
        "auth_context": ctx,
        "summary": {"current_topic_count": len(current_topics), "suggestions": len(suggestions), "competitors_used": len(competitors)},
        "current_topics": sorted(current_topics),
        "suggested_topics": suggestions,
        "competitor_topics": dict(competitor_topics.most_common()),
        "issues": issues,
        "limitations": limitations,
    }


def main() -> None:
    parser = argparse.ArgumentParser(description="Suggest GitHub topics from repo metadata and search-intent terms")
    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("--token", help="GitHub token override")
    parser.add_argument("--provider", choices=["auto", "api", "gh"], default="auto")
    parser.add_argument("--competitor", action="append", default=[], help="Competitor owner/repo; can be repeated")
    parser.add_argument("--intent-term", action="append", default=[], help="Search-intent phrase; can be repeated")
    parser.add_argument("--limit", type=int, default=20)
    parser.add_argument("--json", "-j", action="store_true", help="Output JSON")
    args = parser.parse_args()

    result = suggest_topics(args.repo, path=args.path, token=get_token(args.token), provider=args.provider, competitors=args.competitor, intent_terms=args.intent_term, limit=args.limit)
    lines = [
        f"Topic suggestions for {result['repo'] or args.path}",
        f"Current topics: {result['summary']['current_topic_count']}  Suggestions: {result['summary']['suggestions']}",
    ]
    lines.extend(f"- {row['topic']} (score {row['score']})" for row in result["suggested_topics"][:15])
    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: 472kUpdated 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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated 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