Skip to content

balsm-health/website / .claude/skills/seo

Comprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability, indexability, Core Web Vitals with INP), schema markup, content quality (E-E-A-T), image optimization, sitemap analysis, and GEO for AI Overviews/ChatGPT/Perplexity. Industry detection for SaaS, e-commerce, local, publishers, agencies. Triggers on: SEO, audit, schema, Core Web Vitals, sitemap, E-E-A-T, AI Overviews, GEO, technical SEO, content quality, page speed.

FileKindSize
LICENSE.txtmarkdown143 B
SKILL.mdskill md16.9 KB
bin/claude-seoexecutablescript1.5 KB
extensions/banana/references/cost-tracking.mdmarkdown1.2 KB
extensions/banana/references/gemini-models.mdmarkdown5.8 KB
extensions/banana/references/mcp-tools.mdmarkdown3.7 KB
extensions/banana/references/post-processing.mdmarkdown5.1 KB
extensions/banana/references/presets.mdmarkdown2.2 KB
extensions/banana/references/prompt-engineering.mdmarkdown20.9 KB
extensions/banana/references/seo-image-presets.mdmarkdown4.0 KB
extensions/banana/scripts/batch.pyexecutablescript3.3 KB
extensions/banana/scripts/cost_tracker.pyexecutablescript7.2 KB
extensions/banana/scripts/edit.pyexecutablescript5.6 KB
extensions/banana/scripts/generate.pyexecutablescript6.4 KB
extensions/banana/scripts/presets.pyexecutablescript4.9 KB
extensions/banana/scripts/setup_mcp.pyexecutablescript4.5 KB
extensions/banana/scripts/validate_setup.pyexecutablescript3.8 KB
hooks/hooks.jsonconfig416 B
hooks/run-python-hook.jsscript1.7 KB
hooks/validate-schema.pyexecutablescript5.9 KB
pdf/google-seo-reference.mdmarkdown8.0 KB
references/backlink-quality.mdmarkdown3.4 KB
references/cwv-thresholds.mdmarkdown6.9 KB
references/eeat-framework.mdmarkdown8.1 KB
references/free-backlink-sources.mdmarkdown5.6 KB
references/local-schema-types.mdmarkdown9.2 KB
references/local-seo-signals.mdmarkdown9.6 KB
references/maps-api-endpoints.mdmarkdown5.9 KB
references/maps-free-apis.mdmarkdown6.0 KB
references/maps-gbp-checklist.mdmarkdown5.9 KB
references/maps-geo-grid.mdmarkdown4.3 KB
references/quality-gates.mdmarkdown5.1 KB
references/schema-types.mdmarkdown7.8 KB
references/thinking-framework.mdmarkdown9.3 KB
requirements.txtmanifest1.5 KB
runtime-plugin.jsonconfig1.5 KB
schema/templates.jsonconfig9.4 KB
scripts/agent_ux_check.pyscript8.2 KB
scripts/analyze_visual.pyexecutablescript7.2 KB
scripts/backlinks_auth.pyscript16.1 KB
scripts/bing_webmaster.pyscript21.8 KB
scripts/capture_screenshot.pyexecutablescript6.4 KB
scripts/commoncrawl_graph.pyscript15.6 KB
scripts/consistency_check.pyscript12.5 KB
scripts/content_humanize.pyscript7.2 KB
scripts/content_quality.pyscript9.7 KB
scripts/content_verify.pyscript7.1 KB
scripts/crux_history.pyscript10.7 KB
scripts/dataforseo_costs.pyscript15.8 KB
scripts/dataforseo_merchant.pyexecutablescript16.7 KB
scripts/dataforseo_normalize.pyexecutablescript14.7 KB
scripts/domain_history.pyscript9.6 KB
scripts/drift_baseline.pyscript13.5 KB
scripts/drift_compare.pyscript22.3 KB
scripts/drift_history.pyscript3.4 KB
scripts/drift_report.pyscript11.0 KB
scripts/fetch_page.pyexecutablescript9.4 KB
scripts/ga4_report.pyscript16.8 KB
scripts/gbp_deprecation_lint.pyexecutablescript4.7 KB
scripts/google_auth.pyscript31.0 KB
scripts/google_report.pyscript97.6 KB
scripts/gsc_inspect.pyscript11.0 KB
scripts/gsc_query.pyscript18.6 KB
scripts/indexing_notify.pyscript10.3 KB
scripts/indexnow_submit.pyscript8.8 KB
scripts/iptc_ai_label.pyscript7.6 KB
scripts/keyword_planner.pyscript10.8 KB
scripts/lcp_subparts.pyscript7.2 KB
scripts/moz_api.pyscript14.7 KB
scripts/nlp_analyze.pyscript12.1 KB
scripts/pagespeed_check.pyscript22.9 KB
scripts/parasite_risk.pyexecutablescript8.6 KB
scripts/parse_html.pyexecutablescript8.8 KB
scripts/portability_check.pyscript7.8 KB
scripts/preload_check.pyscript8.1 KB
scripts/release_sign.pyscript5.6 KB
scripts/render_page.pyscript20.9 KB
scripts/runtime.pyexecutablescript15.1 KB
scripts/schema_ecommerce_validate.pyscript11.8 KB
scripts/schema_generate.pyscript12.0 KB
scripts/seo_updates.pyscript4.8 KB
scripts/sitemap_discovery.pyscript10.0 KB
scripts/sync_flow.pyscript11.9 KB
scripts/ucp_check.pyscript8.4 KB
scripts/unlighthouse_run.pyscript5.6 KB
scripts/url_safety.pyscript22.0 KB
scripts/validate_backlink_report.pyscript11.7 KB
scripts/verify_backlinks.pyscript12.9 KB
scripts/verify_release.pyscript4.8 KB
scripts/youtube_search.pyscript12.3 KB

scripts/release_sign.py

View on GitHub
#!/usr/bin/env python3
"""
Generate a SHA-256 manifest of every git-tracked file in the repository.

The manifest is published alongside each release tag (attached to the
GitHub release artifacts) so users — and the install scripts — can
verify the contents of a checkout against the maintainer's signed
record.

Usage
=====

Generate a manifest for the current working tree::

    python scripts/release_sign.py > release-manifest.json

Compare two manifests to find drift between releases::

    python scripts/release_sign.py --compare old.json new.json

Threat model
============
This manifest defends against tag rewrites and partial supply-chain
tampering where an attacker can modify some repository files but not
the published manifest. It does NOT defend against a fully compromised
release (manifest + files both replaced by an attacker who controls
the GitHub repo). For that level of trust the maintainer signs the
manifest with a GPG key whose fingerprint is published out of band
(SECURITY.md, the maintainer's site, etc.).

Output schema
=============
::

    {
      "version": "v2.0.0",                      # plugin.json version
      "tag":     "v2.0.0",                      # git tag or "(uncommitted)"
      "commit":  "abc123…",                     # git HEAD
      "generated_at": "2026-05-17T14:32:00Z",
      "files": {
        "scripts/url_safety.py": "<sha256 hex>",
        …
      },
      "tree_sha256": "<sha256 hex of the sorted manifest itself>"
    }

The ``tree_sha256`` field lets a single hash be quoted in a release
note or signed with GPG without needing to attach the whole JSON.
"""

from __future__ import annotations

import argparse
import hashlib
import json
import os
import subprocess
import sys
from datetime import datetime, timezone
from pathlib import Path
from typing import Iterable


REPO_ROOT = Path(__file__).resolve().parents[1]


def _git(*args: str) -> str:
    """Run ``git`` from the repo root and return stripped stdout."""
    result = subprocess.run(
        ["git", "-C", str(REPO_ROOT), *args],
        check=True,
        capture_output=True,
        text=True,
        encoding="utf-8",
        errors="replace",
    )
    return result.stdout.strip()


def _git_or_none(*args: str) -> str | None:
    try:
        return _git(*args)
    except subprocess.CalledProcessError:
        return None


def _tracked_files() -> list[str]:
    """Return every file tracked by git (sorted, repo-relative)."""
    out = _git("ls-files")
    return sorted(line for line in out.splitlines() if line)


def _sha256(path: Path) -> str:
    h = hashlib.sha256()
    with path.open("rb") as fh:
        for chunk in iter(lambda: fh.read(65536), b""):
            h.update(chunk)
    return h.hexdigest()


def _read_plugin_version() -> str:
    manifest = REPO_ROOT / ".claude-plugin" / "plugin.json"
    try:
        with manifest.open() as fh:
            return json.load(fh).get("version", "unknown")
    except (OSError, json.JSONDecodeError):
        return "unknown"


def build_manifest(files: Iterable[str] | None = None) -> dict:
    """Build the SHA-256 manifest for the current working tree."""
    if files is None:
        files = _tracked_files()

    hashes: dict[str, str] = {}
    for rel in files:
        abs_path = REPO_ROOT / rel
        if not abs_path.is_file():
            # Submodule entries and broken symlinks fall through git
            # ls-files; skip them but record the absence.
            continue
        hashes[rel] = _sha256(abs_path)

    # Compute a hash-of-hashes so a single value identifies the whole
    # manifest. Deterministic ordering: sorted file paths, one
    # ``<sha>  <path>\n`` line each (matching sha256sum's wire format).
    tree_input = "".join(f"{sha}  {path}\n" for path, sha in sorted(hashes.items()))
    tree_sha = hashlib.sha256(tree_input.encode("utf-8")).hexdigest()

    return {
        "version": _read_plugin_version(),
        "tag": _git_or_none("describe", "--tags", "--exact-match") or "(uncommitted)",
        "commit": _git_or_none("rev-parse", "HEAD") or "(uncommitted)",
        "generated_at": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
        "files": hashes,
        "tree_sha256": tree_sha,
    }


def compare(old: dict, new: dict) -> dict:
    """Diff two manifests; return added / removed / changed files."""
    old_files = old.get("files", {})
    new_files = new.get("files", {})
    return {
        "added": sorted(set(new_files) - set(old_files)),
        "removed": sorted(set(old_files) - set(new_files)),
        "changed": sorted(
            p for p in set(new_files) & set(old_files) if old_files[p] != new_files[p]
        ),
        "tree_sha256_old": old.get("tree_sha256"),
        "tree_sha256_new": new.get("tree_sha256"),
    }


def main() -> int:
    parser = argparse.ArgumentParser(
        description="Generate or compare claude-seo release SHA-256 manifests."
    )
    parser.add_argument(
        "--compare",
        nargs=2,
        metavar=("OLD", "NEW"),
        help="Diff two manifests instead of generating a new one.",
    )
    parser.add_argument(
        "--indent",
        type=int,
        default=2,
        help="JSON indentation (default 2).",
    )
    args = parser.parse_args()

    if args.compare:
        with open(args.compare[0]) as fh:
            old = json.load(fh)
        with open(args.compare[1]) as fh:
            new = json.load(fh)
        json.dump(compare(old, new), sys.stdout, indent=args.indent)
        sys.stdout.write("\n")
        return 0

    manifest = build_manifest()
    json.dump(manifest, sys.stdout, indent=args.indent)
    sys.stdout.write("\n")
    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: 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